pageprint(1)                     DG/UX 5.4.2                    pageprint(1)


NAME
       pageprint - select pages from text files

SYNOPSIS
       /usr/lib/lp/bin/pageprint [-T term] [-L num] [-W num]
       [-l num] [-c num] [-o list] [-r int] [-t int] [-v int]
       [-f ] [file] ...

   where:
       term    A terminal type (printer type).
       num     A real number.
       int     An integral number.
       list    A list of page numbers.

DESCRIPTION
       The pageprint filter can be used to select individual pages or a
       range of pages from simple text files.  Options are provided to
       specify the page size, character pitch and line pitch.  Lines that
       exceed the page width are automatically split by inserting newline
       characters.  Formfeeds can optionally be inserted at the end of each
       page to force page alignment.  If no files are specified, or if - is
       given as one of the file arguments, the standard input is read.  The
       results are sent to the standard output.

       Options are:

       -T term
              Use Printer type term.  The default term is printer-80.

       -L num Set the length of the page to num lines.  Also accepts length
              in inches or centimeters (e.g. 10.5i, 24c).  The default
              length depends on the term type.

       -W num Set the width of the page to num columns.  Also accepts width
              in inches or centimeters (e.g. 6.75i, 18.5c).  The default
              width depends on the term type.

       -l num Set lines per inch to num.  Can optionally have an 'i' after
              the value (e.g. 8, 8i).  Also accepts centimeter scale (e.g.
              2.5c means 2 and a half lines per centimeter).  The default
              lines per inch depends on the term type.

       -c num Set characters per inch to num.  Can optionally have an 'i'
              after the value (e.g. 8.5, 8.5i).  Also accepts centimeter
              scale (e.g. 4c means 4 characters per centimeter).  The
              default characters per inch depends on the term type.

       -o list
              Print those pages given in the comma-separated list of page
              numbers.  The list may contain both single numbers and ranges
              in the form N1-N2.  A missing N1 means the lowest numbered
              page; a missing N2 means the highest.

       -r int Select carriage return behavior.  Carriage returns are ignored



Licensed material--property of copyright holder(s)                         1

pageprint(1)                     DG/UX 5.4.2                    pageprint(1)


              if int is 0, cause a return to column 1 if int is 1, and
              generate a newline if int is 2.  The default behavior is a
              return (-r1).

       -t int Assume tabs are set every int columns, starting with the first
              column.  By default, tabs are set every 8 columns.

       -v int Assume vertical tabs are set every int lines, starting with
              the first line.  By default, vertical tabs are set every line.

       -f     Insert a formfeed character at the end of each logical page.


EXAMPLES
       To select pages 2, 6 and 7 of file1 issue the following command:

              pageprint -o2,6,7 file1 | lp

       To set the lines per page to 50, and to select pages 4 through 8 of
       file1 issue the following command:

              pageprint -L50 -o4-8 file1 | lp

       To set the columns per line to 75, and to insert formfeed characters
       at the end of each page of file1 issue the following command:

              pageprint -W75 -f file1 | lp

NOTES
       The pageprint filter is automatically configured into the lp print
       service facility.  In order to use this filter, you should set the
       printer input type to simple.  Other input types that depend on
       simple (e.g. epsonfx) can also be used.  Options to pageprint are
       available through the lp command.  See lp(1) for details.

DIAGNOSTICS
       An exit status of 0 is returned if each file was successfully
       processed.  If an invalid option is given to pageprint, or an error
       occurs during processing, then a error message is printed to the
       standard error.  This message is forwarded to the lp scheduler which
       in turn alerts the user of the problem.

FILES
       /usr/lib/lp/bin/pageprint
       /etc/lp/filter.table

SEE ALSO
       postprint(1), lpfilter(1), lp(1),









Licensed material--property of copyright holder(s)                         2