home *** CD-ROM | disk | FTP | other *** search
/ Mega Top 1 / os2_top1.zip / os2_top1 / APPS / TEKST / PSUTILS / README < prev    next >
Text File  |  1993-11-29  |  8KB  |  177 lines
  1. PostScript Utilities            Angus Duggan               29 November 1993
  2.  
  3. This shar file contains some utilities for manipulating PostScript documents.
  4. Page selection and rearrangement are supported, including arrangement into
  5. signatures for booklet printing, and page merging for n-up printing.
  6.  
  7. ENVIRONMENT
  8.  
  9. These utilities have been compiled and run on Sun-3 and Sun-4 machines under
  10. SunOS 5.1 (Solaris 2.1), 4.1.3, 4.1.2, 4.1.1 and 4.0.1, HP9000/375 machines
  11. under HPUX 7.0 and HPUX 8.0, Sequent Symmetry machines under Dynix 3.1.4
  12. and PTX 3.2.0, IBM RS/6000, VAX/VMS and Decstation 3100 machines under Ultrix
  13. 4.0.
  14.  
  15. FILES
  16.  
  17. The files contained are:
  18. -rw-r--r--  1 angus        1919 Nov 29 18:50 LICENSE
  19. -rw-r--r--  1 angus        6003 Nov 29 17:38 Makefile
  20. -rw-r--r--  1 angus         559 Nov 29 18:47 Manifest
  21. -rw-r--r--  1 angus        8354 Nov 29 20:52 README
  22. -rw-r--r--  1 angus        2083 Nov 29 20:44 descrip.mms
  23. -rw-r--r--  1 angus        5013 Nov 29 17:02 epsffit.c
  24. -rw-r--r--  1 angus        1210 Nov 27 14:28 epsffit.man
  25. -rw-r--r--  1 angus        1159 Nov 27 14:28 extractres.man
  26. -rw-r--r--  1 angus        2687 Nov 19 22:14 extractres.pl
  27. -rw-r--r--  1 angus         507 Nov 27 14:28 fixdlsrps.man
  28. -rw-r--r--  1 angus        1220 Nov 20 00:30 fixdlsrps.pl
  29. -rw-r--r--  1 angus         473 Nov 27 14:28 fixfmps.man
  30. -rw-r--r--  1 angus         431 Oct 27 18:07 fixfmps.pl
  31. -rw-r--r--  1 angus         587 Nov 27 14:28 fixmacps.man
  32. -rw-r--r--  1 angus        2043 Oct 27 18:07 fixmacps.pl
  33. -rw-r--r--  1 angus         502 Nov 27 14:28 fixpsditps.man
  34. -rw-r--r--  1 angus         596 Oct 27 18:07 fixpsditps.pl
  35. -rw-r--r--  1 angus         469 Nov 27 14:28 fixpspps.man
  36. -rw-r--r--  1 angus        1236 Oct 27 18:07 fixpspps.pl
  37. -rw-r--r--  1 angus         499 Nov 27 14:28 fixtpps.man
  38. -rw-r--r--  1 angus         602 Oct 27 18:07 fixtpps.pl
  39. -rw-r--r--  1 angus         493 Nov 27 14:28 fixwfwps.man
  40. -rw-r--r--  1 angus         794 Nov  9 22:57 fixwfwps.pl
  41. -rw-r--r--  1 angus         479 Nov 27 14:28 fixwpps.man
  42. -rw-r--r--  1 angus         669 Oct 27 18:07 fixwpps.pl
  43. -rw-r--r--  1 angus         477 Nov 27 14:29 fixwwps.man
  44. -rw-r--r--  1 angus         364 Oct 27 18:07 fixwwps.pl
  45. -rw-r--r--  1 angus        6124 Oct 27 18:08 getafm
  46. -rw-r--r--  1 angus         711 Nov 27 14:29 getafm.man
  47. -rw-r--r--  1 angus        1035 Nov 27 14:29 includeres.man
  48. -rw-r--r--  1 angus        1392 Nov 19 21:10 includeres.pl
  49. -rwxr-xr-x  1 angus         901 Nov 29 17:02 maketext
  50. -rw-r--r--  1 angus       30969 Oct 27 18:08 md68_0.ps
  51. -rw-r--r--  1 angus       35273 Oct 27 18:08 md71_0.ps
  52. -rw-r--r--  1 angus          40 Oct 27 18:09 patchlev.h
  53. -rw-r--r--  1 angus        2168 Nov 29 17:02 psbook.c
  54. -rw-r--r--  1 angus        1084 Nov 27 14:29 psbook.man
  55. -rw-r--r--  1 angus        8793 Nov 29 17:23 psnup.c
  56. -rw-r--r--  1 angus        3565 Nov 29 20:52 psnup.man
  57. -rw-r--r--  1 angus        4808 Nov 29 20:19 psresize.c
  58. -rw-r--r--  1 angus        1585 Nov 29 20:28 psresize.man
  59. -rw-r--r--  1 angus        5310 Nov 29 17:03 psselect.c
  60. -rw-r--r--  1 angus        1920 Nov 27 14:29 psselect.man
  61. -rw-r--r--  1 angus        7393 Nov 29 20:18 psspec.c
  62. -rw-r--r--  1 angus         602 Oct 27 18:09 psspec.h
  63. -rw-r--r--  1 angus        4386 Nov 29 17:03 pstops.c
  64. -rw-r--r--  1 angus        3895 Nov 27 14:09 pstops.man
  65. -rw-r--r--  1 angus        9697 Nov 29 19:39 psutil.c
  66. -rw-r--r--  1 angus        1071 Nov 27 13:19 psutil.h
  67. -rw-r--r--  1 angus        2567 Oct 27 18:09 showchar
  68.  
  69. PROGRAMS
  70.  
  71. psbook          rearranges pages into signatures
  72. psselect        selects pages and page ranges
  73. pstops          performs general page rearrangement and selection
  74. psnup           put multiple pages per physical sheet of paper
  75. psresize        alter document paper size
  76. epsffit         fits an EPSF file to a given bounding box
  77.  
  78. psselect in modeled after Chris Torek's dviselect program, and pstops is
  79. modeled after Tom Rokicki's dvidvi program. psbook is modeled on my own
  80. dvibook program, which borrows heavily from Chris Torek's dviselect.
  81.  
  82. SCRIPTS
  83.  
  84. getafm   (sh)   outputs PostScript to retrieve AFM file from printer
  85. showchar (sh)   outputs PostScript to draw a character with metric info
  86. fixdlsrps (perl) filter to fix DviLaser/PS output so that PSUtils works
  87. fixfmps  (perl) filter to fix framemaker documents so that psselect etc. work
  88. fixmacps (perl) filter to fix Macintosh documents with saner version of md
  89. fixpsditps (perl) filter to fix Transcript psdit documents to work with PSUtils
  90. fixpspps (perl) filter to fix PSPrint PostScript so that psselect etc. work
  91. fixtpps  (perl) filter to fix Troff Tpscript documents
  92. fixwfwps (perl) filter to fix Word for Windows documents for PSUtils
  93. fixwpps  (perl) filter to fix WordPerfect documents for PSUtils
  94. fixwwps  (perl) filter to fix Windows Write documents for PSUtils
  95. extractres (perl) filter to extract resources from PostScript files
  96. includeres (perl) filter to include resources into PostScript files
  97.  
  98. INSTALLATION
  99.  
  100. UUdecode md71_0.uue and md68_0.uue (if supplied encoded). Edit Makefile to put
  101. in required paths for BINDIR, SCRIPTDIR, MANDIR, INCLUDEDIR, an PERL. Alter
  102. values of MANEXT to put the manual pages in a different section if desired,
  103. change PAPER to set the default paper size, and CFLAGS (-DSYSV for System V
  104. machines, -DMSDOS for Messy-DOS, -DVMS for VMS). "make", and "make install".
  105.  
  106. BUGS
  107.  
  108. The utilities don't check for PS-Adobe-?.? conformance; they assume documents
  109. conform. Utilities need an extra save/restore around whole document on a
  110. SPARCPrinter with NeWSPrint 1.0, because of bugs in the xnews server.
  111.  
  112. Bug fixes and suggestions to angus@harlequin.co.uk
  113.  
  114. NOTE
  115.  
  116. This is an interim release; these utilities are currently being re-written
  117. from scratch, with a full DSC-3.0 parser and more extraction, merging, and
  118. inclusion options included.
  119.  
  120. ACKNOWLEDGEMENTS
  121.  
  122. Bug fixes and suggestions for improvements to PSUtils have come from many
  123. people, including:
  124.  
  125.         Brian Colfer            brianc@labmed.ucsf.edu
  126.         Charles A. Finnell      finnell@org.mitre.lear
  127.         Conrad Kimball          cek@com.boeing.sdc
  128.         J.W.Hawtin              
  129.         Jochen Schwarze         schwarze@de.isa
  130.         Ken Carpenter           khc@edu.ksu.eece
  131.         Kristian Jorg           etxkrjg@se.ericsson.solsta
  132.         Larry Weissman          larryw@nsr.bioeng.washington.edu 
  133.         Michael L. Brown        brown%uucp.vidiot@edu.wisc.cs
  134.         Hunter Goatley            goathunter@wkuvx1.bitnet
  135.         John Interrante         interran@uluru.Stanford.edu
  136.         Maurizio Cremonesi      MAUCREM@imiclvx.earn
  137.         Matthew Stier           Matthew.Stier@East.Sun.com
  138.         Gerry Pratt             cca13@seq1.kl.ac.uk
  139.         Robert Joop             rj@rainbow.in-berlin.de
  140.     Johan Vromans        jv@mh.nl
  141.  
  142. (Apologies to anyone who I have left out.)
  143.  
  144. NEWS
  145.  
  146. Patchlevel 11 contains some significant enhancements to PSUtils, in
  147. preparation for the eventual release of version 2 (don't hold your breath
  148. waiting for it). These include:
  149.  
  150. * Specify paper sizes by name for pstops and psnup.
  151. * Psnup re-written in C to be much more versatile (do any number n-up).
  152. * Epsffit can input broken %%BoundingBox comments which use real numbers.
  153. * Should work on MSDOS and VMS machines as well as Unix.
  154. * Accept more DSC compliant documents (Page labels are better supported).
  155.  
  156. Patchlevel 12 was a bug-fix release.
  157.  
  158. * Long standing fixmacps bug fixed.
  159. * fixwfwps fixes WFW EPSF files as well as DSC files.
  160. * md71_0.ps and md68_0.ps files were automatically uudecoded.
  161.  
  162. Patchlevel 13 contained two new scripts for resource management, and fixes to
  163. the Makefile, page labels, and output chaining.
  164.  
  165. * Epsffit can output to a file as well as standard output.
  166. * extractres takes resources out of PostScript files and saves them
  167. * includeres puts resources from a resource library into PostScript files.
  168. * maketext script is now used to do substitutions in Perl scripts and man pages
  169. * page labels in psnup and pstops are now show where pages came from.
  170. * page labels in psbook and psselect fixed.
  171. * prologues fixed to be extractable and re-usable
  172. * Makefile doesn't use SUFFIXES any more
  173. * pstops and psnup output can now be chained through each other.
  174. * psresize alters the paper size used by a document
  175. * patchlevel.h shortened to patchlev.h as a concession to MSDOS
  176. * psnup now has -n nup form for compatibility with other n-up programs
  177.