home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 5 Edit / 05-Edit.zip / dvips583.zip / contrib.zip / dvips / contrib / PSTricks < prev    next >
Text File  |  1998-11-03  |  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 to work with
  239.   the new syntax. See the pst-chan.ges for more information.
  240.  
  241.  
  242. TIPS FOR HACKERS:
  243.  
  244.   The file pstricks.doc contains the documentation and code, using
  245.   Frank Mittelbach's doc system. You can typeset this, if desired,
  246.   by running LaTeX on pst-code.tex. See pst-code.tex for details.
  247.   Don't expect too much from the documentation.
  248.  
  249.  
  250.   If you want to modify the internals of PSTricks, don't use a
  251.   PostScript header file (i.e., don't define \pstheader in pstricks.con)
  252.   and use pstricks.doc as your input file. This allows you to modify
  253.   both the TeX and the PostScript macros.
  254.  
  255.  
  256.   When you don't expect to make more changes for a while, run
  257.   pst-make to generate a new compact macro file and a new
  258.   PostScript header file (if desired). If using a header file,
  259.   don't forget to redefine \pstheader in pstricks.con.
  260.  
  261.   Beware that the internal code in PSTricks is still unstable.
  262.  
  263.  
  264. USING PSTRICKS WITH SUN'S PAGEVIEW/NEWSPRINT/OPENWINDOWS
  265.  
  266.   Sun's PageView/NeWSPrint/OpenWindows have many bugs.
  267.   Workarounds for several known problems of these have been coded into
  268.   PSTricks. A workaround for another bug is described below. Report other
  269.   problems to me.
  270.  
  271.   A bug under Sun's PageView/NeWSprint 3.0 (perhaps fixed in 3.0.1),
  272.   causes arrows to disturb the lines. To see if you have this problem,
  273.   try previewing the section in pst-usr2.ps on axes. Here is a workaround:
  274.  
  275.  
  276.   If using a header, append the  following to pstricks.pro:
  277.  
  278.     /EndArrow { x2 y2 currentpoint grestore angle matrix identmatrix
  279.     rotate transform y1 add exch x1 add exch end } def
  280.  
  281.   Do this in pst-usr1.ps and pst-usr2.ps as well.
  282.  
  283.   If not using a header file, add the following to the end of pstricks.con:
  284.  
  285.  
  286.     \pst@def{EndArrow}<%
  287.       x2 y2 currentpoint grestore
  288.       angle matrix identmatrix rotate transform
  289.       y1 add exch x1 add exch end>
  290.  
  291. CONTRIBUTING TO PSTRICKS
  292.  
  293.   Please send me:
  294.  
  295.  
  296.    * Whatever you can spare.
  297.    * Pretty/interesting/clever things you have created with PSTricks,
  298.      for possible inclusion in the User's Guide or pst-samp.tex. Don't
  299.      be bashful!
  300.    * High level macros for trees/graphs, math diagrams, and linguistic
  301.      diagrams, based on PSTricks' node macros.
  302.    * Any other macros based on PSTricks.
  303.    * Contributions to the Tips and Tricks section of the User's Guide.
  304.    * Reports on +/- experiences with DVI-to-PS converters and previewers.
  305.    * Bug reports.
  306.    * pstricks.doc -- cleaned up, optimized, and documented.
  307.    * To Nepal.
  308.  
  309. PSTRICKS AND SEMINAR.STY
  310.  
  311.   The PSTricks package grew out of macros originally written for the
  312.   seminar.sty package.  seminar.sty is a LaTeX style for slides and notes.
  313.   seminar.sty, combined with pstricks.tex and your favorite macros for
  314.   inclusion of EPS files, make a complete TeX presentation software package.
  315.  
  316.  
  317.   PSTricks v0.92 works with seminar.sty version 0.92, and maybe later
  318.   versions as well. The seminar.sty package is also available from
  319.   Princeton.EDU, and perhaps from wherever else you got PSTricks.
  320.  
  321. ABOUT MULTIDO.TEX:
  322.  
  323.   multido.tex contains a loop macro that is useful for making pictures,
  324.   among other things. See multido.ps for details. multido.tex is required
  325.   by PSTricks \psaxes macro.
  326.  
  327.  
  328.   The complete multido.tex distribution (i.e., including sources) is
  329.   available from the /pub directory at Princeton.EDU.
  330.  
  331.  
  332. ACKNOWLEDGEMENTS:
  333.  
  334.   The basic idea for the node macros is from Emma Pease's tree-dvips.sty.
  335.  
  336.  
  337.   The algorithm in the \pscurve macro was adapted from a C program by
  338.   Shamim Zvonko Mohamed.
  339.   
  340.  
  341.   Thanks to Geoffrey Tobin for helpful comments.
  342.  
  343.  
  344.   The author is thankful to Frank Mittelbach for his  documentation system.
  345.  
  346.  
  347.   Thanks to various contributors to samples.pst.
  348.  
  349.  
  350. DISCLAIMERS:
  351.  
  352.   This is just an elaborate hack. Not for use as children's sleepware.
  353.