From: tvz@zandtwerk.Princeton.EDU (Timothy Van Zandt)
Subject: ANNOUNCING: PSTricks V0.92.
Originator: tvz@zandtwerk.Princeton.EDU
Organization: Princeton University
Date: Thu, 8 Oct 1992 12:35:49 GMT

  pstricks.tex is an extensive collection of PostScript macros that is
  compatible with most TeX macro packages, including Plain TeX , LaTeX
  AmSTeX and AmS-LaTeX. Included are macros for color, graphics, rotation,
  trees and overlays.

Version 0.92 of PSTricks is now available in .tar.Z format from
the /pub directory at Princeton.EDU. I have also just submitted
it to the following archives:

   archive.cs.ruu.nl
	 ftp.uni-stuttgart.de
	 niord.shsu.edu
	 TeX.ac.uk
	 ymir.claremont.edu
	 
I am appending the read-me and changes files below.
I highly recommend that active users upgrade as soon as possible.

There are no planned additions or significant changes to the user interface,
but the code needs to be cleaned up for the 1.0 release.

As usual, let me know of problems as they arise.

In a separate posting, I am going to include the PostScript output
from the samples in the User's Guide so that those who are not
familiar with PSTricks can get a flavor of the package.

Tim
---
Timothy Van Zandt   (609)258-4050  tvz@Princeton.EDU (NeXTMail)
Dept. of Economics,  Princeton University,  Princeton, NJ 08544




***********************************************************************
****      "readme" file for PSTricks package, v0.92, 92/10/02      ****
***********************************************************************

COPYRIGHT 1992, by Timothy Van Zandt, tvz@Princeton.EDU

COPYING:

  Copying of part or all of any file in the PSTricks package
  is allowed under the following conditions only:
  
  (1) You may freely distribute unchanged copies of the files. Please
      include the documentation when you do so.
  (2) You may modify a renamed copy of any file, but only for personal
      use or use within an organization.
  (3) You may copy fragments from the files, for personal use or for use
      in a macro package for distribution, as long as credit is given
      where credit is due.

  You are NOT ALLOWED to take money for the distribution or use of
  these files or modified versions or fragments thereof, except for
  a nominal charge for copying etc.

DESCRIPTION:

  pstricks.tex is an extensive collection of PostScript macros that is
  compatible with most TeX macro packages, including Plain TeX , LaTeX
  AmSTeX and AmS-LaTeX. Included are macros for color, graphics, rotation,
  trees and overlays. It has several special features:
  
    * There is a wide variety of graphics (picture drawing) macros, with
      a flexible interface and with color support. All lines and outlines
      can be solid, dotted or dashed. Lines and curves can have arrowheads,
      t-bars, brackets or circles on the ends. Regions can be filled
      with solid colors, lines or crosshatch.
    * There is support for polar and cartesian coordinate systems.
    * There are macros for plots and axes.
    * Nested rotations can be made with respect to the physical page.
    * There are flexible node macros, useful for trees, mathematical
      diagrams, and linking information of any kind.
    * There is a powerful loop macro that is useful for making pictures.
    * There are macros for coloring or shading the cells of tables.
 
  PSTricks puts the icing (PostScript) on your cake (TeX)!

GETTING PSTRICKS

  The PSTricks package is available from the /pub directory at
  Princeton.EDU, and at other archives.
  
  A bug list pstricks.bug is kept up-to-date on Princeton.EDU.
  
  Send requests to get on or off the PSTricks mailing list to the author.

FILES:

  Inputs:
    pstricks.tex : The main macro file, for use with a header file.
    pstricks.sty : The same as pstricks.tex, but the .sty extension.
    pstricks.con : The configuration file for pstricks.tex.
    multido.tex  : Contains the \multido macro.
    multido.sty  : Same as multido.tex, but with .sty extension.
  
  Contributed:
    pallete.tex  : A palette of RGB colors, by Fred Knight.
    pallete.sty  : The same as pallete.tex, but with .sty extension.  

  Documentation:
    pst-usr1.ps  : User's Guide, part I.
    pst-usr2.ps  : User's Guide, part II.
    pst-quik.ps  : Quick Reference.
    samples.pst  : A LaTeX file of samples.
    pst-test.tex : A Plain TeX test file.
    changes.pst  : An ASCII list of changes.
    multido.ps   : Documentation for multido.tex.
    
  Sources:
    pstricks.doc : Documentation and code for pstricks.tex.
    pst-code.tex : LaTeX file for typesetting pstricks.doc.
    pst-user.tex : LaTeX source for User's Guide.
    defaults.pst : List of parameter defaults, for pst-user.tex.
    tvz-hax.sty  : Macros for pst-user.tex and pst-code.tex.
    npsfont.sty  : Macros for pst-user.tex.
    pst-make.tex : For making pstricks.tex and pstricks.pro from pstricks.doc
    
  Other:
    read-me.pst  : This file.
    pstricks.pro : A PostScript prologue (for use with dvips).

PRINTING THE USER'S GUIDE:

  The User's Guide is distributed in PostScript format as
  pst-usr1.ps and pst-usr2.ps. There is also a quick reference,
  pst-quik.ps.
  
  Sun Newsprint/Pageview users: See relevant section below.

  For printing on a4 paper: See relevant section below.

  The User's Guide uses less than 150K of virtual memory, which is well
  below the minimal PostScript configuration. If you run out of memory,
  try turning off the printer to flush out stuff left in memory
  from previous jobs.
  
  Any other problems printing pst-usr1.ps and pst-usr2.ps should be
  reported to me. However, you are on your own if you choose
  to typeset the LaTeX source (pst-user.tex). LaTeXing pst-user.tex
  is NOT a good way to test PSTricks, as there are too many other
  macros involved.

PRINTING THE USER'S GUIDE ON A4 PAPER:

  You may find that it prints fine as is, but you might want to try making
  the following changes to the .ps files (this stuff is printer dependent):
  
  Change these lines:
    
       OLD:
       %%BoundingBox: 0 0 612 792
       TeXDict begin 40258431 52099146 1000 300 300 @start /Fa 134[33
       NEW:
       %%BoundingBox: 0 0 596 842 
       TeXDict begin 39158280 55380996 1000 300 300 @start /Fa 134[33
  
  Add this just before %%EndComments:
  
     %%DocumentPaperSizes: a4
     
  Add these just before %%EndSetup.
  
     %%BeginPaperSize: a4
     a4
     %%EndPaperSize
     
INSTALLATION FOR USERS OF ROKICKI'S DVIPS:

  1. Put the input files where your TeX looks for inputs.
     
  2. Put the file pstricks.pro where dvips looks for headers.
     Probably /usr/lib/tex/ps on unix systems.
    
  3. Typeset the LaTeX file samples.pst as a test and to see the samples.
  
  3. Have fun!

INSTALLATION FOR USERS OF ARBORTEXT'S DVIPS AND TEXTURES:

  1. Examine the configuration file pstricks.con. Uncomment
     the \iffalse...\fi surrounding the commands for Rokicki's dvips.
     Comment out the \iffalse...\fi surrounding the commands for
     Arbortext's dvips or Textures.
     
  2. If using Textures, decide whether you want to use a header file.
     Uncomment the definition of \pstheader if you do.
     
  3. Run pst-make through Plain TeX or LaTeX. This generates
     pstricks.tex and possibly pstricks.pro.
     
  4. Follow the instructions above for Rokicki's dvips, using
     the pstricks.tex and pstricks.pro files that you generated
     rather than the ones that came with the package.
     
INSTALLATION FOR USERS OF OTHER DVI-TO-PS DRIVERS:

  PSTricks should be adaptable to other drivers with similar capabilities.
  Feel free to contact me for help.

  1. Use pstricks.doc as your input file for now (rather than pstricks.tex).
  
  2. Examine the configuration file pstricks.con. Uncomment
     the \iffalse...\fi surrounding the commands for Rokicki's dvips.
     Try to define the required commands appropriately for you driver,
     but don't use a header file yet (i.e., leave \pstheader
     undefined).
    
  3. Run pst-test.tex through Plain TeX until you get things to work
     as well as possible. You may not be able to use all of PSTricks features,
     but if you can define \pstverb and \pstunit, you at least can use
     all the graphics objects.
  
  4. Decide whether your driver supports inclusion of a PostScript
     header file. (PSTricks runs much more efficiently with a header,)
     If so, define \pstheader appropriately in pstricks.con.
     
  5. Run pst-make through Plain TeX or LaTeX. This generates
     pstricks.tex and possibly pstricks.pro.
  
  6. Follow the instructions above for Rokicki's dvips, using
     the pstricks.tex and pstricks.pro files that you generated
     rather than the ones that came with the package.

UPGRADING FROM VERSION 0.91:

  You need to reinstall the package in its entirety, including
  pstricks.pro. There are a few incompatible changes, described in
  changes.pst. The User's Guide is greatly improved -- check it out.
  
UPGRADING FROM VERSION 0.9 OR EARLIER:

  Much has changed. You should reinstall the package in its entirety.
  \dbox and \rotate have been removed. \psput has been replaced by \rput,
  with new syntax. However, the command \OldPsput defines \psput to work
  with the old syntax; the command \NewPsput defines \psput to work with
  the new syntax. See the pst-chan.ges for more information.
  
TIPS FOR HACKERS:

  The file pstricks.doc contains the documentation and code, using
  Frank Mittelbach's doc system. You can typeset this, if desired,
  by running LaTeX on pst-code.tex. See pst-code.tex for details.
  Don't expect too much from the documentation.
  
  If you want to modify the internals of PSTricks, don't use a
  PostScript header file (i.e., don't define \pstheader in pstricks.con)
  and use pstricks.doc as your input file. This allows you to modify
  both the TeX and the PostScript macros.
  
  When you don't expect to make more changes for a while, run
  pst-make to generate a new compact macro file and a new
  PostScript header file (if desired). If using a header file,
  don't forget to redefine \pstheader in pstricks.con.

  Beware that the internal code in PSTricks is still unstable.
  
USING PSTRICKS WITH SUN'S PAGEVIEW/NEWSPRINT/OPENWINDOWS

  Sun's PageView/NeWSPrint/OpenWindows have many bugs.
  Workarounds for several known problems of these have been coded into
  PSTricks. A workaround for another bug is described below. Report other
  problems to me.

  A bug under Sun's PageView/NeWSprint 3.0 (perhaps fixed in 3.0.1),
  causes arrows to disturb the lines. To see if you have this problem,
  try previewing the section in pst-usr2.ps on axes. Here is a workaround:
  
  If using a header, append the  following to pstricks.pro:

    /EndArrow { x2 y2 currentpoint grestore angle matrix identmatrix
    rotate transform y1 add exch x1 add exch end } def

  Do this in pst-usr1.ps and pst-usr2.ps as well.

  If not using a header file, add the following to the end of pstricks.con:
  
    \pst@def{EndArrow}<%
      x2 y2 currentpoint grestore
      angle matrix identmatrix rotate transform
      y1 add exch x1 add exch end>

CONTRIBUTING TO PSTRICKS

  Please send me:
  
   * Whatever you can spare.
   * Pretty/interesting/clever things you have created with PSTricks,
     for possible inclusion in the User's Guide or pst-samp.tex. Don't
     be bashful!
   * High level macros for trees/graphs, math diagrams, and linguistic
     diagrams, based on PSTricks' node macros.
   * Any other macros based on PSTricks.
   * Contributions to the Tips and Tricks section of the User's Guide.
   * Reports on +/- experiences with DVI-to-PS converters and previewers.
   * Bug reports.
   * pstricks.doc -- cleaned up, optimized, and documented.
   * To Nepal.

PSTRICKS AND SEMINAR.STY

  The PSTricks package grew out of macros originally written for the
  seminar.sty package.  seminar.sty is a LaTeX style for slides and notes.
  seminar.sty, combined with pstricks.tex and your favorite macros for
  inclusion of EPS files, make a complete TeX presentation software package.
  
  PSTricks v0.92 works with seminar.sty version 0.92, and maybe later
  versions as well. The seminar.sty package is also available from
  Princeton.EDU, and perhaps from wherever else you got PSTricks.
 
ABOUT MULTIDO.TEX:

  multido.tex contains a loop macro that is useful for making pictures,
  among other things. See multido.ps for details. multido.tex is required
  by PSTricks \psaxes macro.
  
  The complete multido.tex distribution (i.e., including sources) is
  available from the /pub directory at Princeton.EDU.
  
ACKNOWLEDGEMENTS: 

  The basic idea for the node macros is from Emma Pease's tree-dvips.sty.
  
  The algorithm in the \pscurve macro was adapted from a C program by
  Shamim Zvonko Mohamed.
   
  Thanks to Geoffrey Tobin for helpful comments.
  
  The author is thankful to Frank Mittelbach for his  documentation system.
  
  Thanks to various contributors to samples.pst.
  
DISCLAIMERS:

  This is just an elaborate hack. Not for use as children's sleepware.

%%%%%%%%%%%%%%%%%%%%%% END pst-read.me %%%%%%%%%%%%%%%%%%%%%%%%%%%%%




***********************************************************************
****     "CHANGES" file for PSTricks package, v0.92, 92/10/02      ****
***********************************************************************

POLICY:

  The PSTricks package is still preliminary. The features list
  and user interface are unlikely to change much in the short term, but
  the internal code is not stable.

KEY TO THE LISTINGS:

  ! means change that may cause problems with old files.
  + means addition,
  * means change,

VERSION 0.92:

 ! V0.91 had two curve interpolation algorithsm: \pscurve and \psdoodle
   (and variants). These have been merged into a single algorithm retaining
   the names \pscurve, etc. Now the three curvature parameter has three
   numbers:
           num1 num2 num3
   When num3 is 0 (the default), you get the old \psdoodle algorithm, and
   and num1 and num2 act just like the old doodature parameter. When
   num3=-1, you get the old \pscurve algorithm, but positive values are
   usually nicer.
   
   If you have used \pscurve or its variants, the shape of the curves
   will change under 0.92. If you have also used the curvature
   parameter, you will get errors because the old curvature parameter is
   a single number and the new curvature parameter consists of 3 numbers.
   
   If you have used \psdoodle or its variants, then you can either search
   and replace doodle->curve and your use of doodature (which had 2 numbers)
   to curvature (which has 3 number), or you can put the following in the
   customization section of pstricks.con:
     \let\psdoodle\pscurve
     \let\psedoodle\psecurve
     \let\pscdoodle\psccurve
     \def\psset@doodature#1{\psset@curvature{#1 0}}
  
 ! In \psdbleframebox: The inner frame now has \pslinewidth, and the outer
   frame now has width (dblframewidth x \pslinewidth), where dblframewidth is
   a new graphics parameter whose default value is 2.
   
 ! The angle, angleA and angleB parameters no longer apply to
   \ncarc, and the default values have been changed to 0. For
   \ncarc, the angle is now controlled by the arcangle, arcangleA
   and arcangleB paramters. The default is still 8.

 ! \multido has been off-loaded to the file multido.tex. The syntax has
   been changed to make it consistent with \psmultiput and LaTeX's
   \multiput: The variable declarations are now the first argument
   and the number of repetitions are now the second argument. Also,
   for number variables, the initial value and increment must now
   have the same number of digits to the right of the decimal,
   unless the initial value is an integer. There is no * version.
   Instead, the contents is never grouped, and there is even a variant
   that doesn't group the whole macro. See multido.ps, which is distributed
   with PSTricks, for details.

 ! 'diamond', 'diamond*', and 'x' dotstyles are gone. Use dotangle
   parameter instead.
  
 + New dot style: |.
 
 + New graphics objects: \pscustom.
 
 + New box framing macros: \psovalbox, \pscirclebox.
 
 + New box scaling macro: \scaleboxto.
 
 + New nodes: \ovalnode, \circlenode.

 + New node connection: \ncdiagg.
 
 + New loop macro: \multips.

 + New graphics parameters: dotscale, dotangle, dblframewidth.

 + New arrow styles: c and C.

 + \SpecialCoor allows using nodes as coordinates and mixing
   coordinates.
 
 * arrowscale parameter allows non-square scaling.
 
 * Documentation has been greatly improved.
 
 * A bug that caused problems with Arbortext's dvips (previously
   listed in pstricks.bug) was fixed.

 * Memory stats with LaTeX's article style:
     43290 words of memory
      2895 multiletter control sequences

VERSION 0.91:

 * In spite of the many new features, the input file is smaller in bytes,
   and runs significantly faster (at least if used with a header file).
   The macros use up slightly more words of memory, and significantly
   more command sequences. Here are the stats with LaTeX's article
   style:
     41586 words of memory
      2966 multiletter control sequences
       
 ! \dbox and \rotate eliminated.
 
 ! \psput replaced by \rput, with new syntax:
      OLD:  \psput[angle]<ref point>(x,y){stuff}
      NEW:  \rput[ref point]{angle}(x,y){stuff}
   \OldPsput sets up \psput with the old syntax (this may disappear some
   day; keep it in a safe place if you expect to need it for a long time).
   
 ! System for specifying angles for nested rotations with \psput has changed.
      OLD:  p0{angle}, p1{angle}, p2{angle}, etc.
      NEW:  *angle  works like p0{angle}; p1{angle} capability eliminated.
   N, S, E and W have same meaning as before.

 ! enddotsize parameter changed to dotsize.
 
 ! For specifying the origin as the baseline for the \pspicture
   environment, leave the optional argument [] empty (rather than
   [o]).
   
 ! B is not allowed as the y-coordinate when setting the reference point
   in \rput using coordinates. E.g., [Bl] and [B] are OK, but [.3,B] is
   not.
   
 * \sunpatch not needed anymore.
 
 * PostScript header file (if being used) is included at the beginning,
   rather than on demand. 

 + cornersize parameter added, for specifying whether radius of corners
   in \psframe and related box macros is given in relative terms (using
   framearc) or absolute terms (using linearc).
   
 + \psclip and \clipbox macros added.

 + \Cartesian and \Polar commands added, for switching coordinate
   systems.
   
 + border=dim parameter added, for giving appearance of one line
   crossing over another.
 
 + showpoints=bool parameter added. If true, a dot is placed at appropriate 
   coordinates.
   
 + \psdots graphics object added.
 
 + \psarc graphics object added.
 
 + \parabola graphics object added.
 
 + \pscurve, \psccurve, \psecurve, \psdoodle, \psedoodle, and \pscdoodle
   graphics objects added.
 
 + \qline and \qdisk graphics objects added.
 
 + \psplot, \parametericplot and \listplot graphics objects added.
 
 + node connection (e.g., tree) macros added!!


VERSION 0.9:

  Much internal code was changed, and additional features were added.
  See the User's Guide for details.

 ! The syntax of \dline has changed several times.
 
 ! With \multido, the backslash should now be included with variable
   names in the variable declarations.

 * Memory stats with LaTeX's article style:
    40179 words of memory
     2740 multiletter control

%%%%%%%%%%%%%%%%%%%%%% END changes.pst %%%%%%%%%%%%%%%%%%%%%%%%%%%%%



-- 
Timothy Van Zandt   (609)258-4050  tvz@Princeton.EDU (NeXTMail)
Dept. of Economics,  Princeton University,  Princeton, NJ 08544