This is  gnuplot version 4.2.2  --  binary distribution for OS/2
================================================================

0) Important information for this gnuplot binary release
========================================================

This binary relesae was compiled from the gnuplot 4.2.2 source code plus all
fixes till January 2008. It includes all relevant terminals. It was compiled
with gd library version 2.0.33, and thus in the portfolio of bitmapped
terminals only png is supported, but not jpeg nor gif nor animated gif (for
those, 2.0.35 would be needed).

Currently known OS/2-specific bugs: "pause mouse" and "pause mouse key" has not
yet been implemented.


1) Introduction
===============

This file discusses mainly the version of gnuplot 4.0.0 and later implemented
for OS/2 using the PM terminal driver. The X11 terminal driver is included and
discussed too.

The command line interface of gnuplot is retained, while graphics output is
plotted in a Presentation Manager Window. The gnuplot command line appears
in another text-mode window on the screen.

The PM window has facilities for printing the plot on the default printer,
for changing the fonts used on the plot, and for switching between different
ways of plotting the lines (with colour, as dot/dashed lines, or both).

Multiple graph windows are supported: try "help term pm".

The command line window offers the usual gnuplot interface. Both Unix-style
and DOS-style editing keys are supported.

The gnuplot program was compiled with the emx version of the GNU compiler.
It supports the shell command (type 'exit' to return to gnuplot), can pipe
datafiles through external commands using '<', and supports command-line
substitution. It runs the full set of demonstration programs supplied in the
gnuplot source code distribution without problems.

Optional terminal drivers included in this binary distribution are for PNG
with TrueType font support.

2) Installation
===============

This distribution of gnuplot 4.0.0 was compiled for OS/2 (2.x and above)
with emx version 0.9d. You will require emx.dll (for 0.9d) in order to run
it - available from most large OS/2 archives like (look for emxrt.zip).

Unzip the gnuplot distribution into a directory in the PATH, or unzip it
somewhere and add this path to PATH, e.g.
	SET PATH=...;C:\Apps\gnuplot\bin

gnuplot can be run from the command line of an OS/2 session (preferably a
windowed command session, so that the command line and the displayed graph
can be viewed at the same time), or can be set up as a program object in the
WPS.

If gnuplot is set up as a program object, it can be configured for 'drag and
drop' in the usual way, by specifying '%*' as the program parameter.

Environment settings: see manual (or 'help environment' in gnuplot)

* PATH -- see above

* SET GNUPLOT=<some directory>   
    -- directory containing GNUPLOT.INI file, run at startup.

* SET GNUHELP=<path>\GNUPLOT.GIH
    -- path to gnuplot help file, if not in same directory as gnuplot.exe.
  
* Variable GNUPLOT_LIB may be used to define additional search directories for
  data and command files. The variable may contain a single directory name, or
  a list of directories separated by a platform-specific path separator, i.e.
  ':' on Unix, or ';' on DOS/Windows/OS/2/Amiga platforms. The contents of
  GNUPLOT_LIB are appended to the `loadpath` variable, but not saved with the
  `save` and `save set` commands. See 'help loadpath' for more details.

* Variable GDFONTPATH is the directory where png terminal searches TrueType
  fonts. You should set it to directory where files like arial.ttf exist.
  Usually, it is
	SET GDFONTPATH=C:/PSFONTS
	SET GDFONTPATH=C:/OS2/MDOS/WINOS2/SYSTEM
  The defaults is directory PSFONTS on C:, D:, E:.
  If you wish to set a default font for png, then set it like set via the
  environmental variable GNUPLOT_DEFAULT_GDFONT; however, it is always
  better to use command "set terminal png font 'arial'".

* Variable GNUPLOT_FONTPATH is used by the postscript driver as search path
 for TrueType fonts. Set it to
	SET GNUPLOT_FONTPATH=...as above...

* Variable GNUFITLOG holds the name of a file that saves fit results. The
  default it is fit.log. If the name ends with a "/" or "\", it is treated as a
  directory name, and "fit.log" will be created as a file in that directory.


3) Running gnuplot
==================

gnuplot can be run from the command line of an OS/2 session (preferably a
windowed command session, so that the command line and the displayed graph
can be viewed at the same time), or can be set up as a program object in the
WPS.

gnuplot starts up as a command line session which accepts the usual gnuplot
input. The Presentation Manager window for graphics display is only opened
when the first 'plot' or 'splot' command is entered.

If gnuplot is set up as a program object, it can be configured for 'drag and
drop' in the usual way, by specifying '%*' as the program parameter.

The PM window has facilities for printing the plot, for changing the fonts
used in the plot, and so on. These of course are handled through the usual
PM interface. In addition, you can 'drop' a font onto the window to change
the font.

The PM terminal supports mousing and hotkeys (for very long time actually --
since 1998).

The usual gnuplot commands can also be used to produce output on supported
devices.

Settings and the positions and sizes of the windows can be saved in the file
gnushell.ini. This file is saved in the program's working directory; several
different directories can be set up (as program objects) with different
options, if you wish.

gnuplot can be run with the PM display window maximised: clicking on the
'gnuplot' menu item (or pressing 'ESC') will bring the gnuplot window to the
foreground; it will disappear again when plotting begins.

gnuplot itself communicates with the PM display window (which is a separate
program) through a named pipe. Plotting commands are sent to the PM window
which produces the plot when all commands have been received.

4) gnupmdrv.exe
===============

Gnupmdrv.exe is the 'outboard' driver for gnuplot. It is a multithreaded
PM program.

5) X11 support
==============

This OS/2 distribution also includes the X terminal and its outboard driver
gnuplot_x11.exe. To use it, gnuplot_x11.exe must be somewhere in the PATH.
This has been tested under XFree86-OS/2 and under IBM's PMX; it should work
also with other X servers like Hummingbird. (Untested -- In the latter
cases, it may require x11.dll from the xfree86 distribution is used.)

6) REXX support
===============

gnuplot supports REXX:
Any non-recognised command typed at the gnuplot command line is assumed to
be a Rexx command file. If the file exists it is executed, and all non-Rexx
commands are passed on to the gnuplot environment. (If the file does not
exist, the usual error message is given). Files are searched for in the
current directory, and then in the path.

Note that Rexx maps all command strings to upper case, so gnuplot commands
must be enclosed in quotes. Try 'testrexx' for a simple example.

7) Contents
===========

bin\:
  gnuplot.exe     -- gnuplot executable
  gnupmdrv.exe    -- Presentation Manager terminal driver
  gnuplot_x11.exe -- X11 driver
  gnuplot.ico     -- OS/2 gnuplot icon
  gnuplot.gih     -- gnuplot help file
  gnuplot.INF     -- gnuplot manual in OS/2 inf format ('view gnuplot')
  gnupmdrv.HLP    -- help file for gnupmdrv.exe
  gpsavediff.cmd  -- script to cleanup output of the "save" command
  gpsavediff	  -- as above, but for bash
  startgp.cmd	  -- optional startup script
  testrexx.cmd    -- simple REXX example file
bin\share\PostScript -- prologue files for postscript output

BUGS            -- bug list from source distribution
Copyright       -- gnuplot copyright
README          -- README file from source distribution
README.1st      -- README.1st file from source distribution
README.OS2      -- this file
demo\           -- demo files ('load "all.dem"')
docs\           -- gnuplot manual in html and Postscript format
contrib\        -- few contributed scripts
etc.


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

The gnuplot team, February 4, 2008
