diff options
Diffstat (limited to 'Build/source/texk/dvipsk/contrib/PSTricks')
-rw-r--r-- | Build/source/texk/dvipsk/contrib/PSTricks | 352 |
1 files changed, 0 insertions, 352 deletions
diff --git a/Build/source/texk/dvipsk/contrib/PSTricks b/Build/source/texk/dvipsk/contrib/PSTricks deleted file mode 100644 index 5ec089d1947..00000000000 --- a/Build/source/texk/dvipsk/contrib/PSTricks +++ /dev/null @@ -1,352 +0,0 @@ -This file contains the read-me file for the PSTricks package, including -information on how to obtain PSTricks, and a PostScript file that -gives an idea of what the package has to offer. - - -*********************************************************************** -**** "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. |