home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / gp371os2.zip / README < prev    next >
Text File  |  1999-10-21  |  10KB  |  264 lines
  1.  
  2. The Gnuplot Plotting Utility
  3. ****************************
  4.  
  5. Gnuplot is a command-line driven interactive function plotting utility
  6. for UNIX, MSDOS, VMS, and many other platforms.  The software is copyrighted
  7. but freely distributed (i.e., you don't have to pay for it).  It was
  8. originally intended as graphical program which would allow scientists
  9. and students to visualize mathematical functions and data.  Gnuplot
  10. supports many different types of terminals, plotters, and printers
  11. (including many color devices, and pseudo-devices like LaTeX) and is
  12. easily extensible to include new devices.  [ The "GNU" in gnuplot is
  13. NOT related to the Free Software Foundation, the naming is just a
  14. coincidence (and a long story). Thus gnuplot is not covered by the Gnu
  15. copyleft, but rather by its own copyright statement, included in all
  16. source code files.]
  17.  
  18. Gnuplot handles both curves (2 dimensions) and surfaces (3
  19. dimensions). Surfaces can be plotted as a mesh fitting the specified
  20. function, floating in the 3-d coordinate space, or as a contour plot
  21. on the x-y plane. For 2-d plots, there are also many plot styles,
  22. including lines, points, lines with points, error bars, and impulses
  23. (crude bar graphs). Graphs may be labeled with arbitrary labels and
  24. arrows, axes labels, a title, date and time, and a key.  The interface
  25. includes command-line editing and history on most platforms.
  26.  
  27. The new gnuplot user should begin by reading the general information
  28. available by typing `help` after running gnuplot. Then read about the
  29. `plot` command (type `help plot`).  The manual for gnuplot (which is a
  30. nicely formatted version of the on-line help information) can be
  31. printed either with TeX, troff or nroff.  Look at the docs/Makefile
  32. for the appropriate option.
  33.  
  34.  The GNUPLOT source code and executables may be copied and/or modified
  35. freely as long as the copyright messages are left intact.
  36.  
  37. Copyright and Porting
  38. =====================
  39.  
  40.  See the Copyright file for copyright conditions.
  41.  
  42.  See the ChangeLog and docs/old/History.old file for changes to GNUPLOT.
  43.  
  44.  Compilation instructions are in the 0INSTALL file. Porting instructions
  45. are in the 0PORTING file. Compile and testing problems are also in
  46. 0INSTALL.
  47.  
  48.  The code for GNUPLOT was written with portability in mind; however, the
  49. new features incorporated in v3.6 were developed with ANSI-C compliant
  50. compilers, and it was deemed expedient to restrict the development effort
  51. to that environment, with the consequence that systems that could build
  52. previous GNUPLOT releases may require some source modifications.  GNUPLOT
  53. has been tested on the following systems (incomplete), but be aware that
  54. this list is not necessarily up to date with regard to the current version
  55. of GNUPLOT:
  56.  
  57.  o Sun3, sun4c, sun4m, sun4u (SunOS 4.03, SunOS 4.1.x, Solaris 2.5.1/2.6)
  58.  o uVAX 3100 (VMS 5.4, 5.5, 6.0, 6.1)
  59.  o VAX 6410 (VMS 5.2)
  60.  o DECStation 5000/200PXG (ULTRIX V4.1)
  61.  o DEC AXP 3400 (VMS/OpenVMS 1.5, 6.2)
  62.  o DEC AXP 600, A1000A, 3000 (DEC Unix 3.2 4.0, Windows NT 4.0 MSVC++ 4.0)
  63.  o IBM PC and compatibles (MS-DOS 3.3/5.0 BC++3.1/TC++ 1.0 MSC 7.0 DJGPP,
  64.    OS/2 2.x, Linux 2.x SVGA X11/XFree86, Windows95/98, Windows NT 4.0)
  65.  o IBM AIX 3.x and 4.x
  66.  o CBM Amiga (AmigaOS 1.3, 2.x and 3.x, SAS/C 6.2 and better, Aztec C
  67.    beta 5.2a, gcc; Linux 2.x, NetBSD-1.3.x)
  68.  o IRIS 4D/70G and 4D/25G with MIPS C
  69.  o NeXT with gnu C 1.34
  70.  o AT&T 3B1 (version 3.51m with cc and gcc 1.39)
  71.  o Apollo's (DomainOS SR10.3 BSD4.3 with C compiler 68K Rev 6.7(316))
  72.  o HP 300 (m68k) and HP 700 (PA-RISC) (HP-UX 9.x)
  73.  o SGI Challenge and O2 (Irix 6.2, 6.3)
  74.  
  75.  GNUPLOT has not been tested on Pyramid 90x. You can expect that gnuplot
  76. will compile more or less out of the box on any system which has a newer
  77. (2.x) version of the GNU C compiler gcc.
  78.  
  79.  
  80. Help and Bug Reports
  81. ********************
  82.  
  83.  Note that since gnuplot has nothing to do with the GNU project, please
  84. don't ask them for help or information about gnuplot; also, please
  85. don't ask us about GNU stuff.
  86.  
  87.  Please tell us the version and machine on which your bug occurred.
  88.  
  89.  Also, please use meaningful email subjects, and particularly avoid
  90. using a subject of 'help' to info-gnuplot since majordomo bounces
  91. these to the list owner as suspected admin requests.
  92.  
  93. Usenet
  94. ======
  95.  
  96. Additional help can be obtained from the USENET newsgroup
  97.         comp.graphics.apps.gnuplot.
  98. This newsgroup is the first place to ask for routine help.  It is
  99. gatewayed (and thus identical!) to a mailing list
  100.         info-gnuplot@dartmouth.edu.
  101.  We prefer that you read the messages through that newsgroup, to subscribing
  102. to the mailing list.  (If you can read that newsgroup, and are already on the
  103. mailing list, please send a message to majordomo@dartmouth.edu, asking to be
  104. removed from the mailing list.)
  105.  
  106. Mailing Lists
  107. =============
  108.  
  109.  Administrative requests should be sent to
  110.        majordomo@dartmouth.edu.
  111.  
  112. info-gnuplot
  113. ------------
  114.  
  115.  If you cannot obtain a USENET feed and wish to join the above mailing
  116. list (or get yourself off), mail 'subscribe info-gnuplot' to
  117.         majordomo@dartmouth.edu
  118. Please do not ask to sign up if you can read comp.graphics.apps.gnuplot.
  119.  
  120.  The address for mailing to list members is
  121.        info-gnuplot@dartmouth.edu
  122.  
  123. bug-gnuplot
  124. -----------
  125.  
  126.  There is a list specifically for documented bug reports and the
  127. submissions of fixes and modifications,
  128.         bug-gnuplot@dartmouth.edu.
  129.  
  130. To join this list send 'subscribe bug-gnuplot' to majordomo@dartmouth.edu.
  131. Note you do not need to join this list to report bugs. You'd only want
  132. to join if you wish to actively become involved in gnuplot development.
  133.  
  134. "bug-gnuplot" is NOT an appropriate place to ask questions on how to
  135. solve a gnuplot problem or even to report a bug that you haven't
  136. investigated personally.  It is far more likely you'll get the help
  137. you need for this kind of problem from comp.graphics.apps.gnuplot.
  138.  
  139. "bug-gnuplot" is appropriate for turning in a formal bug report
  140. that does not require timely action.  In other words, if you spend
  141. time and investigate a bug, and especially if you fix a bug, then
  142. send it to bug-report and your fix will be considered for the next
  143. release of gnuplot.  Fixes should be in ``diff -c'' format done
  144. against the most current official version of gnuplot or the latest
  145. alpha or beta release of the next version.  All major modifications
  146. should include documentation and a demo file.  Finally, it is
  147. much easier to integrate smaller stepwise modifications rather
  148. than one gigantic diff file which represented months of changes.
  149. All messages to bug-gnuplot (and info-gnuplot, for that matter)
  150. should include the machine you are using, the
  151. operating system and it's version, plotting devices, and the version
  152. of gnuplot that you are running.
  153.  
  154. info-gnuplot-beta
  155. -----------------
  156.  
  157.  The list of those interested in beta-test versions is
  158.        info-gnuplot-beta@dartmouth.edu
  159.  
  160. info-gnuplot-digest
  161. -------------------
  162.  
  163.  There is a daily digest of info-gnuplot available: ask majordomo
  164. to subscribe to info-gnuplot-digest.
  165.  
  166. Where to get Updates to GNUPLOT
  167. ===============================
  168.  
  169. Congratulations on getting this version of GNUPLOT! Unfortunately, it
  170. may not be the most recent version ("you never know where this version
  171. has been!"). You can be sure that it IS the most recent version by
  172. checking one of the official distribution sites, guaranteed to be kept
  173. up to date (of course, if you got this file from one of those sites,
  174. you don't need to check!).
  175.  
  176. To hear automatically about future releases (and other GNUPLOT news),
  177. read the newsgroup; see above.
  178.  
  179. At the time of this writing, the following are the official
  180. distribution sites and transfer instructions. Note that
  181. prep.ai.mit.edu is NOT an official site, and may not be up to date.
  182. Also, comp.sources.misc is usually a month or so behind us.
  183.  
  184. Date: Fri Aug 27 05:21:33 GMT 1993
  185.  
  186.  
  187. Version: 3.7.1
  188.  
  189. In general, GNUPLOT 3.7.1 is available as the file gnuplot-3.7.1.tar.gz.
  190. Because of the numerous changes since version 3.5, no patch files
  191. will be available to bring 3.5 to 3.7. But there is a patch relative
  192. to version 3.7.
  193. (Version 3.6 was skipped because of possible confusion
  194. with the numerous BETA releases.)  It will be made available at web
  195. and ftp sites listed below, along with DOS, MS-Windows 3.1,
  196. Windows 95/98/NT and OS/2 2.0 executables. Amiga binaries will be
  197. made available on Aminet.
  198.  
  199. Also, some sites will have gpdoc_ps.zip which contains
  200. PostScript versions of the manuals and tutorials.
  201.  
  202. Please obtain gnuplot from the site
  203. nearest you.
  204.  
  205.  
  206. NORTH AMERICA:
  207.  
  208.      Anonymous ftp to ftp.gnuplot.vt.edu:
  209.      ftp://ftp.gnuplot.vt.edu/pub/gnuplot/gnuplot-3.7.1.tar.gz
  210.  
  211.      Alternatively, you can use your web browser to get gnuplot
  212.      from the gnuplot web pages at
  213.  
  214.      http://members.theglobe.com/gnuplot/gp371tar.gz
  215.      http://www.geocities.com/SiliconValley/Foothills/6647/gp371tar.gz
  216.  
  217.      Anonymous ftp to ftp.dartmouth.edu. Please try the
  218.      other sites first!
  219.      ftp://ftp.dartmouth.edu/pub/gnuplot/gnuplot-3.7.1.tar.gz
  220.  
  221. [ At time of release, we are not sure whether this service
  222.   is still available. -lh
  223.  
  224.      Users without ftp capability can obtain it through a mail ftp
  225.      server. Email a message to ftpmail@ftp.dartmouth.edu
  226.      whose BODY contains the following: 
  227.  
  228.         open
  229.         cd pub/gnuplot
  230.         mode binary
  231.         get gnuplot-3.7.1.tar.Z
  232.         quit
  233.  
  234.      If you have some problem, you might need to stick 
  235.         reply-to  <your-email-address-here>
  236.      before all the above.
  237.  
  238.      You will receive gnuplot as uuencoded compressed tar file.
  239. ]
  240.  
  241. AUSTRALIA:
  242.  
  243.      From the AARNet Mirror Project:
  244.      ftp://mirror.aarnet.edu.au/pub/gnuplot/
  245.      http://mirror.aarnet.edu.au/pub/gnuplot/
  246.  
  247.      Anonymous ftp to ftp.cc.monash.edu.au:
  248.      ftp://ftp.cc.monash.edu.au/pub/gnuplot/gnuplot-3.7.1.tar.gz
  249.  
  250.  
  251. EUROPE:
  252.  
  253.      Anonymous ftp to ftp.irisa.fr:
  254.      ftp://ftp.irisa.fr/pub/gnuplot/gnuplot-3.7.1.tar.gz
  255.  
  256.      Anonymous ftp to ftp.ucc.ie:
  257.      ftp://ftp.ucc.ie/pub/gnuplot/gnuplot-3.7.1.tar.gz
  258.  
  259.  
  260. ----
  261.  
  262.                                         -Thomas Williams-
  263.                                         -Lars Hecking-
  264.