NAME
cpsdecode - Extract shell scripts and data files from Com-
plete PostScript (CPS) file
SYNOPSIS
cpsdecode [ PostScript-file ] [ -n ] [ -v ]
DESCRIPTION
cpsencode [and cpsdecode] provide a convenient way of stor-
ing a UNIX script (or DOS batch file) and data files as part
of the single PostScript plot the script creates. Thus,
given the resulting Complete PostScript (CPS) file one can
recreate the original script and data at a later time.
cpsdecode reads a PostScript file (or stdin if none given)
that previously has been augmented with output from cpsen-
code. It will then extract the embedded data files, undoing
any uuencoding and compression that was performed by cpsen-
code.
-n Dryrun. No files are extracted but we report which
files would be decoded|decompressed and saved to disk.
-v Verbose. Report the progress of decoding the script
and any data files referred to in the script [Default
is silent].
EXAMPLES
Let us say you have a cshell script called Figure_8.csh
which creates the PostScript file Figure_8.ps. Figure_8.csh
operates on several data files in order to make the plot.
You turn this plot file into a Complete PostScript (CPS)
file with the command
cpsencode -v Figure_8.csh >> Figure_8.ps
Alternatively, let that be the last command in the script so
that it is automatically done by the script itself.
To unscramble the CPS file, simply say
cpsdecode -v Figure_8.ps
BUGS
cpsencode assumes good script etiquette so that any tem-
porary files created by your script are removed before
cpsencode is called. Otherwise they will take up unnec-
cesary space in the Complete PostScript (CPS) file. cpsen-
code will have trouble if you script changes directories
with the cd command since filenames become relative to
another directory. Using absolute paths name for files
(starting with /, ~/. or ~user/) is bad practice since other
users may not be able to access those files.
AUTHOR
Paul Wessel, Geology & Geophysics, SOEST, University of
Hawaii, 1680 East-West Road, Honolulu HI 96822, USA.
www.soest.hawaii.edu/wessel.