File: 0INSTALL

package info (click to toggle)
gnuplot 3.5beta6.340-5
  • links: PTS
  • area: main
  • in suites: hamm
  • size: 4,792 kB
  • ctags: 4,205
  • sloc: ansic: 41,878; asm: 539; makefile: 498; objc: 379; csh: 297; sh: 277; pascal: 194; perl: 138; lisp: 88
file content (348 lines) | stat: -rw-r--r-- 13,026 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
For the impatient...

first, tune term.h to choose which terminal drivers you wish to enable.
If you want to support gif output, you need to download, compile and
install the gd library : see term/gif.trm for details.
If you want to support png output (free gif alternative), you need
png and z libraries : see term/png.trm for details.

on unix, use
% ./configure
% make

There are several options available for configure that you may want to change:

--prefix=/top/level/dir Specifies where to install gnuplot.  Two binaries are
			installed in prefix/bin and the gnuplot help is
			installed in prefix/lib.
--with-gnu-readline	Use the gnu readline library.  If you don't use this,
			you won't have file name completion.
--with-gnu-readline=/path/to/libreadline.a
			Use this form if your libreadline is not installedn
			where your linker can find it.
--with-cwdrc		When gnuplot starts up, check the current directory
			for a .gnuplotrc file.  This is normally disabled
			for security reasons.  (However, the home directory
			is always checked for a .gnuplotrc file.)
Do "configure --help" for more details.

On VMS, use buildvms.com if your make utility does not like makefile.vms
or descrip.mms

On other machines, look for a makefile that looks suitable,
(makefile.emx for emx on dos, makefile.nt for MS VC++ 4.x on NT and
probably win95, makefile.win for borland c on win95/nt, etc)


The GNUPLOT source code and executables may be copied and/or modified
freely as long as the copyright messages are left intact.

See the History file for changes to GNUPLOT.

Compilation instructions are near the end of this file.

GNUPLOT has been tested on Sun3's and Sun4's (SunOS 4.0.3 and 4.1.1),
a VAX 6410 (VMS 5.2), uVAX 3100 (5.4, 5.5, 6.0, 6.1) and AXP 3400 (1.5, 6.2)
Commodore Amiga's (KS/WB 1.3 and 2.0, SAS/C 6.2
and Aztec C beta 5.2a), IBM PC XT's and AT's (MS-DOS 3.3/5.0 BC++
3.1/TC++ 1.0 MSC 7.0, os/2), IRIS 4D/70G and 4D/25G with MIPS C, NeXT with
gnu C 1.34, DECStation 5000/200PXG (ULTRIX V4.1), AT&T 3B1 (version
3.51m with cc and gcc 1.39), and Apollo's (DomainOS SR10.3 BSD4.3
with C compiler 68K Rev 6.7(316)).  The code is written with
portability in mind.  GNUPLOT has not been tested on Pyramid 90x.

There is a mailing list for gnuplot users. Note, however, that the
newsgroup 
	comp.graphics.apps.gnuplot 
is identical to the mailing list (they both carry the same set of messages).
We prefer that you read the messages through that newsgroup, to subscribing
to the mailing list. (If you can read that newsgroup, and are already on the
mailing list, please send a message to majordomo@dartmouth.edu, asking to be
removed from the mailing list.)

The address for mailing to list members is
	   info-gnuplot@dartmouth.edu
and for mailing administrative requests is 
	   majordomo@dartmouth.edu
The mailing list for bug reports is 
	   bug-gnuplot@dartmouth.edu
The list of those interested in beta-test versions is
	   info-gnuplot-beta@dartmouth.edu

There is a daily digest of info-gnuplot available : ask majordomo
to subscribe to info-gnuplot-digest

Please tell us the version and machine on which your bug occurred.

 Also, please use meaningful email subjects, and particularly avoid
using a subject of 'help' to info-gnuplot since majordomo bounces
these to the list owner as suspected admin requests.




                       PREPROCESSOR #DEFINES

These #defines should be checked before compilation. There
are many makefiles provided as templates. You probably need these
only if porting to a new machine

THIS LIST IS SOMEWHAT OUT OF DATE NOW - CHECK configure.in and config.hin

define      file            note
------      ----            --------
HAVE_LGAMMA Makefile        define if you've got lgamma(3)
HAVE_GAMMA  Makefile        define if you've got gamma(3)
NO_MEMCPY   Makefile        define if your memcpy() is called bcopy()
NO_MEMSET   Makefile        define if you have bzero() but not memset()
NOCOPY      Makefile        define if you've don't have a memcpy() by any name
bcopy()     plot.h          define if you've got a memcpy() by some OTHER name
                              (see example in plot.h)
PC          Makefile        define if compiling on a PClone
MSDOS       Makefile        define if compiling under MSDOS;
                              automatically defined by Microsoft C 5.10
DOS32       Makefile        define for a 32-bit DOS extender (djgpp/emx)
WIN32       Makefile        define for a 32-bit MS-Windows version
HELPFILE    Makefile        name including path of gnuplot.gih file.
VERYLARGE   plot.h          define to be largest coordinate number.
SHELL       plot.h          default shell to spawn if SHELL environment
                              variable not found at run-time
NOCWDRC     Makefile        define to inhibit check of ./.gnuplot
READLINE    Makefile        define if you want command-line editing
GNU_READLINE Makefile       define if you are linking with gnu readline

header file availability
------------------------
BSD_TYPES   sys/bsdtypes.h present
OLD_SELECT  sys/select.h absent
NO_STRING_H  string.h absent
NO_STDLIB_H  stdlib.h absent
NO_SYS_TYPES_H  sys/types.h absent
NO_LIMITS_H
HAVE_VALUES_H
NO_LOCALE_H
NO_ERRNO_H
HAVE_UNISTD_H

function availability
---------------------
HAVE_GETCWD  - getcwd() available
HAVE_GETWD   - getwd() available
NO_MEMCPY   - memcpy() not available
NO_MEMSET   - memset() not available
NO_STRCHR
HAVE_STRNCASECMP
HAVE_STRNICMP
NO_TEMPNAM

Valid TERMFLAGS defines.  These defines are used to include the
various plotting terminals, printers, and protocols that a given version
of gnuplot can access:



define      file            note
------      ----            --------
TERMFLAGS   Makefile        the set of terminals you want, from below
            or term.h

Out of date now - select terminals by uncommenting #include lines
in term.h

   AED         AED 512 and AED 767
   AIFM        Adobe Illustrator Format
   AMIGASCREEN Amiga custom screen
   APOLLO      Apollo Graphics Primitive Resource (resizable window)
   ATT6300     PC with AT&T 6300 graphics
   BITGRAPH    BBN BitGraph
   CGI         SCO CGI
   COREL       COREL! Draw Format
   CORONA      PC with Corona graphics 325
   DXY800A     Roland DXY800A plotter
   DUMB        Printer or glass dumb terminal
   DXF         AutoCad (Release 10.x) dxf file format
   EEPIC       EEPIC-extended LaTeX driver, for EEPIC users
   EGALIB      PC with EGA/VGA graphics.
   EMTEX       LaTeX picture environment with emTeX specials
   EPS180      Epson-LQ style 24-pin 180-dot per inch printers
   EPS60       Epson-style 60-dot per inch printers
   EPSONP      Epson LX-800, Star NL-10, NX-1000 and lots of others
   EXCL        Talaris EXCL laser printer format
   FIG         Fig graphics language (requires object.h from TransFig)
   GPR         Apollo Graphics Primitive Resource (fixed-size window)
   HERCULES    IBM PC/Clone with Hercules graphics board
   HP2648      HP2648, HP2647
   HP26        HP2623A and maybe others
   HP500C      HP Deskjet 500 C and maybe other Color Deskjets
   HP75        HP7580, and probably other HPs
   HPGL        HP7475 and (hopefully) lots of others
   HPLJII      HP Laserjet II
   HPPJ        HP PaintJet
   IMAGEN      Imagen laser printers (300dpi) (requires -Iterm also)
   IRIS4D      IRIS4D series computer
   KERMIT      MS-DOS Kermit Tektronix 4010 emulator
   LATEX       LaTeX picture environment
   MF          Metafont Format
   MIF         FrameMaker MIF 3.00 Format
   NEC         NEC CP6 pinwriter printer
   NEXT        NeXTStep Window System (only grey scale)
   OS2PM       OS/2 Presentation Manager
   PBM         PBMPLUS pbm, pgm, ppm formats
   PCL         HP PCL5 (actually  HPGL/2)
   POSTSCRIPT  PostScript
   PRESCRIBE   Kyocera Laser printer
   PSLATEX     Postscript graphics, LaTeX labels and titles
   PSTRICKS    PSTRICKS 0.91 format
   QMS         QMS/QUIC laserprinter (Talaris 1200 and others)
   REGIS       ReGis graphics (vt125, vt220, vt240, Gigis...)
   RGIP        Redwood Graphics Interface Protocol
   SELANAR     Selanar
   STARC       Star Color Printer
   SUN         Sun Microsystems Workstation
   T410X       Tektronix 4106, 4107, 4109 and 420x terminals
   TANDY60     Tandy DMP-130 series 60-dot per inch graphics
   TEK         Tektronix 4010, and probably others
   TEXDRAW     TeXDraw format (for LaTeX)
   TGIF        TGIF X11 Drawing Tool
   TPIC        Tpic specials for TeX
   UNIXPC      unixpc (ATT 3b1 or ATT 7300)
   UNIXPLOT    unixplot
   V384        Vectrix 384 and tandy color printer
   VTTEK       VT like Tektronix 4010 emulator
   X11         X11R4 window system


These #defines are defined automatically by various compilers, some
gnuplot routines check these defines to implement features found in the
various environments:

define        note
------        --------
AMIGA_AC_5    defined for Manx Aztec C 5.2a on the Amiga
AMIGA_SC_6_1  defined for SAS/C 6.1 or later versions on the Amiga
apollo        defined by Apollo's C compilers.
_CRAY         defined by CRAY's C compiler.
__TURBOC__    defined automatically by  Borland C++ 3.x
unix          defined by most unix C compilers.
vms           (and VMS) defined by VAX-11 C under VMS.
__ZTC__       Zortech C compiler under MSDOS.
_Windows      defined by Borland C++ 3.0 compiling for MS-Windows


                             TO COMPILE

under UNIX:
To compile do:

  ./configure
  make

  
  The older, no-longer-preferred, way is to copy makefile.unx to Makefile
      cp makefile.unx Makefile
  Look through the Makefile to see if you need to make any changes.
  See especially the HELPDEST and TERMFLAGS variables.  Edit if needed.
  Alternatively, all these variables may be set as command line arguments to
  'make'. For example:

        make <MACHINE> HELPDEST='/usr/um/misc/lib/gnuplot.gih' \
                DEST='/usr/um/misc/bin' READLINE=

  Edit term.h, to include/exclude terminals
  Type
      make
  For further instructions.
  If that works, try
      make install
  For further instructions.

under VMS:
  To compile using DEC MMS or PD clone (MMK ?),
     invoke MMS or MMK with the supplied descrip.mms
  Or if you have a unix-like make utility
     copy makefile.vms makefile.
     make
  Or if you don't have a suitable make:
     @buildvms
  To tell gnuplot where to find the help library:
      $ define gnuplot$help disk:[directory]gnuplot.hlb
  Alternatively (and preferably) put the help in the main system help library.

under AmigaDOS:
Using Aztec C 5.2a
      make -f makefile.ami
Using SAS/C 6.1 or later versions
      smake -f makefile.amg

under TOS (Atari):
Using gcc 2.x as unix cross- or native compiler
	make -f makefile.st
(Edit top of makefile.st for name of crosscompiler or choose native setting)
Using PureC
	use gnuplot.prj
Using TurboC
	use gnuplot.prj
(Edit gnuplot.prj according to notes at the beginning)

Using Microsoft C 7.0 and compiling for MS-Windows
      copy makefile.msw makefile
      nmake
  Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu
  in the windows directory.

under MSDOS:
Using Microsoft C 7.0.
      copy makefile.msc makefile
      nmake 

Using Borland C++ 3.1 and compiling for MS-Windows
      copy makefile.win makefile
  Edit makefile to change TC.
      make
  Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu
  in the windows directory.

Using Borland C++ 3.0
      copy makefile.tc makefile
  Edit makefile to change TC, BIN, BGI, BGIOBJ. You may also want to turn
  off overlays (See manual for more on overlays).
      make


The file gnuplot.gih is needed for help on the PC.
If the file gnuplot.gih is not in the default directory, then use:
    set GNUHELP={full path name of gnuplot.gih}


                         ENVIRONMENT VARIABLES

See 'help environment'.

If the environment variable GNUTERM is found, it is used as the terminal
type. Otherwise, in some cases the variable TERM will be used, or the
hardware may be automatically detected.

The PC version looks for the environment variable GNUPLOT to contain
the name of the directory from which to load the initialization file
GNUPLOT.INI.  See the help on 'start_up' for more information.

HOME is examined as a directory where a .gnuplot startup file might be
found. See help on "start-up".

If defined, the environment variable GNUHELP is used for the name
of the .gih help file, otherwise HELPFILE (defined in makefile or
plot.c) is used.

The VMS version looks for the logical name GNUPLOT$HELP to locate
the help library.

The CGI drivers need the CGIPATH environment variable to set the path
to the CGI agents, and the CGIDISP and/or CGIPRNT environment
variables to set the output devices.

The CGI drivers need the CGIPATH environment variable to set the path
to the CGI agents, and the CGIDISP and/or CGIPRNT environment
variables to set the output devices.

On solaris, if ld fails to run gnuplot_x11, you may need to
define LD_LIBRARY_PATH - see man ld for details.