=================================================================== RCS file: /home/cvs/OpenXM_contrib/gnuplot/Attic/0INSTALL,v retrieving revision 1.1.1.1 retrieving revision 1.1.1.3 diff -u -p -r1.1.1.1 -r1.1.1.3 --- OpenXM_contrib/gnuplot/Attic/0INSTALL 2000/01/09 17:00:48 1.1.1.1 +++ OpenXM_contrib/gnuplot/Attic/0INSTALL 2003/09/15 07:09:21 1.1.1.3 @@ -27,6 +27,12 @@ install the gd library : see term/gif.trm for details. png and z libraries : see term/png.trm for details. Note that the png library will probably not compile without an ANSI/ISO C compiler. + There's a special section in term.h to be used by 16bit DOS or Windows +builds of gnuplot. This preselection is necessary because it's quite +hard to squeeze a sufficient set of drivers through the many 64K +barriers imposed by 16bit environments. For any driver you add +in this selection, you'll quite probably have to remove some other one. + A complete overview of configure options is below in the Basic Installation section. On platforms which do not support GNU autoconf/configure, ie. most non-Unix platforms, look for a makefile @@ -52,13 +58,16 @@ several different ways: o with configure's --prefix= option, eg. ./configure --prefix=/gnuplot - Attention: This affects the location of *all* installed files! + gnuplot will look for the online help file, gnuplot.gih, in /gnuplot/share. + Attention: This option affects the location of *all* installed files! o with configure's --datadir= option, eg. ./configure --datadir='/gnuplot/docs' + gnuplot will look for the online help file, gnuplot.gih, in /gnuplot/docs. o at make time, eg. make HELPFILE='/gnuplot/docs/gnuplot.gih' + gnuplot will look for the online help file /gnuplot/docs/gnupot.gih. o at execution time by specifying the helpfile with the environment variable GNUHELP (see "Environment Variables" below). @@ -68,13 +77,16 @@ ways: o with configure's --prefix= option, eg. ./configure --prefix=/gnuplot + gnuplot will be installed as /gnuplot/bin/gnuplot. Attention: This affects the location of *all* installed files! o with configure's --bindir= option, eg. ./configure --bindir='/gnuplot/bin' + gnuplot will be installed as /gnuplot/bin/gnuplot. o at make time, eg. - make GNUPLOT_BINDIR='/gnuplot/bin' + make BINDIR='/gnuplot/bin' + gnuplot will be installed as /gnuplot/bin/gnuplot. If the executables are not installed in the default location, files written by the `save' command cannot be used as scripts on Un*x platforms. @@ -100,8 +112,7 @@ used through the CC environment variable: $ CC=c89 ./configure (C shell) -$ setenv CC c89 -$ ./configure +$ env CC=c89 ./configure Any environment settings for CFLAGS are included into the Makefile, so please make sure that these are really needed. @@ -111,6 +122,8 @@ to change. A complete list of options is available th $ ./configure --help + The options relevant to gnuplot are listed below: + --prefix=PREFIX Install architecture-independent files in PREFIX [/usr/local]. The gnuplot (and gnuplot_x11) binary is installed in PREFIX/bin. @@ -121,45 +134,37 @@ $ ./configure --help --libdir=DIR object code libraries in DIR [EPREFIX/lib] --includedir=DIR C header files in DIR [PREFIX/include] --mandir=DIR Man documentation in DIR [PREFIX/man] - --without-readline Do not use the included readline function - --with-gnu-readline Use the GNU readline version If you don't use this, - you won't have file name completion. - --with-gnu-readline=PATH Specify the location of libreadline. - Use this form if your libreadline is not installed - where your linker can find it. - --with-plot use the Unix plot library - --with-plot=PATH Specify the location of GNU libplot - --with-gd (*) Enable gif terminal with Tom Boutell's gd library + --with-x (*) use the X Window System + --with-lasergnu install lasergnu printer script + --with-linux-vga use the Linux SVGA console driver + (requires /usr/lib/libvga) + --with-readline (*) use the builtin minimal readline function (default) + --without-readline do not use the builtin readline function + --with-readline=gnu use the GNU readline library + --with-readline[=PATH] Specify the location of GNU readline + --with-gd[=PATH] enable gif terminal with Tom Boutell's gd library (requires GD library) - --with-gd=PATH Specify the location of libgd - --with-png (*) Enable png terminal + --with-plot[=PATH] use the Unix plot library + --with-png[=PATH] (*) enable png terminal (requires libpng and libz) - --with-png=PATH Specify the location of libpng - --with-cwdrc Check current directory for .gnuplotrc file, - normally disabled for security reasons. However, - the home directory is always checked for a - .gnuplotrc file. - --with-lasergnu Install lasergnu printer script - --without-linux-vga (*) Do not use the Linux console driver - (requires Linux SVGAlib /usr/lib/libvga) - --enable-apollo Apollo Graphics Primitive Resource - --enable-gpr Apollo Graphics Primitive Resource (fixed-size window) - --enable-cgi enable CGI terminal (SCO only) + --with-pdf[=PATH] enable pdf terminal + (requires PDFLib) + --with-cwdrc check current directory for .gnuplot file, + normally disabled for security reasons + --enable-ggi enable ggi driver (EXPERIMENTAL) --enable-iris enable IRIS terminal (IRIS4D only) - --enable-sun enable sunview terminal (Sun only) - --enable-unixpc enable unixpc terminal (ATT 3b1 or ATT 7300) - --enable-system-time use the system time routines in time.c - --with-x (*) Use the X Window System + --enable-mgr enable MGR terminal + --enable-rgip enable Redwood Graphics Interface Protocol - Options marked with (*) are on by default, ie. these features or packages -will be used if configure can detect them, even if the corresponding option -is not specified. Please note that the `--with-PACKAGE' options can have -additional arguments: + Options marked with (*) are enabled by default, ie. these features or +packages are used if configure detects them even if the corresponding +option is not specified. Please note that the `--with-PACKAGE' options +can have additional arguments: o `--with-PACKAGE' is equivalent to `--with-PACKAGE=yes' - o `--with-PACKAGE=no' will disable checking for PACKAGE. It has the same + o `--with-PACKAGE=no' disables checking for PACKAGE. It has the same effect as `--without-PACKAGE'. - o `--with-PACKAGE=PATH' will check for PACKAGE in PATH + o `--with-PACKAGE=PATH' checks for PACKAGE in PATH Unix, no configure ------------------ @@ -184,22 +189,42 @@ Unix, no configure VMS --- - On VMS, invoke MAKE_VMS.COM (or BUILDVMS.COM if you have MMS or MMK -but don't want to use the supplied DESCRIP.MMS). You may get warnings -or more serious errors depending on the versions of the C compiler, the -C run-time libraries, and {Open}VMS on your system. + John Hasstedt has written configure.vms, +a command file that creates the necessary make and option files to build +gnuplot. See the file for instructions on using it. If you have problems +with it, the old build files are still included; instructions for using +them follow. + On VMS, you can use MMS, MMK, or another make utility, or you can +use BUILDVMS.COM. The supplied files work with Alpha/VMS V6.2 and +DECC V5.7; you may get warnings or more serious errors depending on +the versions of the C compiler, the C run-time libraries, and VMS on +your system. - To compile using DEC MMS or MMK (PD clone), - invoke MMS or MMK with the supplied descrip.mms - Or if you have a unix-like make utility - copy makefile.vms makefile - make + To compile using MMK: + MMK/DESCRIPTION=MAKEFILE.VMS + To compile using MMS on VAX: + MMS/DESCRIPTION=MAKEFILE.VMS + To compile using MMS on Alpha: + MMS/DESCRIPTION=MAKEFILE.VMS/MACRO=__ALPHA__=1 + + Alternatively, you can use MAKE_VMS.COM. This command file will run +MMK or MMS to build gnuplot. If you don't have either one installed, it +will use the command file. The first parameter on the command line is +the compiler you want to use (default DECC). + + It may sometimes be useful to add `/IGNORE=WARNING' to the `MMS' call. + + To compile using GNUC or VAXC: + add /MACRO=GNUC or /MACRO=VAXC to the above command + To compile with another make utility: + check the documentation of your utility to specify the description + file and any necessary macros (__ALPHA__, GNUC, or VAXC) Or if you don't have a suitable make: - @buildvms + @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. + $ define gnuplot$help disk:[directory]gnuplot.hlb + Alternatively, put the help in the main system help library. AmigaOS ------- @@ -208,6 +233,18 @@ Using Aztec C 5.2a make -f makefile.ami Using SAS/C 6.1 or later versions smake -f makefile.amg + You can also copy makefile.amg to smakefile and just type `smake'. + + At the beginning of makefile.amg you will find a configuration + section where you have to adjust all settings which control the build + process. Most important is probably to select the terminal devices + which should be supported. You can create a version offering + png graphics as well as gif support. Use the appropriate settings + for CPU and MATH to compile for a specific machine type. + Be sure to enable only those devices for which you have the + necessary software already installed. Also ensure that the + libraries and the sources are all compiled using the same + settings for CPU and MATH. Using gcc: see Unix Atari/TOS @@ -225,34 +262,60 @@ Using TurboC MS-Windows ---------- -Using Microsoft C 7.0 and compiling for MS-Windows +Common for all Windows builds: The program doesn't need to be installed +specially. Just copy all the relevant files mentioned a single directory, +and you're done. You'll probably want to generate a desktop icon +(program manager group/icon, desktop shortcut, or Start->Programs menu +entry) for wgnuplot.exe or wgnupl32.exe, and optionally register +wgnuplot/wgnupl32 as the program to open plot script file with. +Suggested filename extensions would be *.plt or *.gpl. + +Using Microsoft C 7.0 and compiling for 16bit MS-Windows (3.x, WfW) copy makefile.msw makefile nmake Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu - in the windows directory. + in some directory. -Using Borland C++ 3.1 and compiling for MS-Windows +Using Borland C++ 3.1 and compiling for 16bit MS-Windows (3.x, WfW) copy makefile.win makefile - Edit makefile to change TC. + Edit makefile to change TC, and check other possible options to set. + You may want to edit the 16bit-only section of term.h to select a + different set of terminal drivers. make Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu - in the windows directory. + in some directory. -Using the MinGW32 port of egcs: you need the Micrsoft SDK for the -moment. +Using Borland C++ 4.52, C++ Builder 1.0 or the "free" command line +version 5.5, compiling for 32bit MS-Windows (XP/2K/NT/95/98/ME) + copy makefile.win makefile + Edit makefile to change TC, LINK32, RUNTIME_LIB and other + configuration options as documented in the makefile itself. + make -DWIN32=1 + Copy wgnupl32.exe, wgnuplot.hlp and wgnuplot.mnu to some directory. + +Using Visual C++ and compiling for 32bit Windows (XP/2K/NT/95/98/ME) + nmake -f makefile.nt + or + copy makefile.nt makefile + nmake + +Using the MinGW32 port of GCC, plus the Microsoft Help Compiler (part +of the "Platform SDK", but also available individually): copy makefile.mgw makefile Look through the Makefile to see if you need to make any changes. make + Optionally check the target directory in the makefile and make install -Using the Cygwin port of gcc, which includes MinGW32: you need the -Micrsoft SDK for the moment. +Using the Cygwin port of GCC, which includes MinGW32. Again, you need the +MS Help Compiler in addition to a reasonably complete Cygwin install. copy makefile.cyg makefile Look through the Makefile to see if you need to make any changes. make - Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu - in the windows directory. + Put wgnuplot.exe, wgnuplot.hlp and wgnuplot.mnu + in some directory. + MSDOS ----- @@ -262,18 +325,24 @@ Using DJGPP just run djconfig.sh, and then make. For novices, it is recommended to use makefile.dj2 instead: copy makefile.dj2 makefile + Optionally check and adapt the makefile to turn on additional features. make + or even simpler + make -fmakefile.dj2 Using Microsoft C 7.0. copy makefile.msc makefile nmake -Using Borland C++ 3.0 +Using Borland C++ 3.0 or 3.1 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). + Optionally edit the 16-bit special selection of terminal drivers in + term.h if you need any driver that isn't part of the default collection. 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} @@ -335,123 +404,78 @@ The CGI drivers need the CGIPATH environment variable to the CGI agents, and the CGIDISP and/or CGIPRNT environment variables to set the output devices. - If using dynamically linked executables with the X11 Window System, it -may be necessary to define LD_LIBRARY_PATH - see man ld for details. -It is, however, prefered to use the appropriate linker options, eg. --R under Solaris, or -rpath under DEC Unix and Irix. + If creating dynamically linked executables for the X11 Window System, it +may be necessary to add flags to the LIBS variable in Makefile +to make sure gnuplot finds all required libraries at runtime. Systems like +SunOS and Solaris use -R to specify the runtime library search path, whereas +OSF/Dec Unix, Irix and Linux use -rpath. If this is not possible, the +LD_LIBRARY_PATH environment variable should be set. About --with-PACKAGE[=PATH] *************************** - The following description applies to gnuplot only. - Every `--with-PACKAGE' option sets a `with_package' variable in configure. Depending on how `--with-PACKAGE' was invoked, there are only three different possible values for the `with_package' variable: Option $with_package ---------------------------------------- -(not specified) yes +(not specified) yes or no --with-package yes --with-package=yes yes --with-package=no no --with-package=PATH PATH --without-package no - This means that configure will always (by default) try to locate PACKAGE -unless `--with-package=no' or `--without-package' was specified. Examples -for with-PACKAGE options used by gnuplot's configure are `--with-gd', -`--with-png'. The corresponding package variables are `with_gd', -and `with_png'. + In gnuplot, the following --with-PACKAGE options are available: - For gnuplot, configure uses the macros `gp_SEARCH_LIBDIRS' and -`gp_SEARCH_HEADERDIRS' to search for libraries and includes, resp. These -macros are different from the standard GNU autoconf macros for this purpose, -`AC_CHECK_LIB' and `AC_CHECK_HEADER/S' (see autoconf manual). The -gp_XXX macros are closely tied to gnuplot, and cannot be used for other -packages without modification. + --with-readline - The difference between these package specific macros and standard -autoconf macros is that they do search more than one (the default) -directory to determine the location of the specified file. + Use gnuplot's builtin readline function. This is enabled by default. - Libraries will be searched in at least three, and up to five different -directories, depending on the PATH specified with `--with-PACKAGE=PATH': + --without-readline - o the default linker path (this is really more than one directory) - o /usr/local/lib, which is a fairly common place for 3rd party libs - o the PATH directory, trailing `/lib/libPACKAGE.a' stripped off - o the PATH directory, trailing `/lib/libPACKAGE.a' stripped off and - `/lib' added - o the PATH directory, trailing `/libPACKAGE.a' stripped off. + (same as --with-readline=no) Do not use gnuplot's builtin readline function. - Using the default linker path as the first search directory has one -big, but not so obvious advantage: if all libraries are in the same -directory, the path to the first library specified with --with-PACKAGE -is added to the linker path with a `-L' option. The library searched -for with the next --with-PACKAGE option will now be found faster, because -only one additional directory is checked. This is also true for header files. + --with-readline=gnu - Example: the user has unpacked the gd library distribution into -/home/user/source/gd: + Use the GNU readline library instead of gnuplot's builtin readline. -$ configure --with-gd=/home/user/source/gd + --with-readline[=PATH] -will search the following directories for libgd.a: + Use the GNU readline library instead of gnuplot's builtin readline. + This form is required if GNU readline is not installed in a default + location. - o the default linker path - o /usr/local/lib - o /home/user/source/gd - o /home/user/source/gd/lib - o /home/user/source/gd + --with-gd[=PATH] - Include files will be searched in at least two, and up to three different -directories, depending on the PATH specified with `--with-PACKAGE=PATH': + Dto. for Thomas Boutell's gd library. This option is off by default, + as the developers want to encourage users to use the png format instead + of gif. - o the default include path (can be more than one diretcory) - o /usr/local/include, a fairly common place for 3rd party headers - o the PATH directory, trailing `/lib/libPACKAGE.a' stripped off - o the PATH directory, trailing `/lib/libPACKAGE.a' stripped off and - `/include' added + --with-png[=PATH] - Caveat: the `gp_SEARCH_HEADERDIRS' macro should only be used after the -corresponding `gp_SEARCH_LIBDIRS' macro to take full advantage of the -search algorithm. This is a reasonable assumption nevertheless, because -it allows for structuring configure.in so that the test for a header file -is skipped if the corresponding library is not found. + Dto. for the png library. This option is on by default. - Here are some more examples: + --with-pdf[=PATH] - o the gd and png libraries are in /usr/local/gnu/lib, which is - automatically searched by gcc. The corresponding header files are - in /usr/local/gnu/include, which is not in gcc's include search path. - Solution: + Dto. for the pdf library. This option off on by default. - $ ./configure --with-gd=/usr/local/gnu + --with-plot[=PATH] - o the gd and png libraries are in /opt/gnu/lib, the header files are - in /opt/gnu/include. Solution: - - $ ./configure --with-gd=/opt/gnu + If used without the PATH argument, this option selects the standard + UNIX plot library, if available. If used with the PATH argument, + configure looks for the plot library from GNU plotutils. Version 2.2 + or better is required. The option is off by default. - o the gd and png libraries and headers are all in different directories, - none of which is in the compilers search path: - - $ ./configure --with-gd=/tmp/gd --with-png=/tmp/libpng - -[I would like to implement the more generic `--site-includes' and -`--site-libraries' options for additional flexibility, but this is -painfully difficult with the current autoconf. It also seems that such -a feature would not comply with GNU coding standards.] - Platform problems and testing ***************************** This section addresses trouble shooting and testing issues. Userland questions are answered in the FAQ. -Platform notes -============== +Platform and compiler notes +=========================== Generally, if you think that configure has made a mistake in detecting platform features, there are two ways to switch these off. @@ -474,15 +498,23 @@ and rerun configure, or, edit config.h and change may contain other defines (make DEFS='-DHAVE_CONFIG_H -DHAVE_MEMSET' should work, though). + - gcc -ansi + If you wish to compile with gcc -ansi (CC='gcc -ansi -pedantic' + ./configure), additional platform specific defines may be necessary + to include non-ANSI function prototypes. E.g. on Solaris, -D__EXTENSIONS__ + is needed. Otherwise, non-declared functions not returning int will be + assumed to return int, with possibly dangerous consequences. Especially + scpecfun.c is vulnerable here. + - HP-UX 9.x It is recommended to use gcc, although the native compiler cc may work with warnings. - - HP-UX 10.x - It is recommended to use the native compiler cc, as problems - have been reported when using gcc. In the cases reported, we have - yet to establish whether the compiler is at fault, or the compiler - setup/configuration is broken. + - HP-UX 10.x and above + GCC has known problems on this platform if configured to use HP's + assembler. The telltale symptom are tic labels all ending up at + position 0.0. So either make sure you use a GCC configured to use + GNU as, or use HP's ANSI cc (the unbundled one). - IRIX 6.x If you want to use the png terminal, you must install your own @@ -516,14 +548,13 @@ should work, though). (Bourne shell syntax) - $ cd gnuplot + $ cd gnuplot-3.7.3 $ CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure or (C shell syntax) - prompt (41) cd gnuplot - prompt (42) setenv CC 'cc -B/full/path/to/unproto/dir/ -tp' - prompt (43) ./configure + $ cd gnuplot-3.7.3 + $ env CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure The required compiler options shown here are for System V.2. For other platforms, consult the unproto documentation. `/full/path/to/unproto/dir' @@ -569,11 +600,10 @@ the 'test' command: $ gnuplot G N U P L O T - Unix version 3.7 - patchlevel 0 - last modified Tue Jan 12 13:48:06 BST 1999 + Unix version 3.7 patchlevel 2 + last modified Sat Jan 19 15:23:37 GMT 2002 - Copyright(C) 1986 - 1993, 1998 + Copyright(C) 1986 - 1993, 1993, 1998 - 2002 Thomas Williams, Colin Kelley and many others Send comments and requests for help to info-gnuplot@dartmouth.edu @@ -590,12 +620,14 @@ Front Ends for gnuplot o Xgfe by David Ishee , available from http://von-mises.home.ml.org/xgfe/xgfe.html - If you download the source, you need Qt library from - http://www.troll.no/ + To compile from source, you need Qt library from + http://www.troll.no/. o Bruce Ravel has written a new version of gnuplot-mode for GNU emacs and XEmacs. This version is based on the gnuplot.el file by Gershon Elber which is included with this distribution. The package is available from - http://feff.phys.washington.edu/~ravel/gnuplot/ + http://feff.phys.washington.edu/~ravel/gnuplot/. + Future distributions of gnuplot will hopefully include Bruce's + version.