psutils/psselect.man

   1 .TH PSSELECT 1 "PSUtils Release @RELEASE@ Patchlevel @PATCHLEVEL@"
   2 .SH NAME
   3 psselect \- select pages from a PostScript file
   4 .SH SYNOPSIS
   5 .B psselect
   6 [
   7 .B \-q
   8 ] [
   9 .B \-e
  10 ] [
  11 .B \-o
  12 ] [
  13 .B \-r
  14 ] [
  15 .B \-p\fIpages\fR
  16 ] [
  17 .I pages
  18 ] [
  19 .I infile
  20 [
  21 .I outfile
  22 ] ]
  23 .SH DESCRIPTION
  24 .I Psselect
  25 selects pages from a PostScript document, creating a new PostScript file. The
  26 input PostScript file should follow the Adobe Document Structuring
  27 Conventions.
  28 .PP
  29 The
  30 .I \-e
  31 option selects all of the even pages; it may be used in conjunction with the
  32 other page selection options to select the even pages from a range of pages.
  33 .PP
  34 The
  35 .I \-o
  36 option selects all of the odd pages; it may be used in conjunction with the
  37 other page selection options.
  38 .PP
  39 The
  40 .I \-p\fIpages\fR
  41 option specifies the pages which are to be selected.
  42 .I Pages
  43 is a comma separated list of page ranges, each of which may be a page number,
  44 or a page range of the form \fIfirst\fR-\fIlast\fR. If \fIfirst\fR is omitted,
  45 the
  46 first page is assumed, and if \fIlast\fR is omitted, the last page is assumed.
  47
  48 The prefix character `_' indicates that the page number is relative to the end
  49 of the document, counting backwards. If just this character with no page
  50 number is used, a blank page will be inserted.
  51 .PP
  52 The
  53 .I \-r
  54 option causes
  55 .I psselect
  56 to output the selected pages in reverse order.
  57 .PP
  58 Psselect normally prints the page numbers of the pages rearranged; the
  59 .I \-q
  60 option suppresses this.
  61 .PP
  62 If any of the
  63 .I \-r, \-e,
  64 or
  65 .I \-o
  66 options are specified, the page range must be given with the
  67 .I \-p
  68 option. This is for backwards compatibility with previous versions.
  69
  70 .SH NOTES
  71 The page number given to
  72 .I psselect
  73 is the number of the page counting from the start or end of the file, starting
  74 at one. The actual page number in the document may be different.
  75 .SH AUTHOR
  76 Copyright (C) Angus J. C. Duggan 1991-1995
  77 .SH "SEE ALSO"
  78 @MAN@
  79 .SH TRADEMARKS
  80 .B PostScript
  81 is a trademark of Adobe Systems Incorporated.
  82 .SH BUGS
  83 .I Psselect
  84 does not accept all DSC comments.