CPSDECODE(l)

NAME
cpsdecode - Extract shell scripts and data files from Complete PostScript (CPS) file

SYNOPSIS
cpsdecode [ PostScript-file ] [ -n ] [ -v ]

DESCRIPTION
cpsencode [and cpsdecode] provide a convenient way of storing 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 cpsencode. It will then extract the embedded data files, undoing any uuencoding and compression that was performed by cpsencode.

-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 temporary files created by your script are removed before cpsencode is called. Otherwise they will take up unneccesary space in the Complete PostScript (CPS) file. cpsencode 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.