diff options
Diffstat (limited to 'Build/source/utils/psutils/README')
-rw-r--r-- | Build/source/utils/psutils/README | 245 |
1 files changed, 245 insertions, 0 deletions
diff --git a/Build/source/utils/psutils/README b/Build/source/utils/psutils/README new file mode 100644 index 00000000000..cc2018357d4 --- /dev/null +++ b/Build/source/utils/psutils/README @@ -0,0 +1,245 @@ +PostScript Utilities Angus Duggan 9th March 1997 + +This archive contains some utilities for manipulating PostScript documents. +Page selection and rearrangement are supported, including arrangement into +signatures for booklet printing, and page merging for n-up printing. + +ENVIRONMENT + +These utilities have been compiled and run on Sun-3 and Sun-4 machines under +SunOS Solaris 2.3, Solaris 2.1, 4.1.3, 4.1.2, 4.1.1 and 4.0.1, HP9000/375 +machines under HPUX 7.0 and HPUX 8.0, Sequent Symmetry machines under Dynix +3.1.4 and PTX 3.2.0, IBM RS/6000, VAX/VMS, Decstation 3100 machines under +Ultrix 4.0, SGI 4k5 under Irix 4.1 and 5.2, and x86 machines under MSDOS 6.0 +and Windows NT 3.5 and 4.0. + +FILES + +The files contained are: +-rw-r--r-- 1 angus 2317 Jun 19 1995 LICENSE +-rw-r--r-- 1 angus 2899 Mar 09 09:26 Makefile.bcc +-rw-r--r-- 1 angus 2915 Mar 09 09:26 Makefile.msc +-rw-r--r-- 1 angus 4135 Mar 09 09:26 Makefile.nt +-rw-r--r-- 1 angus 7146 Mar 09 09:26 Makefile.os2 +-rw-r--r-- 1 angus 2895 Mar 09 09:26 Makefile.sc +-rw-r--r-- 1 angus 6913 Mar 09 09:26 Makefile.unix +-rw-r--r-- 1 angus 11345 Mar 09 09:20 README +-rw-r--r-- 1 angus 678 Nov 02 1995 config.h +-rw-r--r-- 1 angus 2373 Jun 19 1995 descrip.mms +-rw-r--r-- 1 angus 5773 Mar 14 1996 epsffit.c +-rw-r--r-- 1 angus 1291 Nov 02 1995 epsffit.man +-rw-r--r-- 1 angus 1236 Nov 02 1995 extractres.man +-rw-r--r-- 1 angus 2780 Nov 02 1995 extractres.pl +-rw-r--r-- 1 angus 561 Nov 02 1995 fixdlsrps.man +-rw-r--r-- 1 angus 1554 Nov 02 1995 fixdlsrps.pl +-rw-r--r-- 1 angus 527 Nov 02 1995 fixfmps.man +-rw-r--r-- 1 angus 556 Nov 02 1995 fixfmps.pl +-rw-r--r-- 1 angus 644 Nov 02 1995 fixmacps.man +-rw-r--r-- 1 angus 2170 Nov 02 1995 fixmacps.pl +-rw-r--r-- 1 angus 556 Nov 02 1995 fixpsditps.man +-rw-r--r-- 1 angus 655 Nov 02 1995 fixpsditps.pl +-rw-r--r-- 1 angus 523 Nov 02 1995 fixpspps.man +-rw-r--r-- 1 angus 1298 Nov 02 1995 fixpspps.pl +-rw-r--r-- 1 angus 531 Nov 02 1995 fixscribeps.man +-rw-r--r-- 1 angus 434 Nov 02 1995 fixscribeps.pl +-rw-r--r-- 1 angus 553 Nov 02 1995 fixtpps.man +-rw-r--r-- 1 angus 663 Nov 02 1995 fixtpps.pl +-rw-r--r-- 1 angus 547 Nov 02 1995 fixwfwps.man +-rw-r--r-- 1 angus 826 Nov 02 1995 fixwfwps.pl +-rw-r--r-- 1 angus 533 Nov 02 1995 fixwpps.man +-rw-r--r-- 1 angus 699 Nov 02 1995 fixwpps.pl +-rw-r--r-- 1 angus 531 Nov 02 1995 fixwwps.man +-rw-r--r-- 1 angus 383 Nov 02 1995 fixwwps.pl +-rw-r--r-- 1 angus 711 Apr 06 1995 getafm.man +-rwxr-xr-x 1 angus 6482 Jun 19 1995 getafm.sh +-rw-r--r-- 1 angus 1107 Nov 02 1995 includeres.man +-rw-r--r-- 1 angus 1435 Nov 02 1995 includeres.pl +-rw-r--r-- 1 angus 1901 Jan 03 1996 maketext +-rw-r--r-- 1 angus 31406 Jun 19 1995 md68_0.ps +-rw-r--r-- 1 angus 35734 Jun 19 1995 md71_0.ps +-rw-r--r-- 1 angus 132 Nov 02 1995 patchlev.h +-rw-r--r-- 1 angus 2875 Nov 02 1995 psbook.c +-rw-r--r-- 1 angus 1156 Nov 02 1995 psbook.man +-rw-r--r-- 1 angus 3201 Nov 02 1995 pserror.c +-rw-r--r-- 1 angus 561 Nov 02 1995 pserror.h +-rw-r--r-- 1 angus 957 Nov 02 1995 psmerge.man +-rw-r--r-- 1 angus 2028 Nov 02 1995 psmerge.pl +-rw-r--r-- 1 angus 10396 Nov 02 1995 psnup.c +-rw-r--r-- 1 angus 4002 Nov 02 1995 psnup.man +-rw-r--r-- 1 angus 5379 Nov 02 1995 psresize.c +-rw-r--r-- 1 angus 1696 Nov 02 1995 psresize.man +-rw-r--r-- 1 angus 6096 Jun 05 1996 psselect.c +-rw-r--r-- 1 angus 2117 Mar 09 09:12 psselect.man +-rw-r--r-- 1 angus 7784 Dec 06 1995 psspec.c +-rw-r--r-- 1 angus 877 Feb 21 1996 psspec.h +-rw-r--r-- 1 angus 5159 Nov 02 1995 pstops.c +-rw-r--r-- 1 angus 4091 Nov 02 1995 pstops.man +-rw-r--r-- 1 angus 9323 Mar 04 13:41 psutil.c +-rw-r--r-- 1 angus 1494 Nov 02 1995 psutil.h +-rwxr-xr-x 1 angus 2685 Jun 19 1995 showchar.sh + + +PROGRAMS + +psbook rearranges pages into signatures +psselect selects pages and page ranges +pstops performs general page rearrangement and selection +psnup put multiple pages per physical sheet of paper +psresize alter document paper size +epsffit fits an EPSF file to a given bounding box + +psselect in modeled after Chris Torek's dviselect program, and pstops is +modeled after Tom Rokicki's dvidvi program. psbook is modeled on my own +dvibook program, which borrows heavily from Chris Torek's dviselect. + +SCRIPTS + +getafm (sh) outputs PostScript to retrieve AFM file from printer +showchar (sh) outputs PostScript to draw a character with metric info +fixdlsrps (perl) filter to fix DviLaser/PS output so that PSUtils works +fixfmps (perl) filter to fix framemaker documents so that psselect etc. work +fixmacps (perl) filter to fix Macintosh documents with saner version of md +fixpsditps (perl) filter to fix Transcript psdit documents to work with PSUtils +fixpspps (perl) filter to fix PSPrint PostScript so that psselect etc. work +fixscribeps (perl) filter to fix Scribe PostScript so that psselect etc. work +fixtpps (perl) filter to fix Troff Tpscript documents +fixwfwps (perl) filter to fix Word for Windows documents for PSUtils +fixwpps (perl) filter to fix WordPerfect documents for PSUtils +fixwwps (perl) filter to fix Windows Write documents for PSUtils +extractres (perl) filter to extract resources from PostScript files +includeres (perl) filter to include resources into PostScript files +psmerge (perl) hack script to merge multiple PostScript files + +INSTALLATION + +UUdecode md71_0.uue and md68_0.uue (if supplied encoded). Copy the most +appropriate makefile to "Makefile", and edit the copy to put in required paths +for BINDIR, SCRIPTDIR, MANDIR, INCLUDEDIR, and PERL. Alter values of MANEXT to +put the manual pages in a different section if desired, change PAPER to set +the default paper size, "make", and "make install". + +BUGS + +The utilities don't check for PS-Adobe-?.? conformance; they assume documents +conform. Utilities need an extra save/restore around whole document on a +SPARCPrinter with NeWSPrint 1.0, because of bugs in the xnews server. + +Bug fixes and suggestions to angus@harlequin.co.uk + +UPDATES + +The definitive archive sites for PSUtils updates are ftp.dcs.ed.ac.uk, in the +directory pub/ajcd/, and ftp.tardis.ed.ac.uk, in the directory users/ajcd. The +latest version will be in psutils.tar.gz older versions may also be in +psutils-*.tar.gz + +NOTE + +This is an interim release; these utilities are currently being re-written +from scratch, with a full DSC-3.0 parser and more extraction, merging, and +inclusion options included. + +WINDOWS USERS + +*Please* make sure that you have selected "Generate DSC Comments" in your +printer driver setup. These utilities need DSC comments to tell where page +boundaries are. + +DVIPS USERS + +The latest versions of dvips have changed the default setting of the DSC +comment flag; you must generate with DSC comments for PSUtils to work. + +ACKNOWLEDGEMENTS + +Bug fixes and suggestions for improvements to PSUtils have come from many +people, including: + + Brian Colfer brianc@labmed.ucsf.edu + Charles A. Finnell finnell@org.mitre.lear + Conrad Kimball cek@com.boeing.sdc + J.W.Hawtin + Jochen Schwarze schwarze@de.isa + Ken Carpenter khc@edu.ksu.eece + Kristian Jorg etxkrjg@se.ericsson.solsta + Larry Weissman larryw@nsr.bioeng.washington.edu + Michael L. Brown brown@wi.extrel.com + Hunter Goatley goathunter@wkuvx1.bitnet + John Interrante interran@uluru.Stanford.edu + Maurizio Cremonesi MAUCREM@imiclvx.earn + Matthew Stier Matthew.Stier@East.Sun.com + Gerry Pratt cca13@seq1.kl.ac.uk + Robert Joop rj@rainbow.in-berlin.de + Johan Vromans jv@mh.nl + Bryan Faubion bryanf@tc.fluke.com + Chris Ritson C.R.Ritson@ncl.ac.uk + Michele Marziani MARZIANI@VAXFE.INFN.IT + Michael I. Schwartz mschwart@diana.cair.du.edu + Chris Ritson C.R.Ritson@newcastle.ac.uk + Joerg Eisenreich + Anreas Borchert borchert@mathematik.uni-ulm.de + Mike Coleman + Dale Scheetz dwarf@polaris.net + Yves Arrouye arrouye@marin.fdn.fr + +(Apologies to anyone who I have left out, it was not intentional.) + +NEWS + +Patchlevel 11 contains some significant enhancements to PSUtils, in +preparation for the eventual release of version 2 (don't hold your breath +waiting for it). These include: + +* Specify paper sizes by name for pstops and psnup. +* Psnup re-written in C to be much more versatile (do any number n-up). +* Epsffit can input broken %%BoundingBox comments which use real numbers. +* Should work on MSDOS and VMS machines as well as Unix. +* Accept more DSC compliant documents (Page labels are better supported). + +Patchlevel 12 was a bug-fix release. + +* Long standing fixmacps bug fixed. +* fixwfwps fixes WFW EPSF files as well as DSC files. +* md71_0.ps and md68_0.ps files were automatically uudecoded. + +Patchlevel 13 contained two new scripts for resource management, and fixes to +the Makefile, page labels, and output chaining. + +* Epsffit can output to a file as well as standard output. +* extractres takes resources out of PostScript files and saves them +* includeres puts resources from a resource library into PostScript files. +* maketext script is now used to do substitutions in Perl scripts and man pages +* page labels in psnup and pstops now show where pages came from. +* page labels in psbook and psselect fixed. +* prologues fixed to be extractable and re-usable +* Makefile doesn't use SUFFIXES any more +* pstops and psnup output can now be chained through each other. +* psresize alters the paper size used by a document +* patchlevel.h shortened to patchlev.h as a concession to MSDOS +* psnup now has -n nup form for compatibility with other n-up programs + +Patchlevel 14 has some minor bug fixes. + +* psselect can take end-relative page ranges +* Makefiles restructured to generate machine specific versions from one source +* MSDOS, Windows NT and OS/2 support +* corrections to psbook output for empty pages when rearranging pstops output + +Patchlevel 15 was a stabilisation release + +* All code converted to ANSI C, improved error and warning procedures +* Portability fixes in the Makefiles +* psnup can take different sized input and output pages +* Minor fixes to fixwpps script +* psselect reversed pages fixed +* maketext and fix scripts updated for Perl 5 + +Patchlevel 16 was a minor bugfix release + +* Piped output and input works correctly in NT + +Patchlevel 17 had some minor bugfixes and improvements + +* Trailer information now put before %%EOF comments if no %%Trailer +* psselect can now add blank pages. +* Piped input works in Linux |