home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fonts 1 / freshfonts1.bin / bbs / programs / amiga / pastex13.lha / DVIPS / dvips5519.lha / dvips / contrib / PSTricks < prev    next >
Text File  |  1992-11-15  |  12KB  |  353 lines
  1. This file contains the read-me file for the PSTricks package, including
  2. information on how to obtain PSTricks, and a PostScript file that
  3. gives an idea of what the package has to offer.
  4.  
  5.  
  6. ***********************************************************************
  7. ****      "readme" file for PSTricks package, v0.92, 92/10/02      ****
  8. ***********************************************************************
  9.  
  10. COPYRIGHT 1992, by Timothy Van Zandt, tvz@Princeton.EDU
  11.  
  12. COPYING:
  13.  
  14.   Copying of part or all of any file in the PSTricks package
  15.   is allowed under the following conditions only:
  16.  
  17.  
  18.   (1) You may freely distribute unchanged copies of the files. Please
  19.       include the documentation when you do so.
  20.   (2) You may modify a renamed copy of any file, but only for personal
  21.       use or use within an organization.
  22.   (3) You may copy fragments from the files, for personal use or for use
  23.       in a macro package for distribution, as long as credit is given
  24.       where credit is due.
  25.  
  26.   You are NOT ALLOWED to take money for the distribution or use of
  27.   these files or modified versions or fragments thereof, except for
  28.   a nominal charge for copying etc.
  29.  
  30. DESCRIPTION:
  31.  
  32.   pstricks.tex is an extensive collection of PostScript macros that is
  33.   compatible with most TeX macro packages, including Plain TeX , LaTeX
  34.   AmSTeX and AmS-LaTeX. Included are macros for color, graphics, rotation,
  35.   trees and overlays. It has several special features:
  36.  
  37.  
  38.     * There is a wide variety of graphics (picture drawing) macros, with
  39.       a flexible interface and with color support. All lines and outlines
  40.       can be solid, dotted or dashed. Lines and curves can have arrowheads,
  41.       t-bars, brackets or circles on the ends. Regions can be filled
  42.       with solid colors, lines or crosshatch.
  43.     * There is support for polar and cartesian coordinate systems.
  44.     * There are macros for plots and axes.
  45.     * Nested rotations can be made with respect to the physical page.
  46.     * There are flexible node macros, useful for trees, mathematical
  47.       diagrams, and linking information of any kind.
  48.     * There is a powerful loop macro that is useful for making pictures.
  49.     * There are macros for coloring or shading the cells of tables.
  50.  
  51.   PSTricks puts the icing (PostScript) on your cake (TeX)!
  52.  
  53. GETTING PSTRICKS
  54.  
  55.   The PSTricks package is available from the /pub directory at
  56.   Princeton.EDU, and at other archives.
  57.  
  58.  
  59.   A bug list pstricks.bug is kept up-to-date on Princeton.EDU.
  60.  
  61.  
  62.   Send requests to get on or off the PSTricks mailing list to the author.
  63.  
  64. FILES:
  65.  
  66.   Inputs:
  67.     pstricks.tex : The main macro file, for use with a header file.
  68.     pstricks.sty : The same as pstricks.tex, but the .sty extension.
  69.     pstricks.con : The configuration file for pstricks.tex.
  70.     multido.tex  : Contains the \multido macro.
  71.     multido.sty  : Same as multido.tex, but with .sty extension.
  72.  
  73.  
  74.   Contributed:
  75.     pallete.tex  : A palette of RGB colors, by Fred Knight.
  76.     pallete.sty  : The same as pallete.tex, but with .sty extension. 
  77.  
  78.  
  79.   Documentation:
  80.     pst-usr1.ps  : User's Guide, part I.
  81.     pst-usr2.ps  : User's Guide, part II.
  82.     pst-quik.ps  : Quick Reference.
  83.     samples.pst  : A LaTeX file of samples.
  84.     pst-test.tex : A Plain TeX test file.
  85.     changes.pst  : An ASCII list of changes.
  86.     multido.ps   : Documentation for multido.tex.
  87.    
  88.  
  89.   Sources:
  90.     pstricks.doc : Documentation and code for pstricks.tex.
  91.     pst-code.tex : LaTeX file for typesetting pstricks.doc.
  92.     pst-user.tex : LaTeX source for User's Guide.
  93.     defaults.pst : List of parameter defaults, for pst-user.tex.
  94.     tvz-hax.sty  : Macros for pst-user.tex and pst-code.tex.
  95.     npsfont.sty  : Macros for pst-user.tex.
  96.     pst-make.tex : For making pstricks.tex and pstricks.pro from pstricks.doc
  97.    
  98.  
  99.   Other:
  100.     read-me.pst  : This file.
  101.     pstricks.pro : A PostScript prologue (for use with dvips).
  102.  
  103. PRINTING THE USER'S GUIDE:
  104.  
  105.   The User's Guide is distributed in PostScript format as
  106.   pst-usr1.ps and pst-usr2.ps. There is also a quick reference,
  107.   pst-quik.ps.
  108.  
  109.  
  110.   Sun Newsprint/Pageview users: See relevant section below.
  111.  
  112.   For printing on a4 paper: See relevant section below.
  113.  
  114.   The User's Guide uses less than 150K of virtual memory, which is well
  115.   below the minimal PostScript configuration. If you run out of memory,
  116.   try turning off the printer to flush out stuff left in memory
  117.   from previous jobs.
  118.  
  119.  
  120.   Any other problems printing pst-usr1.ps and pst-usr2.ps should be
  121.   reported to me. However, you are on your own if you choose
  122.   to typeset the LaTeX source (pst-user.tex). LaTeXing pst-user.tex
  123.   is NOT a good way to test PSTricks, as there are too many other
  124.   macros involved.
  125.  
  126. PRINTING THE USER'S GUIDE ON A4 PAPER:
  127.  
  128.   You may find that it prints fine as is, but you might want to try making
  129.   the following changes to the .ps files (this stuff is printer dependent):
  130.  
  131.  
  132.   Change these lines:
  133.    
  134.  
  135.        OLD:
  136.        %%BoundingBox: 0 0 612 792
  137.        TeXDict begin 40258431 52099146 1000 300 300 @start /Fa 134[33
  138.        NEW:
  139.        %%BoundingBox: 0 0 596 842
  140.        TeXDict begin 39158280 55380996 1000 300 300 @start /Fa 134[33
  141.  
  142.  
  143.   Add this just before %%EndComments:
  144.  
  145.  
  146.      %%DocumentPaperSizes: a4
  147.     
  148.  
  149.   Add these just before %%EndSetup.
  150.  
  151.  
  152.      %%BeginPaperSize: a4
  153.      a4
  154.      %%EndPaperSize
  155.     
  156.  
  157. INSTALLATION FOR USERS OF ROKICKI'S DVIPS:
  158.  
  159.   1. Put the input files where your TeX looks for inputs.
  160.     
  161.  
  162.   2. Put the file pstricks.pro where dvips looks for headers.
  163.      Probably /usr/lib/tex/ps on unix systems.
  164.    
  165.  
  166.   3. Typeset the LaTeX file samples.pst as a test and to see the samples.
  167.  
  168.  
  169.   3. Have fun!
  170.  
  171. INSTALLATION FOR USERS OF ARBORTEXT'S DVIPS AND TEXTURES:
  172.  
  173.   1. Examine the configuration file pstricks.con. Uncomment
  174.      the \iffalse...\fi surrounding the commands for Rokicki's dvips.
  175.      Comment out the \iffalse...\fi surrounding the commands for
  176.      Arbortext's dvips or Textures.
  177.     
  178.  
  179.   2. If using Textures, decide whether you want to use a header file.
  180.      Uncomment the definition of \pstheader if you do.
  181.     
  182.  
  183.   3. Run pst-make through Plain TeX or LaTeX. This generates
  184.      pstricks.tex and possibly pstricks.pro.
  185.     
  186.  
  187.   4. Follow the instructions above for Rokicki's dvips, using
  188.      the pstricks.tex and pstricks.pro files that you generated
  189.      rather than the ones that came with the package.
  190.     
  191.  
  192. INSTALLATION FOR USERS OF OTHER DVI-TO-PS DRIVERS:
  193.  
  194.   PSTricks should be adaptable to other drivers with similar capabilities.
  195.   Feel free to contact me for help.
  196.  
  197.   1. Use pstricks.doc as your input file for now (rather than pstricks.tex).
  198.  
  199.  
  200.   2. Examine the configuration file pstricks.con. Uncomment
  201.      the \iffalse...\fi surrounding the commands for Rokicki's dvips.
  202.      Try to define the required commands appropriately for you driver,
  203.      but don't use a header file yet (i.e., leave \pstheader
  204.      undefined).
  205.    
  206.  
  207.   3. Run pst-test.tex through Plain TeX until you get things to work
  208.      as well as possible. You may not be able to use all of PSTricks features,
  209.      but if you can define \pstverb and \pstunit, you at least can use
  210.      all the graphics objects.
  211.  
  212.  
  213.   4. Decide whether your driver supports inclusion of a PostScript
  214.      header file. (PSTricks runs much more efficiently with a header,)
  215.      If so, define \pstheader appropriately in pstricks.con.
  216.     
  217.  
  218.   5. Run pst-make through Plain TeX or LaTeX. This generates
  219.      pstricks.tex and possibly pstricks.pro.
  220.  
  221.  
  222.   6. Follow the instructions above for Rokicki's dvips, using
  223.      the pstricks.tex and pstricks.pro files that you generated
  224.      rather than the ones that came with the package.
  225.  
  226. UPGRADING FROM VERSION 0.91:
  227.  
  228.   You need to reinstall the package in its entirety, including
  229.   pstricks.pro. There are a few incompatible changes, described in
  230.   changes.pst. The User's Guide is greatly improved -- check it out.
  231.  
  232.  
  233. UPGRADING FROM VERSION 0.9 OR EARLIER:
  234.  
  235.   Much has changed. You should reinstall the package in its entirety.
  236.   \dbox and \rotate have been removed. \psput has been replaced by \rput,
  237.   with new syntax. However, the command \OldPsput defines \psput to work
  238.   with the old syntax; the command \NewPsput defines \psput t