1 01/30/87 process_compout, pco
  2 
  3 Syntax as a command:  pco paths {-control_args}
  4 
  5 
  6 Function:  processes one or more compose output (compout) files to an
  7 online device, or to a magnetic or punched paper tape.  All or portions
  8 of the files may be requested.
  9 
 10 
 11 Arguments:
 12 
 13 paths
 14    are the pathnames of input files to be processed.  The suffix
 15    compout must be the last component of the input file entrynames
 16    (but, see -pathname control argument below); however, the suffix
 17    need not be supplied in the command line.  Output is produced in the
 18    order in which the pathnames are given in the command line.
 19 
 20 
 21 Control arguments:
 22    All control arguments specified in the command line apply to all
 23    input file pathnames given.
 24 -files {n}{,m}
 25    overrides either or both of the default output file factors when
 26    writing output to magnetic or paper tape.  (The default output file
 27    factors are found in the header record of the input file and are set
 28    from data in the device description table.)  n is the maximum number
 29    of pages per file and m is the maximum number of files allowed on
 30    the tape.
 31 -from n, -fm n
 32    starts printed output at page n.  This control argument is mutually
 33    exclusive with the -pages control argument.  (The default value of n
 34    is "1".)  See "Page Numbers" below for a discussion of page numbers.
 35 
 36 
 37 -mode xxx
 38    selects any of the known alternative modes of output or specifies an
 39    entirely new mode.  Built in modes are:  comment, setup, display,
 40    display -long, and dump.
 41 -pages n | n,n ..., -pgs n | n,n ...
 42 -page n | n,n ..., -pg n | n,n ...
 43    specifies a blank-separated list of selected pages to be printed.
 44    Each member of the list must be a single page, {n}, or a range of
 45    pages {n,n}.  The page numbers given must constantly increase
 46    without duplication.  At least one page must be specified.  This
 47    control argument is mutually exclusive with the -from and -to
 48    control arguments.  (The default for this feature is off.)
 49 
 50 
 51 -pages_changed, -pgc
 52    specifies that only addendum pages and those pages containing text
 53    within the range of a change-bar control (from the pages specified
 54    by the "-pages" or "-from" and "-to" control arguments, if given)
 55    are to be printed.
 56 -pathname path, -pn path
 57    is the pathname of an input file even though it may have the
 58    appearance of a numeric parameter or a control argument, or is a
 59    compose bulk output file that does not have the suffix compout.
 60 -stop, -sp
 61    waits for a newline character (ASCII code 012) from the user before
 62    beginning each page of output.  If only a newline is typed, the next
 63    page is printed.  If "q" is typed, the command invocation is
 64    terminated gracefully.  If "r" is typed, the page just printed is
 65    reprinted.  (The default for this feature is off.)
 66 
 67 
 68 -table, -tb
 69    print a table listing information about all selected pages in the
 70    file.  Only a table is produced.  This control argument is mutually
 71    exclusive with all others.
 72 -to n
 73    ends output after page n.  This control argument is mutually
 74    exclusive with the -pages control argument.  (The default value for
 75    n is "$".)
 76 -volume xx
 77    writes the output to the magnetic tape whose volume name is xx.  The
 78    parameters needed for attaching the tape are provided by the device
 79    description table and are contained in the header record of the
 80    compout file.  The attach descriptions in the file header may be
 81    selected or overridden by using the -mode control argument described
 82    above.
 83 
 84 
 85 -wait, -wt
 86    waits for a newline character (ASCII code 012) before beginning the
 87    first page of output to the terminal, but not between pages (see the
 88    -stop control argument above).  (The default for this feature is
 89    off.)
 90 
 91 
 92 Notes:
 93 Page references may be made with !n, $, +n, -n, $-n, or page-id.
 94 '!n' is the n'th physical page in the file.  However, n=0 means 'go
 95      back to the beginning of the file'.  No page is printed for !0.
 96 '$' is the last physical page in the file.
 97 '+n' and '-n' are the nth page relative to the last page referenced.
 98 '$-n' is the n'th relative page from the end of the file.
 99 'page-id' is the page number constructed by compose.  It may be just
100      a simple number or a structured number such as 'B-1', '3-14.2',
101      or 'i-5'.  The page-id MUST be an an EXACT match for that in the
102      document.  There is no less than/greater than checking possible.
103 
104 
105 A page selection could be
106 
107   -pages !1,!5 +19,+2 127.4,127.42 $-1,$
108 
109 This means to process four ranges; the first five pages, then the three
110 pages beginning with the 24th, then the 39 pages beginning with page
111 number 127.4, then the last 2 pages of the file.
112 
113 
114 The -table option prints a table of information about selected pages in
115 a file.  This information includes the physical page number and the
116 actual page-id.  Any 'changed' pages are marked with CHANGED; front
117 pages are marked with the FRONT; intentionally blank pages are marked
118 with BLANK; and missing pages are noted with a comment.  For example:
119 
120    pco flow_sheet -to !7 -table
121 
122    -pathname flow_sheet -pages
123    !1        /*        FRONT     1-5 */
124    !2        /*                  1-6       CHANGED */
125    !3        /*        FRONT     1-6.1     CHANGED */
126    !4        /* BLANK            1-6.2     CHANGED */
127    !5        /*        FRONT     1-7 */
128              /* blank  back not supplied */
129    !6        /*        FRONT     2-1 */
130    !7        /*                  2-2 */
131    ;
132