=================================================================== RCS file: /home/cvs/OpenXM_contrib/gnuplot/Attic/0INSTALL,v retrieving revision 1.1.1.2 retrieving revision 1.1.1.3 diff -u -p -r1.1.1.2 -r1.1.1.3 --- OpenXM_contrib/gnuplot/Attic/0INSTALL 2000/01/22 14:15:47 1.1.1.2 +++ 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 @@ -106,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. @@ -117,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. @@ -127,41 +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] - --with-readline (*) use the builtin minimal readline function + --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-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-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-pdf[=PATH] enable pdf terminal + (requires PDFLib) --with-cwdrc check current directory for .gnuplot file, normally disabled for security reasons - --with-lasergnu install lasergnu printer script - --with-linux-vga use the Linux SVGA console driver - (requires /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) + --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 ------------------ @@ -186,6 +189,12 @@ Unix, no configure VMS --- + 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 @@ -253,40 +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 Visual C++ and compiling for Windows NT/95/98 +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 egcs: you need the Micrsoft SDK for the -moment. +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 ----- @@ -296,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} @@ -379,115 +414,68 @@ 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. @@ -510,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 @@ -552,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' @@ -605,11 +600,10 @@ the 'test' command: $ gnuplot G N U P L O T - Unix version 3.7 - patchlevel 1 - 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 @@ -626,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.