home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / printer / gnuplot.lha / README < prev    next >
Text File  |  1991-01-16  |  12KB  |  319 lines
  1. The GNUPLOT source code and executables may be copied and/or modified
  2. freely as long as the copyright messages are left intact.
  3.  
  4. Compilation instructions are near the end of this file.
  5.  
  6. GNUPLOT has been tested on Sun3's and Sun4's (SunOS 4.0.3), a Pyramid
  7. 90x (OSx 4.0 - ucb 4.3 and att V), a VAX 6410 (VMS 5.2), IBM PC XT's
  8. and AT's (MS-DOS 3.3, Microsoft C 5.10 and Turbo C 2.0)), IRIS 4D/70G
  9. and 4D/25G with MIPS C, and NeXT with gnu C 1.34.  The code is written
  10. with portability in mind.
  11.  
  12. If you have problems, send mail to pixar!info-gnuplot@sun.com.  And
  13. please send any modifications you make so they can be considered for
  14. later releases.
  15.  
  16.  
  17.                      GNUPLOT 2.0 RELEASE NOTES
  18.  
  19. New terminal drivers: ATT6300, Roland DXY800A, EEPIC, emTeX, EPSON LX-800, 
  20. EPSON 60dpi, Fig, HP2648, HPGL, HP LaserJet, Imagen, Kermit-MS Tektronix 
  21. emulator, LaTeX, MCGA, NEC CP6 pinwriter, POSTSCRIPT, Proprinter, Star color 
  22. printer, Tandy DMP-130, Tektronix 410x, SUN, VGA, X11.
  23.  
  24. Additions:
  25.  
  26. Command-line arguments are accepted. They are treated as names of
  27. files containing gnuplot commands. Gnuplot loads them, one by one, and
  28. then exits.
  29.  
  30. Command 'plot' now has a 'title' option to change the information in
  31. the key.  The 'with' option can now specify line type and point type.
  32.  
  33. Command 'pause'.
  34.  
  35. Command 'replot' allows the addition of extra plots. 
  36.  
  37. Command 'save' now saves all the 'set' options, including the last
  38. plot command.
  39.  
  40. Command 'set autoscale' now accepts autoscaling on the x axis for data
  41. files. The default is autoscaling on both axes. 
  42.  
  43. Command 'set noclip' disables clipping of points near the border. 'set
  44. clip' reenables clipping. The default used to be 'clip', and is now
  45. 'noclip'. Clipping has also been extended to clip lines that extend
  46. outside the borders: line plots are now clipped at the plot boundary.
  47. Formerly, the line stopped at the last in-range data point.
  48.  
  49. Numerical labelling at tic marks on x and y axes.  Command 'set
  50. format' allows the format of the tic mark labels to be altered.
  51. Commands 'set xtics' and 'set ytics' allow for alphanumeric labels and
  52. arbitrary tic positions. 
  53.  
  54. Command 'set grid' adds a grid between the tic marks.
  55.  
  56. Improved key gives sample point or line types.  Key can be disabled
  57. with the 'set nokey'. Key can be positioned anywhere. 
  58.  
  59. Command 'set label' allows the placement of arbitrary text labels and
  60. arrows. 
  61.  
  62. Command 'set polar' for polar plots.
  63.  
  64. Command 'set offsets' for reducing the plotted area.  Useful for polar
  65. plots.
  66.  
  67. Command 'set size' scales the displayed size of the plot.
  68.  
  69. Command 'set tics out' causes the tics to be drawn outwards from the
  70. border.  Useful for impulse plots.
  71.  
  72. Command 'set title' places a text label above the plot.
  73.  
  74. Commands 'set xlabel' and 'set ylabel' place text labels on the x and
  75. y axes respectively.  Some terminals will place the y label vertically
  76. upwards on the left of the plot, others place the label horizontally
  77. at the left of the plot.
  78.  
  79. Improved tics on log scales.
  80.  
  81. Extended comments: comments are allowed anywhere reasonable in the
  82. input line, and continue to the end of the input line.
  83.  
  84. Line continuation (with \) is added.
  85.  
  86. Non-interactive use, through redirection or "load" command, is
  87. improved. Error messages expanded to include file name and line
  88. number, and to reprint command line if not interactive.
  89.  
  90. New plotting styles 'linespoints' and 'dots'.
  91.  
  92. Blank lines in data files denote "breaks". In lines and linespoints
  93. plot styles, this breaks the curve being drawn and begins at the next
  94. point, without changing the line or point types.
  95.  
  96. Completely new interactive help system that is similar to VMS help
  97. system. A printed manual can be obtained in LaTeX, troff, or nroff and
  98. is based on the same information as the interactive help.
  99.  
  100. PC version now compiles with the large model so that gnuplot will
  101. compile with the above additions!
  102.  
  103. Bug fixes include:
  104. ------------------
  105. Bug involving functions plotted on a logarithmic x axis is fixed. 
  106.  
  107. Errors inside of loaded files now clean up and close files properly.
  108.  
  109. Numbers of the form xxxxe+nn are now acceptable (+ sign caused error).
  110.  
  111. Tics are now place inside the borders (some were outside).
  112.  
  113. Reverse axes now work properly.
  114.  
  115. Command 'set output ""' used to crash.  
  116.  
  117. VMS was closing stdout, so 'set output' code changed to avoid closing
  118. it.  VMS version of gnuplot now performs a SET TERM/NOWRAP itself.
  119.  
  120. Terminal is now reset before closing output file, changing terminal
  121. type or exiting gnuplot.
  122.  
  123. Several old bugs have been superseded by new ones.
  124.  
  125.  
  126.                             ACKNOWLEDGEMENTS
  127.  
  128. The Unix PC, polar, pause, and offset additions were by John Campbell.
  129. (CAMPBELL@NAUVAX.bitnet)
  130. The Turbo C additions were by Bill Wilson.
  131. (WILSON@NAUVAX.bitnet)
  132. Some of the labelling improvements and combining of these additions 
  133. were by Russell Lang.
  134. (rjl@monu1.cc.monash.oz.au)
  135. The LaTeX driver, the help system, and some of the labelling
  136. improvements were by David Kotz. 
  137. (dfk@cs.duke.edu)
  138. And of course, the vast majority of the program is by Colin Kelley
  139. and Thomas Williams.
  140. (pixar!info-gnuplot@sun.com)
  141.  
  142.  
  143.                       GNUPLOT 1.1 RELEASE NOTES
  144.  
  145. New terminal drivers: AED 512, BBN BitGraph, HP2623, POSTSCRIPT,
  146. Selanar, Vectrix 384.  The PC version now supports Hercules and ATT
  147. 6300 monochrome graphics.  Thanks to those who sent these drivers in.
  148.  
  149. New commands: 'set dummy' and 'show dummy' to select the dummy
  150. variable name; 'replot' to repeat the last 'plot' command.
  151.  
  152. The exclamation point (!) is now accepted as postfix factorial
  153. operator.  The gamma() function is also included, if your C library
  154. has gamma().  See GAMMA below.
  155.  
  156. Logical AND (&&) and OR (||) now short-circuit the way they do in C.
  157. That is, the second && operand is not evaluated if the first is false;
  158. the second || operand is not evaluated if the first is true.  The
  159. ternary operator (?:) also does not evaluate the unused operand.  This
  160. change allows for the definition of recursive functions, e.g. a
  161. synonym for the ! factorial operator:
  162.  
  163.     fact(x) = (x<=1) ? 1 : x*fact(x-1)
  164.  
  165. GNUPLOT now has a much better memory allocation scheme, replacing most
  166. fixed-size arrays with malloc()'d linked lists.  There is no longer
  167. any artificial maximum on the number of simultaneous plots, number of
  168. points in those plots, or the number of user-defined functions or
  169. variables.  All these are limited only by the memory available to
  170. malloc().  This is a big improvement for memory-starved machines like
  171. PDP-11s or PCs.
  172.  
  173. Lines beginning with # (also ! in VMS) are treated as comments.  Only
  174. the $ may now be used for a shell escape in VMS, since ! is a comment.
  175.  
  176. Several old bugs have been superseded by new ones.
  177.  
  178.  
  179.                        PREPROCESSOR #DEFINES
  180.  
  181. These #defines should be checked before compilation:
  182. define      file            note
  183. ------      ----            --------
  184. VFORK       Makefile        define if you've got vfork() system call
  185. GAMMA       Makefile        define if you've got gamma(3)
  186. BCOPY       Makefile        define if your memcpy() is called bcopy()
  187. BZERO       Makefile        define if you have bzero() but not memset()
  188. NOCOPY      Makefile        define if you've don't have a memcpy() by any name
  189. bcopy()     plot.h          define if you've got a memcpy() by some OTHER name
  190.                               (see example in plot.h)
  191. PC          Makefile        define if compiling on a PClone
  192. MSDOS       Makefile        define if compiling under MSDOS;
  193.                               automatically defined by Microsoft C 5.10
  194. HELPFILE    Makefile        name including path of gnuplot.gih file.
  195. VERYLARGE   plot.h          define to be largest coordinate number.
  196. SHELL       plot.h          default shell to spawn if SHELL environment
  197.                               variable not found at run-time
  198.  
  199. Valid TERMFLAGS defines.  These defines are used to include the
  200. various plotting terminals, printers, and protocols that a given version
  201. of gnuplot can access:
  202.  
  203. define         file            note
  204. ------      ----            --------
  205. TERMFLAGS   Makefile        the set of terminals you want, from below
  206.             or term.h
  207.  
  208.    AED         AED 512 and AED 767
  209.    ATT6300     PC with AT&T 6300 graphics
  210.    BITGRAPH    BBN BitGraph
  211.    CGI         SCO CGI
  212.    CORONA      PC with Corona graphics 325
  213.    DXY800A     Roland DXY800A plotter
  214.    EEPIC       EEPIC-extended LaTeX driver, for EEPIC users
  215.    EMTEX       LATEX picture environment with emTeX specials
  216.    EPS60       Epson-style 60-dot per inch printers
  217.    EPSON       Epson LX-800, Star NL-10, NX-1000 and lots of others
  218.    FIG         Fig graphics language (requires object.h from TransFig)
  219.    HERCULES    IBM PC/Clone with Hercules graphics board
  220.    HP2648      HP2648, HP2647
  221.    HP26        HP2623A and maybe others
  222.    HP75        HP7580, and probably other HPs
  223.    HPGL        HP7475 and (hopefully) lots of others
  224.    HPLJII      HP Laserjet II
  225.    IMAGEN      Imagen laser printers (300dpi) (requires -Iterm also)
  226.    IRIS4D      IRIS4D series computer
  227.    KERMIT      MS-Kermit Tektronix 4010 emulator
  228.    LATEX       LATEX picture environment
  229.    NEC         NEC CP6 pinwriter printer
  230.    POSTSCRIPT  Postscript
  231.    PRESCRIBE   Kyocera Laser printer
  232.    QMS         QMS/QUIC laserprinter (Talaris 1200 and others)
  233.    REGIS       ReGis graphics (vt125, vt220, vt240, Gigis...)
  234.    SELANAR     Selanar
  235.    STARC       Star Color Printer
  236.    SUN         Sun Microsystems Workstation
  237.    T410X       Tektronix 4106, 4107, 4109 and 420x terminals
  238.    TANDY60     Tandy DMP-130 series 60-dot per inch graphics
  239.    TEK         Tektronix 4010, and probably others
  240.    UNIXPC      unixpc (ATT 3b1 or ATT 7300)
  241.    UNIXPLOT    unixplot
  242.    V384        Vectrix 384 and tandy color printer
  243.    VTTEK       VT like Tektronix 4010 emulator
  244.    X11         X11R4 window system
  245.  
  246.  
  247. These #defines are defined automatically by various compilers, some
  248. gnuplot routines check these defines to implement features found in the
  249. various environments:
  250.  
  251. define         note
  252. ------      --------
  253. vms         (and VMS) defined by VAX-11 C under VMS.
  254.  
  255. __TURBOC__  defined automatically by Turbo C 2.0
  256. __ZTC__        defined automatically by Zortech C
  257.  
  258.  
  259.                              TO COMPILE
  260.  
  261. under UNIX:  
  262. To compile do:
  263.   Copy one of makefile.unx, makefile.x11 or makefile.3b1,  
  264.   to Makefile, for example
  265.       cp makefile.unx Makefile
  266.   Edit Makefile to change LIBS, #defines, especially HELPDEST and TERMFLAGS
  267.   Edit term.h, to include/exclude terminals
  268.       make
  269.   If that works, try
  270.       make install
  271.  
  272. under VMS:  
  273.  To compile:
  274.      copy makefile.vms makefile.
  275.      make
  276.  Or if you don't have a suitable make:
  277.      @buildvms
  278.  To tell gnuplot where to find the help library:
  279.       $ define gnuplot$help disk:[directory]gnuplot.hlb
  280.   Alternatively (and preferably) put the help in the main system help library.
  281.  
  282. under MSDOS:
  283. Using Microsoft C 5.10.
  284.       copy makefile.msc
  285.       make makefile
  286.  
  287. Using Turbo C 2.0.
  288.       copy makefile.tc
  289.   Edit makefile to change TC, BIN, BGI.
  290.       make
  291.  
  292. The file gnuplot.gih is needed for help on the PC.
  293. If the file gnuplot.gih is not in the default directory, then use:
  294.     set GNUHELP={full path name of gnuplot.gih}
  295.  
  296. The Zortech C++ compiler has been used to compile gnuplot, but
  297. it has not been tested.  The Microsoft MASM and linker are needed.
  298.  
  299.  
  300.                          ENVIRONMENT VARIABLES
  301.  
  302. If the environment variable GNUTERM is found, it is used as the terminal
  303. type. Otherwise, in some cases the variable TERM will be used, or the
  304. hardware may be automatically detected. 
  305.  
  306. The PC version looks for the environment variable GNUPLOT to contain
  307. the name of the directory from which to load the initialization file
  308. GNUPLOT.INI.  See the help on 'start_up' for more information.
  309.  
  310. HOME is examined as a directory where a .gnuplot startup file might be
  311. found. See help on "start-up".
  312.  
  313. If defined, the environment variable GNUHELP is used for the name
  314. of the .gih help file, otherwise HELPFILE (defined in makefile or 
  315. plot.c) is used.
  316.  
  317. The VMS version looks for the logical name GNUPLOT$HELP to locate 
  318. the help library.
  319.