home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 22 gnu
/
22-gnu.zip
/
gp371os2.zip
/
README.os2
< prev
next >
Wrap
Text File
|
1999-11-07
|
7KB
|
168 lines
gnuplot 3.7.1
Built by Alexander Mai (19991106)
The original Readme.os2 from 3.7.1 is still valid,
except
- the runtime of EMX 09d (fixpack 2) is now required,
- startgp.cmd, a simple startup batch has been added to the distribution
Note that this build incorporates minor, OS/2-specific fixes against the code
base of 3.7.1. They will appear in a possible next version.
GNU readline is NOT used for legal reasons: it is under GPL which
doesn't work out in this project.
################# Original README.os2 from 3.7.0 ##############################
GNUPLOT 3.7 for OS/2
=========================
1) Introduction
===============
This file discusses the version of gnuplot 3.7 implemented for OS/2 using the
pm terminal driver.
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, X11
and GIF terminals (GIF using the gd1.3 libraries which do not use patented code).
Other terminal drivers (emxvesa) are available for OS/2 -- you can obtain
and compile the source distribution if you require these.
2) Installation
===============
This distribution of gnuplot 3.7 was compiled for OS/2
(2.x and above) with emx version 0.9c.
You will require emx.dll (for 0.9c) in order to run it - available from
most large OS/2 archives (look for emxrt.zip).
Unzip the gnuplot distribution into a directory in the PATH.
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.
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 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.
This has been tested under Xfreeos2.
To use it, gnuplot_x11.exe must be somewhere in the PATH.
It is reported that it will work with IBM's PMX or with the
Hummingbird X server if the x11.dll from
the xfree86 distribution is used.
6) REXX support
===============
gnuplot has an experimental version of Rexx support:
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) Enhancements
===============
A patch by Petr Mikulik enables reading the position
of the mouse cursor. This should be available in the contrib
directory of the source distribution (at some stage).
8) Contents
===========
gnuplot.exe -- gnuplot executable
gnupmdrv.exe -- Presentation Manager terminal driver
gnuplot_x11.exe -- X11 driver
gnuplot.ico -- OS/2 gnuplot icon
gnuplot.inf -- gnuplot manual in OS/2 inf format ('view gnuplot')
gnuplot.gih -- gnuplot help file
gnupmdrv.hlp -- help file for gnupmdrv.exe
0BUGS -- bug list from source distribution
0FAQ -- Frequently Asked Questions (and answers)
Copyright -- gnuplot copyright
demo\ -- demo files ('load "all.dem"')
docs\ -- gnuplot manual in html and Postscript format
INSTALL.os2 -- installation hints
README -- README file from source distribution (slightly modified)
README.os2 -- this file
testrexx.cmd -- simple REXX example file
Roger Fearick (with much help from Alexander Mai and others)
January 1999