Return to README.os2 CVS log

Up to [local] / OpenXM_contrib / gnuplot / docs / old

Annotation of OpenXM_contrib/gnuplot/docs/old/README.os2, Revision 1.1.1.1

1.1       maekawa     1: GNUPLOT 3.3 for OS/2 v 2.0
                      2: ==========================
                      3:
                      4: 1) Introduction
                      5: ===============
                      6:
                      7: This file discusses the version of GNUPLOT 3.3 implemented for OS/2 2.0.
                      8:
                      9: The command line interface of GNUPLOT is retained, while graphics output is
                     10: plotted in a Presentation Manager Window. The GNUPLOT command line
                     11: appears in another text-mode window on the screen.
                     12:
                     13: The PM window has facilities for printing the plot on the default printer,
                     14: for changing the fonts used on the plot, and for switching between different
                     15: ways of plotting the lines (with colour, as dot/dashed lines, or both).
                     16:
                     17: The command line window offers the usual GNUPLOT interface. Both Unix-style
                     18: and DOS-style editing keys are supported.
                     19:
                     20: The GNUPLOT program was compiled with the emx version of the GNU compiler.
                     21: It supports the shell command (type 'exit' to return to GNUPLOT), can pipe
                     22: datafiles through external commands using '<', and supports command-line
                     23: substitution. It runs the full set of demonstration programs supplied in
                     24: the GNUPLOT source code distribution without problems.
                     25:
                     26: The GNUPLOT 3.3 port to OS/2 differs slightly from the 3.2 port, in that
                     27: the PM driver is started from GNUPLOT, rather than the other way round.
                     28: This means that the program name will have to be changed in the program
                     29: object that runs GNUPLOT, if you install 3.3 over 3.2.
                     30: This change does however make the GNUPLOT command line accessible to programs
                     31: that pipe commands to GNUPLOT.
                     32:
                     33:
                     34: 2) Running GNUPLOT
                     35: ==================
                     36:
                     37: GNUPLOT can be run from the command line of an OS/2 session (preferrably
                     38: a windowed command session, so that the command line and the displayed
                     39: graph can be viewed at the same time), or can be set up as a program object
                     40: in the WPS.
                     41:
                     42: GNUPLOT starts up as a command line session which accepts the usual
                     43: GNUPLOT input. The Presentation Manager window for graphics display
                     44: is only opened when the first 'plot' or 'splot' command is entered.
                     45:
                     46: If GNUPLOT is set up as a program object, it can be configured for
                     47: 'drag and drop' in the usual way, by specifying '%*' as the program
                     48: parameter.
                     49:
                     50: The PM window has facilities for printing the plot, for changing
                     51: the fonts used in the plot, and so on. These of course are handled
                     52: through the usual PM interface.
                     53: In addition, you can 'drop' a font onto the window to change the font.
                     54:
                     55: The usual GNUPLOT commands can also be used to produce output on
                     56: supported devices.
                     57:
                     58: Settings and the positions and sizes of the windows can be saved in
                     59: the file gnushell.ini. This file is saved in the program's working
                     60: directory; several different directories can be set up (as program
                     61: objects) with different options, if you wish.
                     62:
                     63: GNUPLOT can be run with the PM display window maximised: clicking on
                     64: the 'GNUPLOT' menu item (or pressing 'ESC') will bring the GNUPLOT
                     65: window to the foreground; it will disappear again when plotting begins.
                     66:
                     67: GNUPLOT itself communicates with the PM display window (which is a
                     68: separate program) through a named pipe. Plotting commands are sent to
                     69: the PM window which produces the plot when all commands have been received.
                     70:
                     71: 3) The port of GNUPLOT to OS/2
                     72: ==============================
                     73:
                     74: Changes to the code have been kept minimal. Besides the obvious addition
                     75: of the PM driver code, the following are the major changes:
                     76:
                     77: 1) Addition of code in readline.c to map keypad keys to editing functions,
                     78:    to duplicate the MS-DOS mode of editing the command line. (See GNUPLOT manual,
                     79:    page 2.)
                     80:
                     81: The rest of the changes are associated with defining the use of the OS2
                     82: conditional value, and setting system-dependent stuff like names, signal
                     83: handling, and end-of-line handling (LF vs CR+LF).
                     84:
                     85: See the file patches.os2 for changes to the GNUPLOT source.
                     86:
                     87: 4) gnupmdrv.exe
                     88: ===============
                     89:
                     90: Gnupmdrv.exe is the 'outboard' driver for GNUPLOT. It is a multithreaded
                     91: PM program.
                     92:
                     93: Roger Fearick
                     94: fearick@physci.uct.ac.za
                     95: 5 November 1992