version 1.1.1.2, 2000/01/22 14:15:47 |
version 1.1.1.3, 2003/09/15 07:09:21 |
Line 27 install the gd library : see term/gif.trm for details. |
|
Line 27 install the gd library : see term/gif.trm for details. |
|
png and z libraries : see term/png.trm for details. Note that the |
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. |
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 |
A complete overview of configure options is below in the Basic |
Installation section. On platforms which do not support GNU |
Installation section. On platforms which do not support GNU |
autoconf/configure, ie. most non-Unix platforms, look for a makefile |
autoconf/configure, ie. most non-Unix platforms, look for a makefile |
Line 106 used through the CC environment variable: |
|
Line 112 used through the CC environment variable: |
|
$ CC=c89 ./configure |
$ CC=c89 ./configure |
|
|
(C shell) |
(C shell) |
$ setenv CC c89 |
$ env CC=c89 ./configure |
$ ./configure |
|
|
|
Any environment settings for CFLAGS are included into the Makefile, |
Any environment settings for CFLAGS are included into the Makefile, |
so please make sure that these are really needed. |
so please make sure that these are really needed. |
Line 117 to change. A complete list of options is available th |
|
Line 122 to change. A complete list of options is available th |
|
|
|
$ ./configure --help |
$ ./configure --help |
|
|
|
The options relevant to gnuplot are listed below: |
|
|
--prefix=PREFIX Install architecture-independent files in PREFIX |
--prefix=PREFIX Install architecture-independent files in PREFIX |
[/usr/local]. The gnuplot (and gnuplot_x11) binary |
[/usr/local]. The gnuplot (and gnuplot_x11) binary |
is installed in PREFIX/bin. |
is installed in PREFIX/bin. |
Line 127 $ ./configure --help |
|
Line 134 $ ./configure --help |
|
--libdir=DIR object code libraries in DIR [EPREFIX/lib] |
--libdir=DIR object code libraries in DIR [EPREFIX/lib] |
--includedir=DIR C header files in DIR [PREFIX/include] |
--includedir=DIR C header files in DIR [PREFIX/include] |
--mandir=DIR Man documentation in DIR [PREFIX/man] |
--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 |
--without-readline do not use the builtin readline function |
--with-readline=gnu use the GNU readline library |
--with-readline=gnu use the GNU readline library |
--with-readline=PATH Specify the location of GNU readline |
--with-readline[=PATH] Specify the location of GNU readline |
--with-plot use the Unix plot library |
--with-gd[=PATH] enable gif terminal with Tom Boutell's gd library |
--with-plot=PATH Specify the location of GNU libplot |
|
--with-gd (*) Enable gif terminal with Tom Boutell's gd library |
|
(requires GD library) |
(requires GD library) |
--with-gd=PATH Specify the location of libgd |
--with-plot[=PATH] use the Unix plot library |
--with-png (*) Enable png terminal |
--with-png[=PATH] (*) enable png terminal |
(requires libpng and libz) |
(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, |
--with-cwdrc check current directory for .gnuplot file, |
normally disabled for security reasons |
normally disabled for security reasons |
--with-lasergnu install lasergnu printer script |
--enable-ggi enable ggi driver (EXPERIMENTAL) |
--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-iris enable IRIS terminal (IRIS4D only) |
--enable-iris enable IRIS terminal (IRIS4D only) |
--enable-sun enable sunview terminal (Sun only) |
--enable-mgr enable MGR terminal |
--enable-unixpc enable unixpc terminal (ATT 3b1 or ATT 7300) |
--enable-rgip enable Redwood Graphics Interface Protocol |
--enable-system-time use the system time routines in time.c |
|
--with-x (*) Use the X Window System |
|
|
|
Options marked with (*) are on by default, ie. these features or packages |
Options marked with (*) are enabled by default, ie. these features or |
will be used if configure can detect them, even if the corresponding option |
packages are used if configure detects them even if the corresponding |
is not specified. Please note that the `--with-PACKAGE' options can have |
option is not specified. Please note that the `--with-PACKAGE' options |
additional arguments: |
can have additional arguments: |
|
|
o `--with-PACKAGE' is equivalent to `--with-PACKAGE=yes' |
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'. |
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 |
Unix, no configure |
------------------ |
------------------ |
Line 186 Unix, no configure |
|
Line 189 Unix, no configure |
|
VMS |
VMS |
--- |
--- |
|
|
|
John Hasstedt <John.Hasstedt@sunysb.edu> 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 |
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 |
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 |
DECC V5.7; you may get warnings or more serious errors depending on |
|
|
MS-Windows |
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 |
copy makefile.msw makefile |
nmake |
nmake |
Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu |
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 |
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 |
make |
Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu |
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 |
nmake -f makefile.nt |
or |
or |
copy makefile.nt makefile |
copy makefile.nt makefile |
nmake |
nmake |
|
|
Using the MinGW32 port of egcs: you need the Micrsoft SDK for the |
Using the MinGW32 port of GCC, plus the Microsoft Help Compiler (part |
moment. |
of the "Platform SDK", but also available individually): |
copy makefile.mgw makefile |
copy makefile.mgw makefile |
Look through the Makefile to see if you need to make any changes. |
Look through the Makefile to see if you need to make any changes. |
make |
make |
|
Optionally check the target directory in the makefile and |
make install |
make install |
|
|
Using the Cygwin port of gcc, which includes MinGW32: you need the |
Using the Cygwin port of GCC, which includes MinGW32. Again, you need the |
Micrsoft SDK for the moment. |
MS Help Compiler in addition to a reasonably complete Cygwin install. |
copy makefile.cyg makefile |
copy makefile.cyg makefile |
Look through the Makefile to see if you need to make any changes. |
Look through the Makefile to see if you need to make any changes. |
make |
make |
Put wgnuplot.exe, wgnuplot.dll, wgnuplot.hlp and wgnuplot.mnu |
Put wgnuplot.exe, wgnuplot.hlp and wgnuplot.mnu |
in the windows directory. |
in some directory. |
|
|
|
|
MSDOS |
MSDOS |
----- |
----- |
|
|
|
|
just run djconfig.sh, and then make. |
just run djconfig.sh, and then make. |
For novices, it is recommended to use makefile.dj2 instead: |
For novices, it is recommended to use makefile.dj2 instead: |
copy makefile.dj2 makefile |
copy makefile.dj2 makefile |
|
Optionally check and adapt the makefile to turn on additional features. |
make |
make |
|
or even simpler |
|
make -fmakefile.dj2 |
|
|
Using Microsoft C 7.0. |
Using Microsoft C 7.0. |
copy makefile.msc makefile |
copy makefile.msc makefile |
nmake |
nmake |
|
|
Using Borland C++ 3.0 |
Using Borland C++ 3.0 or 3.1 |
copy makefile.tc makefile |
copy makefile.tc makefile |
Edit makefile to change TC, BIN, BGI, BGIOBJ. You may also want to turn |
Edit makefile to change TC, BIN, BGI, BGIOBJ. You may also want to turn |
off overlays (See manual for more on overlays). |
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 |
make |
|
|
|
|
The file gnuplot.gih is needed for help on the PC. |
The file gnuplot.gih is needed for help on the PC. |
If the file gnuplot.gih is not in the default directory, then use: |
If the file gnuplot.gih is not in the default directory, then use: |
set GNUHELP={full path name of gnuplot.gih} |
set GNUHELP={full path name of gnuplot.gih} |
Line 379 LD_LIBRARY_PATH environment variable should be set. |
|
Line 414 LD_LIBRARY_PATH environment variable should be set. |
|
About --with-PACKAGE[=PATH] |
About --with-PACKAGE[=PATH] |
*************************** |
*************************** |
|
|
The following description applies to gnuplot only. |
|
|
|
Every `--with-PACKAGE' option sets a `with_package' variable in |
Every `--with-PACKAGE' option sets a `with_package' variable in |
configure. Depending on how `--with-PACKAGE' was invoked, there are |
configure. Depending on how `--with-PACKAGE' was invoked, there are |
only three different possible values for the `with_package' variable: |
only three different possible values for the `with_package' variable: |
|
|
Option $with_package |
Option $with_package |
---------------------------------------- |
---------------------------------------- |
(not specified) yes |
(not specified) yes or no |
--with-package yes |
--with-package yes |
--with-package=yes yes |
--with-package=yes yes |
--with-package=no no |
--with-package=no no |
--with-package=PATH PATH |
--with-package=PATH PATH |
--without-package no |
--without-package no |
|
|
This means that configure will always (by default) try to locate PACKAGE |
In gnuplot, the following --with-PACKAGE options are available: |
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'. |
|
|
|
For gnuplot, configure uses the macros `gp_SEARCH_LIBDIRS' and |
--with-readline |
`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. |
|
|
|
The difference between these package specific macros and standard |
Use gnuplot's builtin readline function. This is enabled by default. |
autoconf macros is that they do search more than one (the default) |
|
directory to determine the location of the specified file. |
|
|
|
Libraries will be searched in at least three, and up to five different |
--without-readline |
directories, depending on the PATH specified with `--with-PACKAGE=PATH': |
|
|
|
o the default linker path (this is really more than one directory) |
(same as --with-readline=no) Do not use gnuplot's builtin readline function. |
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. |
|
|
|
Using the default linker path as the first search directory has one |
--with-readline=gnu |
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. |
|
|
|
Example: the user has unpacked the gd library distribution into |
Use the GNU readline library instead of gnuplot's builtin readline. |
/home/user/source/gd: |
|
|
|
$ 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 |
--with-gd[=PATH] |
o /usr/local/lib |
|
o /home/user/source/gd |
|
o /home/user/source/gd/lib |
|
o /home/user/source/gd |
|
|
|
Include files will be searched in at least two, and up to three different |
Dto. for Thomas Boutell's gd library. This option is off by default, |
directories, depending on the PATH specified with `--with-PACKAGE=PATH': |
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) |
--with-png[=PATH] |
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 |
|
|
|
Caveat: the `gp_SEARCH_HEADERDIRS' macro should only be used after the |
Dto. for the png library. This option is on by default. |
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. |
|
|
|
Here are some more examples: |
--with-pdf[=PATH] |
|
|
o the gd and png libraries are in /usr/local/gnu/lib, which is |
Dto. for the pdf library. This option off on by default. |
automatically searched by gcc. The corresponding header files are |
|
in /usr/local/gnu/include, which is not in gcc's include search path. |
|
Solution: |
|
|
|
$ ./configure --with-gd=/usr/local/gnu |
--with-plot[=PATH] |
|
|
o the gd and png libraries are in /opt/gnu/lib, the header files are |
If used without the PATH argument, this option selects the standard |
in /opt/gnu/include. Solution: |
UNIX plot library, if available. If used with the PATH argument, |
|
configure looks for the plot library from GNU plotutils. Version 2.2 |
$ ./configure --with-gd=/opt/gnu |
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 |
Platform problems and testing |
***************************** |
***************************** |
|
|
This section addresses trouble shooting and testing issues. Userland |
This section addresses trouble shooting and testing issues. Userland |
questions are answered in the FAQ. |
questions are answered in the FAQ. |
|
|
Platform notes |
Platform and compiler notes |
============== |
=========================== |
|
|
Generally, if you think that configure has made a mistake in detecting |
Generally, if you think that configure has made a mistake in detecting |
platform features, there are two ways to switch these off. |
platform features, there are two ways to switch these off. |
Line 510 and rerun configure, or, edit config.h and change |
|
Line 498 and rerun configure, or, edit config.h and change |
|
may contain other defines (make DEFS='-DHAVE_CONFIG_H -DHAVE_MEMSET' |
may contain other defines (make DEFS='-DHAVE_CONFIG_H -DHAVE_MEMSET' |
should work, though). |
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 |
- HP-UX 9.x |
It is recommended to use gcc, although the native compiler cc may |
It is recommended to use gcc, although the native compiler cc may |
work with warnings. |
work with warnings. |
|
|
- HP-UX 10.x |
- HP-UX 10.x and above |
It is recommended to use the native compiler cc, as problems |
GCC has known problems on this platform if configured to use HP's |
have been reported when using gcc. In the cases reported, we have |
assembler. The telltale symptom are tic labels all ending up at |
yet to establish whether the compiler is at fault, or the compiler |
position 0.0. So either make sure you use a GCC configured to use |
setup/configuration is broken. |
GNU as, or use HP's ANSI cc (the unbundled one). |
|
|
- IRIX 6.x |
- IRIX 6.x |
If you want to use the png terminal, you must install your own |
If you want to use the png terminal, you must install your own |
Line 552 should work, though). |
|
Line 548 should work, though). |
|
|
|
(Bourne shell syntax) |
(Bourne shell syntax) |
|
|
$ cd gnuplot |
$ cd gnuplot-3.7.3 |
$ CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure <options> |
$ CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure <options> |
|
|
or (C shell syntax) |
or (C shell syntax) |
|
|
prompt (41) cd gnuplot |
$ cd gnuplot-3.7.3 |
prompt (42) setenv CC 'cc -B/full/path/to/unproto/dir/ -tp' |
$ env CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure <options> |
prompt (43) ./configure <options> |
|
|
|
The required compiler options shown here are for System V.2. For other |
The required compiler options shown here are for System V.2. For other |
platforms, consult the unproto documentation. `/full/path/to/unproto/dir' |
platforms, consult the unproto documentation. `/full/path/to/unproto/dir' |
Line 605 the 'test' command: |
|
Line 600 the 'test' command: |
|
$ gnuplot |
$ gnuplot |
|
|
G N U P L O T |
G N U P L O T |
Unix version 3.7 |
Unix version 3.7 patchlevel 2 |
patchlevel 1 |
last modified Sat Jan 19 15:23:37 GMT 2002 |
last modified Tue Jan 12 13:48:06 BST 1999 |
|
|
|
Copyright(C) 1986 - 1993, 1998 |
Copyright(C) 1986 - 1993, 1993, 1998 - 2002 |
Thomas Williams, Colin Kelley and many others |
Thomas Williams, Colin Kelley and many others |
|
|
Send comments and requests for help to info-gnuplot@dartmouth.edu |
Send comments and requests for help to info-gnuplot@dartmouth.edu |
Line 626 Front Ends for gnuplot |
|
Line 620 Front Ends for gnuplot |
|
|
|
o Xgfe by David Ishee <dmishee@jasper.he.net>, available from |
o Xgfe by David Ishee <dmishee@jasper.he.net>, available from |
http://von-mises.home.ml.org/xgfe/xgfe.html |
http://von-mises.home.ml.org/xgfe/xgfe.html |
If you download the source, you need Qt library from |
To compile from source, you need Qt library from |
http://www.troll.no/ |
http://www.troll.no/. |
|
|
o Bruce Ravel <ravel@phys.washington.edu> has written a new version of |
o Bruce Ravel <ravel@phys.washington.edu> has written a new version of |
gnuplot-mode for GNU emacs and XEmacs. This version is based on |
gnuplot-mode for GNU emacs and XEmacs. This version is based on |
the gnuplot.el file by Gershon Elber which is included with this |
the gnuplot.el file by Gershon Elber which is included with this |
distribution. The package is available from |
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. |
|
|