psselect(1)

NAME
     psselect - select pages from a PostScript file

SYNOPSIS
     psselect [-e] [-o] [-r] [-ppages]
              [-h] [-D] [infile] [outfile]

DESCRIPTION
     The psselect program allows pages from a PostScript document to be
     extracted into a new PostScript document. Pages may be selected according
     to a number of criteria and the selected pages may be output in reverse
     order. In order for psselect to properly function, the input PostScript
     document must conform to the Adobe Document Structuring Conventions (DSC)
     revision 1.0 or higher.

     If infile is not specified, psselect will read input from the standard
     input. Similarly, if outfile is not specified, the program will write its
     output to the standard output.

     If psselect is specified with no options, it simply copies its standard
     input to standard output.

     -e        The -e option selects only even pages for output.

     -o        The -o option selects only odd pages for output.

     -ppages   The -p option specifies which page numbers are to be output.
               pages is a comma separated list of page number ranges. A page
               range has the form first-last. The following examples
               demonstrate how various page ranges may be specified:


               -p1-5     Select pages 1 thru 5 inclusive
               -p1,5,3   Select pages 1, 3 and 5
               -p-5      Select pages 1 through 5
               -p5-      Select pages 5 thru the end of the document

               Note that there is no space between the switch and its
               argument.

     -r        Specifies that the selected pages should be output in reverse
               order.

     -h        Prints a program usage message to the standard error. This
               usage message also lists the currently supported output
               configurations.

     -D        Specifies verbose output for debugging purposes.
NOTES
     1.   psselect selects pages in the order that they appear in the input
          file.  The program assumes that the first page encountered is page
          one. This may differ from the actual page ordering of the document.

     2.   The -e, -o, and -p switches may be used in combination.  For
          example, specifying the switch -p2-7 and -e will select all even
          numbered pages between two and seven (i.e. 2, 4, and 6). If both the
          -e and -o switches are specified, all pages within the specified
          page range will be selected.

     3.   If psselect is given an unrecognized or incomplete command line
          option switch, it will print a warning message to the standard
          error, ignore the option and continue processing.

     4.   Certain processing options require that psselect create a temporary
          copy of the input file.  This temporary file will be created in the
          directory specified by the TMPDIR environment variable. If that
          variable is not set, the temporary file will be created in /var/tmp.
          There must be sufficient free space in the temporary file directory
          to store a complete copy of the input file or psselect will fail.

TRADEMARKS
     PostScript is a trademark of Adobe Systems, Inc.

SEE ALSO
     PostScript Language Reference Manual - 2nd ed., Adobe Systems, Inc.