OpenXM_contrib/gnuplot/0INSTALL - diff

Return to 0INSTALL CVS log

Up to [local] / OpenXM_contrib / gnuplot

Diff for /OpenXM_contrib/gnuplot/Attic/0INSTALL between version 1.1 and 1.1.1.3

version 1.1, 2000/01/09 17:00:48

version 1.1.1.3, 2003/09/15 07:09:21

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 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

Line 52 several different ways:

Line 58 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).

Line 68 ways:

Line 77 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.

Line 100 used through the CC environment variable:

Line 112 used through the CC environment variable:

$ CC=c89 ./configure

(C shell)

$ setenv CC c89

$ env CC=c89 ./configure

$ ./configure

Any environment settings for CFLAGS are included into the Makefile,

so please make sure that these are really needed.

Line 111 to change. A complete list of options is available th

Line 122 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.

Line 121 $ ./configure --help

Line 134 $ ./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-x (*) use the X Window System

--with-gnu-readline Use the GNU readline version If you don't use this,

--with-lasergnu install lasergnu printer script

you won't have file name completion.

--with-linux-vga use the Linux SVGA console driver

--with-gnu-readline=PATH Specify the location of libreadline.

(requires /usr/lib/libvga)

Use this form if your libreadline is not installed

--with-readline (*) use the builtin minimal readline function (default)

where your linker can find it.

--without-readline do not use the builtin readline function

--with-plot use the Unix plot library

--with-readline=gnu use the GNU readline library

--with-plot=PATH Specify the location of GNU libplot

--with-readline[=PATH] Specify the location of GNU readline

--with-gd (*) Enable gif terminal with Tom Boutell's gd library

--with-gd[=PATH] enable gif terminal with Tom Boutell's 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)

--with-png=PATH Specify the location of libpng

--with-pdf[=PATH] enable pdf terminal

--with-cwdrc Check current directory for .gnuplotrc file,

(requires PDFLib)

normally disabled for security reasons. However,

--with-cwdrc check current directory for .gnuplot file,

the home directory is always checked for a

normally disabled for security reasons

.gnuplotrc file.

--enable-ggi enable ggi driver (EXPERIMENTAL)

--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)

--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=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

------------------

Line 184 Unix, no configure

Line 189 Unix, no configure

VMS

---

On VMS, invoke MAKE_VMS.COM (or BUILDVMS.COM if you have MMS or MMK

John Hasstedt <John.Hasstedt@sunysb.edu> has written configure.vms,

but don't want to use the supplied DESCRIP.MMS). You may get warnings

a command file that creates the necessary make and option files to build

or more serious errors depending on the versions of the C compiler, the

gnuplot. See the file for instructions on using it. If you have problems

C run-time libraries, and {Open}VMS on your system.

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),

To compile using MMK:

invoke MMS or MMK with the supplied descrip.mms

MMK/DESCRIPTION=MAKEFILE.VMS

Or if you have a unix-like make utility

To compile using MMS on VAX:

copy makefile.vms makefile

MMS/DESCRIPTION=MAKEFILE.VMS

make

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.

Alternatively, put the help in the main system help library.

AmigaOS

-------

Line 208 Using Aztec C 5.2a

Line 233 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

Line 225 Using TurboC

Line 262 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

Using Borland C++ 4.52, C++ Builder 1.0 or the "free" command line

moment.

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

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

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

Look through the Makefile to see if you need to make any changes.

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

-----

Line 262 Using DJGPP

Line 325 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}

Line 335 The CGI drivers need the CGIPATH environment variable

Line 404 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

If creating dynamically linked executables for the X11 Window System, it

may be necessary to define LD_LIBRARY_PATH - see man ld for details.

may be necessary to add flags to the LIBS variable in Makefile

It is, however, prefered to use the appropriate linker options, eg.

to make sure gnuplot finds all required libraries at runtime. Systems like

-R under Solaris, or -rpath under DEC Unix and Irix.

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

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

*****************************

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.

Line 474 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'

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

- 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

If you want to use the png terminal, you must install your own

Line 516 should work, though).

Line 548 should work, though).

(Bourne shell syntax)

$ cd gnuplot

$ cd gnuplot-3.7.3

$ CC='cc -B/full/path/to/unproto/dir/ -tp' ./configure <options>

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

platforms, consult the unproto documentation. `/full/path/to/unproto/dir'

Line 569 the 'test' command:

Line 600 the 'test' command:

$ gnuplot

G N U P L O T

Unix version 3.7

Unix version 3.7 patchlevel 2

patchlevel 0

last modified Sat Jan 19 15:23:37 GMT 2002

last modified Tue Jan 12 13:48:06 BST 1999

Thomas Williams, Colin Kelley and many others

Send comments and requests for help to info-gnuplot@dartmouth.edu

Line 590 Front Ends for gnuplot

Line 620 Front Ends for gnuplot

o Xgfe by David Ishee <dmishee@jasper.he.net>, available from

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

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.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>