Install Guide of gnuplot-3.7+1.2 --- for UNIX/LINUX ---

               Copyright (C) 1993 - 2001   Masahito Yamaga

------------------------------------------------------------------------------
*Note* Distribution of GNUPLOT that has been applied this patch to
       (especially binaries) has to be very carefully done.

       See "Copyright" in the original GNUPLOT source package.

(Quoted from Copyright)
   1. distribute the corresponding source modifications from the
    released version in the form of a patch file along with the binaries,
   2. add special version identification to distinguish your version
    in addition to the base release version number,
   3. provide your name and address as the primary contact for the
    support of your modified version, and
   4. retain our contact information in regard to use of the base
    software.
------------------------------------------------------------------------------

1. Preparations of Sources

Get a source file of gnuplot-3.7.1 from anonymous ftp server and unpack it.

  prompt% gunzip -c (somewhere)/gnuplot-3.7.1.tar.gz | tar xf -

Unpack this package in the directory of gnuplot.

  prompt% cd gnuplot-3.7.1
  prompt% gunzip -c (somewhere)/gnuplot3.7.1+1.2.(rev).patch.tar.gz | tar xf -

Apply the patch-file by GNU patch command.

  prompt% patch -p0 < gnuplot3.7+1.2.patch

To avoid re-checking by configure, change time-stamps of some files.

  prompt% touch aclocal.m4
  prompt% touch configure

Make Makefiles by executing "configure".

  prompt% ./configure

On HP-UX 9.x, you had better use cc than gcc. Run as

  prompt% env CC=cc ./configure

in order to use cc.

If you want to use "GNU readline library" for command-line-editing,
execute this script as

  prompt% ./configure --with-readline=gnu

or

  prompt% ./configure --with-readline=/usr/local/lib/libreadline.a

This "GNU readline library" is included in source package of "bash" and
GNU debugger "gdb". It is also distributed as "readline-4.0.tar.gz"
independently.

"GNU readline library" is also needed if you want the function to save
histories of command-line-editing in a file (~/.gp_history).

To get more information about options of "configure", execute it as

  prompt% ./configure --help


2. Customize according to Environments

Just "make" in almost all of cases.
But you have to change Makefile in the following cases.

(1) No Japanese texts on X11 terminal are needed.

    Add "-DX11ORG" to  "DEFS = " in Makefile.

    (You had better do it if your OS does not have Japanese locale.)

(2) To change default "font set" to be used in X11 terminal.

    In patched gnuplot, gnuplot_x11 uses the font set:

        '-*-fixed-medium-r-normal--14-*,-*-medium-r-normal-*-14-*'

    or if not available

        '-*-fixed-medium-r-normal--16-*,-*-medium-r-normal-*-16-*'

    This font set is a little bit larger than original one ("fixed").
    If you want to use another font set, take one of the followings:

       (a) Add -DFallbackFont=\"font_set_name\" to "DEFS =" in Makefile
       (b) Start gnuplot as
                 gnuplot -font 'font_set_name'
       (c) Set
                 Gnuplot*font:	font_set_name
           in ~/.Xdefaults

(3) No saving histories of command-line-editing in a file is needed

      Add "-DNO_SAVE_HIST" to DEFS in Makefile.

      Note:  gnuplot cannot save histories even if "-DNO_SAVE_HIST"
             is not added, in case of executing "configure" script
             without "--with-readline=gnu" nor "--with-readline=PATH".

(4) To change maximum size of a history-saving file ~/.gp_history

      The environment variable GP_HISTFILESIZE is available.
      But if you want to change the default value from 100,
      add -DGP_DEFAULT_HISTFILESIZE=[number] to DEFS in Makefile.


3. make & make install

Make gnuplot and install it.

With GNU make, it re-checks a configuration by autoconf and automake.
You had better use OS's "make" in case that you re-wrote Makefile like
above or do not have autoconf and automake.

      prompt% make
      prompt% su

      prompt# make install


4. OS and C-compilers

    SunOS 5.5.1         + gcc-2.8.1
    SunOS 5.6           + gcc-2.8.1
    SunOS 5.6           + egcs-2.91.66 19990314 (egcs-1.1.2 release)
    SunOS 4.1.3 JLE     + gcc-2.8.1
    FreeBSD 2.2.8       + gcc-2.8.1
    HP-UX 10.20         + gcc-2.8.1 (+ binutils-2.9.1)
    IRIX 6.3            + gcc-2.8.1
    Linux/Sparc (libc5) + gcc-2.7.2.1
    Cray UNICOS 9.0.2.2 + /opt/ctl/bin/cc


                                   2001/01/11 Masahito Yamaga (ma@yama-ga.com)
