PostScript Utilities	        Angus Duggan		        28 January 1993

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.3, 4.1.2, 4.1.1 and 4.0.1, and on HP9000/375 machines under HPUX 7.0
and HPUX 8.0.

FILES

The files contained are:
-rw-r--r--  1 ajcd         1668 Oct 27 18:50 LICENSE
-rw-r--r--  1 ajcd          695 Jan 28 16:15 Makefile
-rw-r--r--  1 ajcd          249 Jan 28 16:10 Manifest
-rw-r--r--  1 ajcd         3755 Jan 28 16:16 README
lrwxrwxrwx  1 ajcd            9 Oct 29 16:16 appledict.ps -> md68.0.ps
-rw-r--r--  1 ajcd         3766 Jan 28 16:11 epsffit.c
-rwxr-xr-x  1 ajcd          362 Apr  7  1992 fixfmps
-rwxr-xr-x  1 ajcd         1329 Jul 17  1992 fixmacps
-rwxr-xr-x  1 ajcd          349 Jan 28 15:48 fixpsditps
-rwxr-xr-x  1 ajcd         1165 Jul 16  1991 fixpspps
-rwxr-xr-x  1 ajcd          261 Nov  4 17:03 fixwfwps
-rwxr-xr-x  1 ajcd          525 Apr  7  1992 fixwpps
-rwxr-xr-x  1 ajcd         4706 Sep  3  1991 getafm
-rw-r--r--  1 ajcd        31021 Oct 27 18:48 md68.0.ps
-rw-r--r--  1 ajcd        35328 Oct 27 18:48 md71.0.ps
-rw-r--r--  1 ajcd           39 Jan 28 16:08 patchlevel.h
-rw-r--r--  1 ajcd         1066 Jul 12  1991 psbook.1
-rw-r--r--  1 ajcd         2094 Jan 28 16:14 psbook.c
-rwxr-xr-x  1 ajcd         2595 Jan 19 14:43 psnup
-rw-r--r--  1 ajcd         2283 Jan 28 15:54 psnup.1
-rw-r--r--  1 ajcd         1776 Dec 16 16:29 psselect.1
-rw-r--r--  1 ajcd         4669 Jan 28 16:14 psselect.c
-rw-r--r--  1 ajcd         3209 Mar 23  1992 pstops.1
-rw-r--r--  1 ajcd         9485 Jan 28 16:14 pstops.c
-rw-r--r--  1 ajcd         5310 Jan 28 16:15 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
fixwfwps (perl) filter to fix Word for Windows documents for psutils
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

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

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.

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%uucp.vidiot@edu.wisc.cs
        Hunter Goatley	        goathunter@wkuvx1.bitnet
        John Interrante         interran@uluru.Stanford.edu

(Apologies to anyone who I have left out.)

