home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / gp371os2.zip / README.os2 < prev    next >
Encoding:
Text File  |  1999-11-07  |  6.4 KB  |  168 lines
  1. gnuplot 3.7.1
  2. Built by Alexander Mai (19991106)
  3.  
  4. The original Readme.os2 from 3.7.1 is still valid,
  5. except 
  6.   - the runtime of EMX 09d (fixpack 2) is now required,
  7.   - startgp.cmd, a simple startup batch has been added to the distribution
  8.  
  9.  
  10. Note that this build incorporates minor, OS/2-specific fixes against the code
  11. base of 3.7.1. They will appear in a possible next version.
  12. GNU readline is NOT used for legal reasons: it is under GPL which
  13. doesn't work out in this project.
  14.  
  15. ################# Original README.os2 from 3.7.0 ##############################
  16.  
  17.  
  18. GNUPLOT 3.7  for OS/2
  19. =========================
  20.  
  21. 1) Introduction
  22. ===============
  23.  
  24. This file discusses the version of gnuplot 3.7 implemented for OS/2 using the
  25. pm terminal driver.
  26.  
  27. The command line interface of gnuplot is retained, while graphics output is
  28. plotted in a Presentation Manager Window. The gnuplot command line
  29. appears in another text-mode window on the screen.
  30.  
  31. The PM window has facilities for printing the plot on the default printer,
  32. for changing the fonts used on the plot, and for switching between different
  33. ways of plotting the lines (with colour, as dot/dashed lines, or both).
  34.  
  35. Multiple graph windows are supported: try "help term pm".
  36.  
  37. The command line window offers the usual gnuplot interface. Both Unix-style
  38. and DOS-style editing keys are supported.
  39.  
  40. The gnuplot program was compiled with the emx version of the GNU compiler.
  41. It supports the shell command (type 'exit' to return to gnuplot), can pipe
  42. datafiles through external commands using '<', and supports command-line
  43. substitution. It runs the full set of demonstration programs supplied in
  44. the gnuplot source code distribution without problems.
  45.  
  46. Optional terminal drivers included in this binary distribution are for PNG, X11
  47. and GIF terminals (GIF using the gd1.3 libraries which do not use patented code). 
  48. Other terminal drivers (emxvesa) are available for OS/2 -- you can obtain
  49. and compile the source distribution if you require these.
  50.  
  51. 2) Installation
  52. ===============
  53.  
  54. This distribution of gnuplot 3.7 was compiled for OS/2 
  55. (2.x and above) with emx version 0.9c.
  56. You will require emx.dll (for 0.9c) in order to run it - available from
  57. most large OS/2 archives (look for emxrt.zip).
  58.  
  59. Unzip the gnuplot distribution into a directory in the PATH.
  60.  
  61. gnuplot can be run from the command line of an OS/2 session (preferably
  62. a windowed command session, so that the command line and the displayed
  63. graph can be viewed at the same time), or can be set up as a program object
  64. in the WPS.
  65.  
  66. If gnuplot is set up as a program object, it can be configured for
  67. 'drag and drop' in the usual way, by specifying '%*' as the program
  68. parameter.
  69.  
  70.  
  71. 3) Running gnuplot
  72. ==================
  73.  
  74. gnuplot can be run from the command line of an OS/2 session (preferably
  75. a windowed command session, so that the command line and the displayed
  76. graph can be viewed at the same time), or can be set up as a program object
  77. in the WPS.
  78.  
  79. gnuplot starts up as a command line session which accepts the usual
  80. gnuplot input. The Presentation Manager window for graphics display
  81. is only opened when the first 'plot' or 'splot' command is entered.
  82.  
  83. If gnuplot is set up as a program object, it can be configured for
  84. 'drag and drop' in the usual way, by specifying '%*' as the program
  85. parameter.
  86.  
  87. The PM window has facilities for printing the plot, for changing
  88. the fonts used in the plot, and so on. These of course are handled
  89. through the usual PM interface.
  90. In addition, you can 'drop' a font onto the window to change the font.
  91.  
  92. The usual gnuplot commands can also be used to produce output on
  93. supported devices.
  94.  
  95. Settings and the positions and sizes of the windows can be saved in
  96. the file gnushell.ini. This file is saved in the program's working
  97. directory; several different directories can be set up (as program
  98. objects) with different options, if you wish.
  99.  
  100. gnuplot can be run with the PM display window maximised: clicking on
  101. the 'gnuplot' menu item (or pressing 'ESC') will bring the gnuplot
  102. window to the foreground; it will disappear again when plotting begins.
  103.  
  104. gnuplot itself communicates with the PM display window (which is a
  105. separate program) through a named pipe. Plotting commands are sent to
  106. the PM window which produces the plot when all commands have been received.
  107.  
  108. 4) gnupmdrv.exe
  109. ===============
  110.  
  111. Gnupmdrv.exe is the 'outboard' driver for gnuplot. It is a multithreaded
  112. PM program.
  113.  
  114. 5) X11 support
  115. ==============
  116.  
  117. This OS/2 distribution also includes the X terminal and its outboard
  118. driver gnuplot_x11.exe.
  119. This has been tested under Xfreeos2.
  120. To use it, gnuplot_x11.exe must be somewhere in the PATH.
  121. It is reported that it will work with IBM's PMX or with the 
  122. Hummingbird X server if the x11.dll from
  123. the xfree86 distribution is used.
  124.  
  125. 6) REXX support
  126. ===============
  127.  
  128. gnuplot has an experimental version of Rexx support:
  129. Any non-recognised command typed at the gnuplot command line is assumed to
  130. be a Rexx command file. If the file exists it is executed, and
  131. all non-Rexx commands are passed on to the gnuplot environment.
  132. (If the file does not exist, the usual error message is given).
  133. Files are searched for in the current directory, and then in the
  134. path.
  135. Note that Rexx maps all command strings to upper case, so
  136. gnuplot commands must be enclosed in quotes.
  137. Try 'testrexx' for a simple example.
  138.  
  139. 7) Enhancements
  140. ===============
  141.  
  142. A patch by Petr Mikulik enables reading the position
  143. of the mouse cursor. This should be available in the contrib
  144. directory of the source distribution (at some stage).
  145.  
  146. 8) Contents
  147. ===========
  148.  
  149. gnuplot.exe     -- gnuplot executable
  150. gnupmdrv.exe    -- Presentation Manager terminal driver
  151. gnuplot_x11.exe -- X11 driver
  152. gnuplot.ico     -- OS/2 gnuplot icon
  153. gnuplot.inf     -- gnuplot manual in OS/2 inf format ('view gnuplot')
  154. gnuplot.gih     -- gnuplot help file
  155. gnupmdrv.hlp    -- help file for gnupmdrv.exe
  156. 0BUGS           -- bug list from source distribution
  157. 0FAQ            -- Frequently Asked Questions (and answers)
  158. Copyright       -- gnuplot copyright
  159. demo\           -- demo files ('load "all.dem"')
  160. docs\           -- gnuplot manual in html and Postscript format
  161. INSTALL.os2     -- installation hints
  162. README          -- README file from source distribution (slightly modified)
  163. README.os2      -- this file
  164. testrexx.cmd    -- simple REXX example file
  165.  
  166. Roger Fearick (with much help from Alexander Mai and others)
  167. January 1999
  168.