Annotation of OpenXM_contrib/gnuplot/docs/old/README.os2, Revision 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
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>