PostScript Utilities	        Angus Duggan		        7 April 1992

This shar file contains some utilities for manipulating PostScript documents.
Page selection and rearrangement are supported, including arrangement into
signatures for booklet printing, and page merging for 2up/4up/8up/9up printing.

ENVIRONMENT

These utilities have been compiled and run on Sun-3 and Sun-4 machines under
SunOS 4.1.1 and 4.0.1, and on HP9000/375 machines under HPUX 7.0

FILES

The files contained are:
-rw-r--r--  1 ajcd         1665 Mar 25 15:04 LICENSE
-rw-r--r--  1 ajcd          643 Apr  7 19:13 Makefile
-rw-r--r--  1 ajcd         3044 Apr  8 10:36 README
-rw-r--r--  1 ajcd        31017 Jul 16  1991 appledict.ps
-rw-r--r--  1 ajcd         3673 Jul 12  1991 epsffit.c
-rwxr-xr-x  1 ajcd          362 Apr  7 19:51 fixfmps
-rwxr-xr-x  1 ajcd         1082 Apr  7 19:51 fixmacps
-rwxr-xr-x  1 ajcd         1165 Jul 16  1991 fixpspps
-rwxr-xr-x  1 ajcd          525 Apr  7 19:52 fixwpps
-rwxr-xr-x  1 ajcd         4706 Sep  3  1991 getafm
-rw-r--r--  1 ajcd         1066 Jul 12  1991 psbook.1
-rw-r--r--  1 ajcd         1990 Jul 12  1991 psbook.c
-rwxr-xr-x  1 ajcd         2113 Jul 12  1991 psnup
-rw-r--r--  1 ajcd         2152 Sep  5  1991 psnup.1
-rw-r--r--  1 ajcd         1509 Jul 12  1991 psselect.1
-rw-r--r--  1 ajcd         4621 Jul 12  1991 psselect.c
-rw-r--r--  1 ajcd         3209 Mar 23 09:48 pstops.1
-rw-r--r--  1 ajcd         9416 Apr  7 19:27 pstops.c
-rw-r--r--  1 ajcd         5270 Apr  7 19:01 psutil.c
-rw-r--r--  1 ajcd          682 Sep  5  1991 psutil.h
-rwxr-xr-x  1 ajcd         2552 Sep  5  1991 showchar

PROGRAMS

psbook          rearranges pages into signatures
psselect        selects pages and page ranges
pstops          performs general page rearrangement and selection
psnup           uses pstops to merge multiple pages per sheet
epsffit         fits an EPSF file to a given bounding box

psselect in modeled after Chris Torek's dviselect program, and psbook 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
fixfmps  (perl) filter to fix framemaker documents so that psselect etc. work
fixwpps  (perl) filter to fix WordPerfect documents so that psselect etc. work
fixmacps (perl) filter to fix Macintosh documents with saner version of md
fixpspps (perl) filter to fix PSPrint PostScript so that psselect etc. work

INSTALLATION

UUdecode appledict.ps.uue (if supplied encoded), edit Makefile to put in
required CFLAGS (SYSV for System V machines), "make", and install files in
appropriate places.

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 ajcd@dcs.ed.ac.uk
