Annotation of OpenXM_contrib/gnuplot/0INSTALL, Revision 1.1.1.3
1.1 maekawa 1: Installation
2: ************
3:
4: This document is divided into four parts: the first part (For the
5: impatient) provides a quick overview of configuration and compilation
6: instructions. It also lists those options to the configure shell script
7: which are unique to gnuplot. Part two describes the environment variables
8: used by gnuplot. Part three explains in detail how --with-PACKAGE=PATH
9: works, and how this option interacts with --libdir and --includedir.
10: Part four addresses some platform specific problems and testing issues.
11: There are also some hints how to build gnuplot with pre-ANSI C compilers.
12: Part five finally describes a few graphical front ends for gnuplot.
13:
14: The description of preprocessor options previously found here has been
15: moved to a new file called 0PORTING. Generic installation instructions
16: for `configure', such as distributed with FSF/GNU packages, have been
17: moved to the file INSTALL.gnu.
18:
19: For the impatient
20: =================
21:
22: First, tune term.h to choose which terminal drivers you wish to enable.
23: If you want to support gif output, you need to download, compile and
24: install the gd library : see term/gif.trm for details.
25:
26: If you want to support png output (free gif alternative), you need
27: png and z libraries : see term/png.trm for details. Note that the
28: png library will probably not compile without an ANSI/ISO C compiler.
29:
1.1.1.3 ! ohara 30: There's a special section in term.h to be used by 16bit DOS or Windows
! 31: builds of gnuplot. This preselection is necessary because it's quite
! 32: hard to squeeze a sufficient set of drivers through the many 64K
! 33: barriers imposed by 16bit environments. For any driver you add
! 34: in this selection, you'll quite probably have to remove some other one.
! 35:
1.1 maekawa 36: A complete overview of configure options is below in the Basic
37: Installation section. On platforms which do not support GNU
38: autoconf/configure, ie. most non-Unix platforms, look for a makefile
39: that looks suitable, (makefile.emx for emx on dos, makefile.nt for
40: MS VC++ 4.x on NT and probably win95, makefile.win for borland c on
41: win95/nt, makefile.wc for DOS Watcom C etc.)
42:
43: File location defaults
44: ----------------------
45:
46: PREFIX /usr/local
47: gnuplot PREFIX/bin
48: gnuplot_x11 PREFIX/bin
49: gnuplot.1 PREFIX/man/man1
50: gnuplot.gih PREFIX/share
51:
52: The only files where the runtime location is defined at compile time are
53: gnuplot.gih and show.c. This is important if gnuplot is not installed by running
54: 'make install'.
55:
56: The default path for the help library, gnuplot.gih, can be controlled in
57: several different ways:
58:
59: o with configure's --prefix= option, eg.
60: ./configure --prefix=/gnuplot
1.1.1.2 maekawa 61: gnuplot will look for the online help file, gnuplot.gih, in /gnuplot/share.
62: Attention: This option affects the location of *all* installed files!
1.1 maekawa 63:
64: o with configure's --datadir= option, eg.
65: ./configure --datadir='/gnuplot/docs'
1.1.1.2 maekawa 66: gnuplot will look for the online help file, gnuplot.gih, in /gnuplot/docs.
1.1 maekawa 67:
68: o at make time, eg.
69: make HELPFILE='/gnuplot/docs/gnuplot.gih'
1.1.1.2 maekawa 70: gnuplot will look for the online help file /gnuplot/docs/gnupot.gih.
1.1 maekawa 71:
72: o at execution time by specifying the helpfile with the environment
73: variable GNUHELP (see "Environment Variables" below).
74:
75: The default location of the executables can be controlled in different
76: ways:
77:
78: o with configure's --prefix= option, eg.
79: ./configure --prefix=/gnuplot
1.1.1.2 maekawa 80: gnuplot will be installed as /gnuplot/bin/gnuplot.
1.1 maekawa 81: Attention: This affects the location of *all* installed files!
82:
83: o with configure's --bindir= option, eg.
84: ./configure --bindir='/gnuplot/bin'
1.1.1.2 maekawa 85: gnuplot will be installed as /gnuplot/bin/gnuplot.
1.1 maekawa 86:
87: o at make time, eg.
1.1.1.2 maekawa 88: make BINDIR='/gnuplot/bin'
89: gnuplot will be installed as /gnuplot/bin/gnuplot.
1.1 maekawa 90:
91: If the executables are not installed in the default location, files
92: written by the `save' command cannot be used as scripts on Un*x platforms.
93: There is no way to specify the location of the executables during
94: runtime. Other platforms are not affected by this.
95:
96: The gnuplot demo files are not installed by default. If desired, they
97: should be copied manually to a location of choice.
98:
99: Unix, configure
100: ---------------
101:
102: On Unix, use
103: $ ./configure
104: $ make
105: [ Optionally run demos--see "How to test gnuplot" below. ]
106: $ make install
107:
108: If gcc is installed, it is used by default. A different compiler can be
109: used through the CC environment variable:
110:
111: (Bourne shell)
112: $ CC=c89 ./configure
113:
114: (C shell)
1.1.1.3 ! ohara 115: $ env CC=c89 ./configure
1.1 maekawa 116:
117: Any environment settings for CFLAGS are included into the Makefile,
118: so please make sure that these are really needed.
119:
120: There are several options available for configure that you may want
121: to change. A complete list of options is available through
122:
123: $ ./configure --help
124:
1.1.1.3 ! ohara 125: The options relevant to gnuplot are listed below:
! 126:
1.1 maekawa 127: --prefix=PREFIX Install architecture-independent files in PREFIX
128: [/usr/local]. The gnuplot (and gnuplot_x11) binary
129: is installed in PREFIX/bin.
130: --bindir=DIR user executables in DIR [PREFIX/bin]
131: --datadir=DIR Read-only architecture-independent data in DIR
132: [PREFIX/share]. The gnuplot help file is installed
133: in this directory.
134: --libdir=DIR object code libraries in DIR [EPREFIX/lib]
135: --includedir=DIR C header files in DIR [PREFIX/include]
136: --mandir=DIR Man documentation in DIR [PREFIX/man]
1.1.1.3 ! ohara 137: --with-x (*) use the X Window System
! 138: --with-lasergnu install lasergnu printer script
! 139: --with-linux-vga use the Linux SVGA console driver
! 140: (requires /usr/lib/libvga)
! 141: --with-readline (*) use the builtin minimal readline function (default)
1.1.1.2 maekawa 142: --without-readline do not use the builtin readline function
143: --with-readline=gnu use the GNU readline library
1.1.1.3 ! ohara 144: --with-readline[=PATH] Specify the location of GNU readline
! 145: --with-gd[=PATH] enable gif terminal with Tom Boutell's gd library
1.1 maekawa 146: (requires GD library)
1.1.1.3 ! ohara 147: --with-plot[=PATH] use the Unix plot library
! 148: --with-png[=PATH] (*) enable png terminal
1.1 maekawa 149: (requires libpng and libz)
1.1.1.3 ! ohara 150: --with-pdf[=PATH] enable pdf terminal
! 151: (requires PDFLib)
1.1.1.2 maekawa 152: --with-cwdrc check current directory for .gnuplot file,
153: normally disabled for security reasons
1.1.1.3 ! ohara 154: --enable-ggi enable ggi driver (EXPERIMENTAL)
1.1 maekawa 155: --enable-iris enable IRIS terminal (IRIS4D only)
1.1.1.3 ! ohara 156: --enable-mgr enable MGR terminal
! 157: --enable-rgip enable Redwood Graphics Interface Protocol
! 158:
! 159: Options marked with (*) are enabled by default, ie. these features or
! 160: packages are used if configure detects them even if the corresponding
! 161: option is not specified. Please note that the `--with-PACKAGE' options
! 162: can have additional arguments:
1.1 maekawa 163:
164: o `--with-PACKAGE' is equivalent to `--with-PACKAGE=yes'
1.1.1.3 ! ohara 165: o `--with-PACKAGE=no' disables checking for PACKAGE. It has the same
1.1 maekawa 166: effect as `--without-PACKAGE'.
1.1.1.3 ! ohara 167: o `--with-PACKAGE=PATH' checks for PACKAGE in PATH
1.1 maekawa 168:
169: Unix, no configure
170: ------------------
171:
172: The older, no-longer-preferred, way is to copy makefile.unx to Makefile
173: cp makefile.unx Makefile
174: Look through the Makefile to see if you need to make any changes.
175: See especially the HELPDEST and TERMFLAGS variables. Edit if needed.
176: Alternatively, all these variables may be set as command line arguments to
177: 'make'. For example:
178:
179: make <MACHINE> HELPDEST='/usr/um/misc/lib' \
180: DEST='/usr/um/misc/bin' READLINE=
181:
182: Type
183: make
184: For further instructions.
185: If that works, try
186: make install
187: For further instructions.
188:
189: VMS
190: ---
191:
1.1.1.3 ! ohara 192: John Hasstedt <John.Hasstedt@sunysb.edu> has written configure.vms,
! 193: a command file that creates the necessary make and option files to build
! 194: gnuplot. See the file for instructions on using it. If you have problems
! 195: with it, the old build files are still included; instructions for using
! 196: them follow.
! 197:
1.1.1.2 maekawa 198: On VMS, you can use MMS, MMK, or another make utility, or you can
199: use BUILDVMS.COM. The supplied files work with Alpha/VMS V6.2 and
200: DECC V5.7; you may get warnings or more serious errors depending on
201: the versions of the C compiler, the C run-time libraries, and VMS on
202: your system.
203:
204: To compile using MMK:
205: MMK/DESCRIPTION=MAKEFILE.VMS
206: To compile using MMS on VAX:
207: MMS/DESCRIPTION=MAKEFILE.VMS
208: To compile using MMS on Alpha:
209: MMS/DESCRIPTION=MAKEFILE.VMS/MACRO=__ALPHA__=1
210:
211: Alternatively, you can use MAKE_VMS.COM. This command file will run
212: MMK or MMS to build gnuplot. If you don't have either one installed, it
213: will use the command file. The first parameter on the command line is
214: the compiler you want to use (default DECC).
215:
216: It may sometimes be useful to add `/IGNORE=WARNING' to the `MMS' call.
217:
218: To compile using GNUC or VAXC:
219: add /MACRO=GNUC or /MACRO=VAXC to the above command
220: To compile with another make utility:
221: check the documentation of your utility to specify the description
222: file and any necessary macros (__ALPHA__, GNUC, or VAXC)
1.1 maekawa 223: Or if you don't have a suitable make:
1.1.1.2 maekawa 224: @BUILDVMS
1.1 maekawa 225: To tell gnuplot where to find the help library:
1.1.1.2 maekawa 226: $ define gnuplot$help disk:[directory]gnuplot.hlb
227: Alternatively, put the help in the main system help library.
1.1 maekawa 228:
229: AmigaOS
230: -------
231:
232: Using Aztec C 5.2a
233: make -f makefile.ami
234: Using SAS/C 6.1 or later versions
235: smake -f makefile.amg
1.1.1.2 maekawa 236: You can also copy makefile.amg to smakefile and just type `smake'.
237:
238: At the beginning of makefile.amg you will find a configuration
239: section where you have to adjust all settings which control the build
240: process. Most important is probably to select the terminal devices
241: which should be supported. You can create a version offering
242: png graphics as well as gif support. Use the appropriate settings
243: for CPU and MATH to compile for a specific machine type.
244: Be sure to enable only those devices for which you have the
245: necessary software already installed. Also ensure that the
246: libraries and the sources are all compiled using the same
247: settings for CPU and MATH.
1.1 maekawa 248: Using gcc: see Unix
249:
250: Atari/TOS
251: ---------
252:
253: Using gcc 2.x as unix cross- or native compiler
254: make -f makefile.st
255: (Edit top of makefile.st for name of crosscompiler or choose native setting)
256: Using PureC
257: use gnuplot.prj
258: Using TurboC
259: use gnuplot.prj
260: (Edit gnuplot.prj according to notes at the beginning)
261:
262: MS-Windows
263: ----------
264:
1.1.1.3 ! ohara 265: Common for all Windows builds: The program doesn't need to be installed
! 266: specially. Just copy all the relevant files mentioned a single directory,
! 267: and you're done. You'll probably want to generate a desktop icon
! 268: (program manager group/icon, desktop shortcut, or Start->Programs menu
! 269: entry) for wgnuplot.exe or wgnupl32.exe, and optionally register
! 270: wgnuplot/wgnupl32 as the program to open plot script file with.
! 271: Suggested filename extensions would be *.plt or *.gpl.
! 272:
! 273: Using Microsoft C 7.0 and compiling for 16bit MS-Windows (3.x, WfW)
1.1 maekawa 274: copy makefile.msw makefile
275: nmake
276: Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu
1.1.1.3 ! ohara 277: in some directory.
1.1 maekawa 278:
1.1.1.3 ! ohara 279: Using Borland C++ 3.1 and compiling for 16bit MS-Windows (3.x, WfW)
1.1 maekawa 280: copy makefile.win makefile
1.1.1.3 ! ohara 281: Edit makefile to change TC, and check other possible options to set.
! 282: You may want to edit the 16bit-only section of term.h to select a
! 283: different set of terminal drivers.
1.1 maekawa 284: make
285: Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu
1.1.1.3 ! ohara 286: in some directory.
1.1 maekawa 287:
1.1.1.3 ! ohara 288: Using Borland C++ 4.52, C++ Builder 1.0 or the "free" command line
! 289: version 5.5, compiling for 32bit MS-Windows (XP/2K/NT/95/98/ME)
! 290: copy makefile.win makefile
! 291: Edit makefile to change TC, LINK32, RUNTIME_LIB and other
! 292: configuration options as documented in the makefile itself.
! 293: make -DWIN32=1
! 294: Copy wgnupl32.exe, wgnuplot.hlp and wgnuplot.mnu to some directory.
! 295:
! 296: Using Visual C++ and compiling for 32bit Windows (XP/2K/NT/95/98/ME)
1.1.1.2 maekawa 297: nmake -f makefile.nt
298: or
299: copy makefile.nt makefile
300: nmake
301:
1.1.1.3 ! ohara 302: Using the MinGW32 port of GCC, plus the Microsoft Help Compiler (part
! 303: of the "Platform SDK", but also available individually):
1.1 maekawa 304: copy makefile.mgw makefile
305: Look through the Makefile to see if you need to make any changes.
306: make
1.1.1.3 ! ohara 307: Optionally check the target directory in the makefile and
1.1 maekawa 308: make install
309:
1.1.1.3 ! ohara 310: Using the Cygwin port of GCC, which includes MinGW32. Again, you need the
! 311: MS Help Compiler in addition to a reasonably complete Cygwin install.
1.1 maekawa 312: copy makefile.cyg makefile
313: Look through the Makefile to see if you need to make any changes.
314: make
1.1.1.3 ! ohara 315: Put wgnuplot.exe, wgnuplot.hlp and wgnuplot.mnu
! 316: in some directory.
! 317:
1.1 maekawa 318:
319: MSDOS
320: -----
321:
322: Using DJGPP
323: Basically the same as Unix+configure. Andris Pavenis <pavenis@lanet.lv>
324: has contributed a shell script which makes the whole process even easier:
325: just run djconfig.sh, and then make.
326: For novices, it is recommended to use makefile.dj2 instead:
327: copy makefile.dj2 makefile
1.1.1.3 ! ohara 328: Optionally check and adapt the makefile to turn on additional features.
1.1 maekawa 329: make
1.1.1.3 ! ohara 330: or even simpler
! 331: make -fmakefile.dj2
1.1 maekawa 332:
333: Using Microsoft C 7.0.
334: copy makefile.msc makefile
335: nmake
336:
1.1.1.3 ! ohara 337: Using Borland C++ 3.0 or 3.1
1.1 maekawa 338: copy makefile.tc makefile
339: Edit makefile to change TC, BIN, BGI, BGIOBJ. You may also want to turn
340: off overlays (See manual for more on overlays).
1.1.1.3 ! ohara 341: Optionally edit the 16-bit special selection of terminal drivers in
! 342: term.h if you need any driver that isn't part of the default collection.
1.1 maekawa 343: make
344:
1.1.1.3 ! ohara 345:
1.1 maekawa 346: The file gnuplot.gih is needed for help on the PC.
347: If the file gnuplot.gih is not in the default directory, then use:
348: set GNUHELP={full path name of gnuplot.gih}
349:
350: OS/2
351: ----
352:
353: To compile under OS/2 (2.x and above) you need the development
354: suite EMX 0.9 (including gcc). You should also have
355: GNU Make and IBM's IPFC (Information Presentation Facility Compiler,
356: available from the Developer's Toolkit; nowadays it's accessible
357: through an IBM website for free!).
358:
359: At the beginning of Makefile.os2 you will find a configuration
360: section where you have to adjust all settings which control the build
361: process. Most important is probably to select the terminal devices
362: which should be supported. You can create a version offering
363: PM graphics as well as X11 support (to use with XFree86).
364: Support for these two terminals is provided by additional
365: executables.
366: Be sure to enable only those devices for which you have the
367: necessary software already installed. Also ensure that the
368: libraries and the sources are all compiled (not) using
369: the '-Zmt' flags.
370:
371: Executing
372: make -f makefile.os2
373: should create a default build while
374: make -f makefile.os2 help
375: will show you all pre-defined targets.
376:
377: See other sections of the manuals for more information about
378: installing/using gnuplot on OS/2.
379:
380: Environment Variables
381: =====================
382:
383: See 'help environment'.
384:
385: If the environment variable GNUTERM is found, it is used as the terminal
386: type. Otherwise, in some cases the variable TERM will be used, or the
387: hardware may be automatically detected.
388:
389: The PC version looks for the environment variable GNUPLOT to contain
390: the name of the directory from which to load the initialization file
391: GNUPLOT.INI. See the help on 'start_up' for more information.
392:
393: HOME is examined as a directory where a .gnuplot startup file might be
394: found. See help on "start-up".
395:
396: If defined, the environment variable GNUHELP is used for the name
397: of the .gih help file, otherwise HELPFILE (defined in makefile or
398: command.c) is used.
399:
400: The VMS version looks for the logical name GNUPLOT$HELP to locate
401: the help library.
402:
403: The CGI drivers need the CGIPATH environment variable to set the path
404: to the CGI agents, and the CGIDISP and/or CGIPRNT environment variables
405: to set the output devices.
406:
1.1.1.2 maekawa 407: If creating dynamically linked executables for the X11 Window System, it
408: may be necessary to add flags to the LIBS variable in Makefile
409: to make sure gnuplot finds all required libraries at runtime. Systems like
410: SunOS and Solaris use -R to specify the runtime library search path, whereas
411: OSF/Dec Unix, Irix and Linux use -rpath. If this is not possible, the
412: LD_LIBRARY_PATH environment variable should be set.
1.1 maekawa 413:
414: About --with-PACKAGE[=PATH]
415: ***************************
416:
417: Every `--with-PACKAGE' option sets a `with_package' variable in
418: configure. Depending on how `--with-PACKAGE' was invoked, there are
419: only three different possible values for the `with_package' variable:
420:
421: Option $with_package
422: ----------------------------------------
1.1.1.3 ! ohara 423: (not specified) yes or no
1.1 maekawa 424: --with-package yes
425: --with-package=yes yes
426: --with-package=no no
427: --with-package=PATH PATH
428: --without-package no
429:
1.1.1.3 ! ohara 430: In gnuplot, the following --with-PACKAGE options are available:
1.1 maekawa 431:
1.1.1.3 ! ohara 432: --with-readline
1.1 maekawa 433:
1.1.1.3 ! ohara 434: Use gnuplot's builtin readline function. This is enabled by default.
! 435:
! 436: --without-readline
! 437:
! 438: (same as --with-readline=no) Do not use gnuplot's builtin readline function.
! 439:
! 440: --with-readline=gnu
! 441:
! 442: Use the GNU readline library instead of gnuplot's builtin readline.
! 443:
! 444: --with-readline[=PATH]
1.1 maekawa 445:
1.1.1.3 ! ohara 446: Use the GNU readline library instead of gnuplot's builtin readline.
! 447: This form is required if GNU readline is not installed in a default
! 448: location.
1.1 maekawa 449:
1.1.1.3 ! ohara 450: --with-gd[=PATH]
1.1 maekawa 451:
1.1.1.3 ! ohara 452: Dto. for Thomas Boutell's gd library. This option is off by default,
! 453: as the developers want to encourage users to use the png format instead
! 454: of gif.
! 455:
! 456: --with-png[=PATH]
! 457:
! 458: Dto. for the png library. This option is on by default.
! 459:
! 460: --with-pdf[=PATH]
! 461:
! 462: Dto. for the pdf library. This option off on by default.
! 463:
! 464: --with-plot[=PATH]
! 465:
! 466: If used without the PATH argument, this option selects the standard
! 467: UNIX plot library, if available. If used with the PATH argument,
! 468: configure looks for the plot library from GNU plotutils. Version 2.2
! 469: or better is required. The option is off by default.
1.1 maekawa 470:
471: Platform problems and testing
472: *****************************
473:
474: This section addresses trouble shooting and testing issues. Userland
475: questions are answered in the FAQ.
476:
1.1.1.3 ! ohara 477: Platform and compiler notes
! 478: ===========================
1.1 maekawa 479:
480: Generally, if you think that configure has made a mistake in detecting
481: platform features, there are two ways to switch these off.
482:
483: Example:
484: configure was for some reason unable to detect the memset() function, but
485: you are sure it is ok to use on your platform. Now you can either edit
486: config.cache and change
487:
488: ac_cv_func_memset=${ac_cv_func_memset='no'} to
489: ac_cv_func_memset=${ac_cv_func_memset='yes'}
490:
491: and rerun configure, or, edit config.h and change
492:
493: /* #undef HAVE_MEMSET */ to
494: #define HAVE_MEMSET 1
495:
496: Note that changing such defines at compile time, eg. via
497: 'make DEFS=-DHAVE_MEMSET' is wrong, because the DEFS variable in Makefile
498: may contain other defines (make DEFS='-DHAVE_CONFIG_H -DHAVE_MEMSET'
499: should work, though).
500:
1.1.1.3 ! ohara 501: - gcc -ansi
! 502: If you wish to compile with gcc -ansi (CC='gcc -ansi -pedantic'
! 503: ./configure), additional platform specific defines may be necessary
! 504: to include non-ANSI function prototypes. E.g. on Solaris, -D__EXTENSIONS__
! 505: is needed. Otherwise, non-declared functions not returning int will be
! 506: assumed to return int, with possibly dangerous consequences. Especially
! 507: scpecfun.c is vulnerable here.
! 508:
1.1 maekawa 509: - HP-UX 9.x
510: It is recommended to use gcc, although the native compiler cc may
511: work with warnings.
512:
1.1.1.3 ! ohara 513: - HP-UX 10.x and above
! 514: GCC has known problems on this platform if configured to use HP's
! 515: assembler. The telltale symptom are tic labels all ending up at
! 516: position 0.0. So either make sure you use a GCC configured to use
! 517: GNU as, or use HP's ANSI cc (the unbundled one).
1.1 maekawa 518:
519: - IRIX 6.x
520: If you want to use the png terminal, you must install your own
521: versions of libpng and zlib. The versions supplied with the OS
522: are too old. Note that you need be very careful to select the
523: correct compiler options/ABI's.
524:
525: - MS-DOS
526: If ports of common Unix utilities (bash, sed etc) are available,
527: gnuplot can be built with DJGPP. Install instructions are the same
528: as for Unix (with configure).
529:
530: - SunOS 4.x
531: An ANSI/ISO C compiler should be used to compile gnuplot. It is
532: recommended to install gcc. If this is not an option, the system
533: compiler cc can be made to work with Wietse Venema's unproto tool.
534: See entry below for instructions.
535:
536: As of 1998-11-18, gnuplot compiles again with the native compiler cc.
537:
538: - System V.2/Ultrix 4.x/M88 SysV.3
539: An ANSI/ISO C compiler should be used to compile gnuplot. It is
540: recommended to install gcc. If this is not an option, the system
541: compiler cc can be made to work with Wietse Venema's unproto tool.
542:
543: unproto is available from
544: ftp://ftp.win.tue.nl/pub/unix/unproto5.shar.Z
545: ftp://ftp.porcupine.org/pub/lang/unproto5.shar.Z
546:
547: After installing unproto, configure gnuplot with
548:
549: (Bourne shell syntax)
550:
1.1.1.3 ! ohara 551: $ cd gnuplot-3.7.3
1.1 maekawa 552: $ CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure <options>
553:
554: or (C shell syntax)
555:
1.1.1.3 ! ohara 556: $ cd gnuplot-3.7.3
! 557: $ env CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure <options>
1.1 maekawa 558:
559: The required compiler options shown here are for System V.2. For other
560: platforms, consult the unproto documentation. `/full/path/to/unproto/dir'
561: is the full path name of the directory where unproto is installed. It is
562: not necessary to "install" unproto, one can just create a subdirectory
563: in gnuplot's source directory and use it from there.
564:
565: How to test gnuplot
566: ===================
567:
568: No comprehensive test suite for gnuplot's features has been written
569: to date. However, the supplied demo files provide a good method of
570: testing commonly used features. All command line examples below assume
571: Unix Bourne shell syntax.
572:
573: The demo files can be run interactively by eg.
574:
575: $ cd gnuplot/demo
576: $ PATH=..:$PATH ../gnuplot simple.dem
577:
578: and gnuplot prompts the user to "Hit return to continue" to cycle
579: through all the plots. (The PATH= statement is only required if you are
580: using the X11 plotting device and the gnuplot_x11 binary has not been
581: installed yet.)
582:
583: To run the demos in a specified file without interaction, one
584: can use
585:
586: $ PATH=..:$PATH ../gnuplot simple.dem </dev/null
587:
588: To run all demos non-interactively, use
589:
590: $ PATH=..:$PATH ../gnuplot all.dem </dev/null
591:
592: To use a different plotting device than the default (usually X11
593: under Unix), use eg.
594:
595: $ GNUTERM=dumb ../gnuplot all.dem </dev/null
596:
597: To test the capabilities of the terminal you are using, there is
598: the 'test' command:
599:
600: $ gnuplot
601:
602: G N U P L O T
1.1.1.3 ! ohara 603: Unix version 3.7 patchlevel 2
! 604: last modified Sat Jan 19 15:23:37 GMT 2002
1.1 maekawa 605:
1.1.1.3 ! ohara 606: Copyright(C) 1986 - 1993, 1993, 1998 - 2002
1.1 maekawa 607: Thomas Williams, Colin Kelley and many others
608:
609: Send comments and requests for help to info-gnuplot@dartmouth.edu
610: Send bugs, suggestions and mods to bug-gnuplot@dartmouth.edu
611:
612: Terminal type set to 'x11'
613: gnuplot> test
614:
615: `test` creates a display of line and point styles and other useful things
616: appropriate for the terminal you are using.
617:
618: Front Ends for gnuplot
619: ======================
620:
621: o Xgfe by David Ishee <dmishee@jasper.he.net>, available from
622: http://von-mises.home.ml.org/xgfe/xgfe.html
1.1.1.3 ! ohara 623: To compile from source, you need Qt library from
! 624: http://www.troll.no/.
1.1 maekawa 625:
626: o Bruce Ravel <ravel@phys.washington.edu> has written a new version of
627: gnuplot-mode for GNU emacs and XEmacs. This version is based on
628: the gnuplot.el file by Gershon Elber which is included with this
629: distribution. The package is available from
1.1.1.3 ! ohara 630: http://feff.phys.washington.edu/~ravel/gnuplot/.
! 631: Future distributions of gnuplot will hopefully include Bruce's
! 632: version.
1.1 maekawa 633:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>