Usenet 1994 October/usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso/misc/volume27/psf3/part08

Text File | 1992-01-20 | 40KB | 1,456 lines

Newsgroups: comp.sources.misc
From: [e-mail] (Tony Field)
Subject:  v27i099:  psf3 - Postscript print filter system, v3, Part08/09
Message-ID: <[e-mail]>
X-Md4-Signature: 49f968825a9b6e1a928d85f9f0f47a02
Date: Tue, 21 Jan 1992 01:35:38 GMT
Approved: [e-mail]

Submitted-by: [e-mail] (Tony Field)
Posting-number: Volume 27, Issue 99
Archive-name: psf3/part08
Environment: ISC, SUNOS, SYSVR3, DOS
Supersedes: psf2: Volume 12, Issue 4-9

#! /bin/sh
# This is a shell archive.  Remove anything before this line, then unpack
# it by saving it into a file and typing "sh file".  To overwrite existing
# files, type "sh file -c".  You can also feed this as standard input via
# unshar, or by typing "sh <file", e.g..  If this archive is complete, you
# will see the following message at the end:
#        "End of archive 8 (of 9)."
# Contents:  man/psf.1 man/psf.doc
# Wrapped by ajf@trifid on Sat Jan 18 22:55:51 1992
PATH=/bin:/usr/bin:/usr/ucb ; export PATH
if test -f 'man/psf.1' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'man/psf.1'\"
else
echo shar: Extracting \"'man/psf.1'\" \(17637 characters\)
sed "s/^X//" >'man/psf.1' <<'END_OF_FILE'
X.\" $Id: psf.1,v 3.2 1992/01/19 05:52:13 ajf Exp ajf $
X.TH PSF 1 ""
X.SH NAME
Xpsf \- postscript filter
X
X.SH SYNOPSIS
X
X.B psf
X[
X.B -1|2|4
X] [
X.B -b
X.I n
X] [
X.B -c
X.I n
X] [
X.B -f
X.I n
X] [
X.B -g
X.I type
X] [
X.B -h
X]
X    [
X.B -H
X.I text
X] [
X.B -i
X.I n
X] [
X.B -l
X.I n
X] [
X.B -L
X.I n
X] [
X.B -m
X.I n
X] [
X.B -n
X]
X    [
X.B -p
X.I n
X] [
X] [
X.B -R
X.I n
X] [
X.B -r
X.I n
X] [
X.B -s
X] [
X.B -t
X.I n
X]
X    [
X.B -u
X.I f.def
X] [
X.B -v
X] [
X.B -w
X] [
X.B -x
X]
X    [
X.B -z
X]
X.I file... >out.file
X
X where -1|2|4    print 1,2 or 4 up on a page (default = 1)
X       -b n      select paper bin n
X       -c n      print columns (based on Courier font)
X       -d        allow double sided printing
X       -f n      font number/name (default = 0 = Courier)
X       -g type   page type (default = letter)
X       -h        put file name as header on each page
X       -H text   put text as header on each page
X       -i n      indent left margin n points
X       -l n      print lines per page
X       -L n      page length in lines
X       -m n      indent top margin in points
X       -n        set portrait (narrow) format
X       -p n      set point size to n
X       -R n      remove n lines from beginning of file
X       -r n      remove n lines between pages
X       -s        show page stats (line+column count)
X       -t n      set tabs to n (default = 8)
X       -u f.def  use this printer definition file
X       -v        print pages in reverse
X       -w        set landscape (wide) format
X       -x        draw cross with 4-up page
X       -z        force postscript translate (spooler only)
X       file..    name of files to be printed (or stdin)
X
X   Fonts selection with -f n  (printer dependent)
X       0 Courier               1 Helvetica
X       2 Times-Roman           3 AvantGarde-Book
X       4 Bookman-Light         5 NewCenturySchlbk-Roman
X       6 Palatino-Roman        7 Helvetical-Narrow
X       8 Garamond-Light        9 Korinna-Regular
X       a Helvetica-Condensed   b ZapfChancery-MediumItalic
X.fi
X
X.SH DESCRIPTION
X
X.I Psf
Xaccepts text and filters it to print on postscript printers.
XThe print may be "1-up", "2-up", or "4-up" on a page.
X.I Psf
Xis a general purpose filter for most text and programme listings.  By
Xusing various escape sequences (described below), any portion of the text
Xmay be printed in different fonts and at different point sizes.
X
XIf "letter" sized paper is used, the page is assumed to have 63 lines and
X80 columns wide.  For "legal" sized paper, the effective size is 81 lines
Xby 80 columns.  These dimensions account for the "print region" (excluding
Xmargins) of the page.
X
XThe actual number of print lines and characters per line may be
Xover-ridden by specifing suitable options.
X
XThe most commonly used options are page rotation,
Xsetting point size, column count and line count:
Xall of which allow you to place more printed information on a page.
XAdditional options are for special formatting purposes and may be
Xused if desired.
X
XSpecial formatting for
X.I nroff'ed
Xdocuments and mail box
Xprinting are encapsulated in shell scripts such as
X.I psfnroff
Xand
X.I psfmbox.
XThese scripts hide some of the more complex options.
X
X.SH EXAMPLES
X
XGeneral text may be printed with a command such as:
X.nf
X
X    psf this.file that.fil | lp
X.fi
X
XIf page rotation and print scaling
Xis desired, typical commands are:
X
X.nf
X    psf -                  (show help information)
X    psf my.file my2.fil    (normal print)
X    psf -2  my.file        (print 2 up on a page)
X    psf -2xn my.c          (typical source listing)
X    psf -4x my.file        (print 4 up on a page)
X    psf -p8 my.fil         (print 8 point)
X    psf -l66 -c132 -w a.b  (print 66 lines, 132 cols, landscape)
X.fi
X
X.SH PRINT SIZE
XTwo ways are available to adjust the print size.
XIf the
X.B point size
X(using the
X.B -p
Xoption) is used, choosing a smaller point
Xsize than the default of 12 results in smaller letters and more
Xprinted lines.
XChoosing a larger points size results in larger letters and reduces
Xthe number of printed lines and columns on a page.
X
XA table of various point sizes, page sizes and their associated
Xline and column count is printed with:
X
X.nf
X      psf -s
X.fi.
X
XIf the
X.B column count (-c)
Xor the
X.B line count (-l)
Xis adjusted, the number of printed rows and colums can be changed
Xform the defaults for the paper size.
XFor example, a 132 column, 60 line page in landscape layout
Xmay be selected with:
X
X.nf
X      psf -w -c132 -l60 my.fil | lp
X.fi
X
XIf "unfortunate" row and column counts are selected,
Xthe resulting letters could be squashed or elongated.
X
X.SH OPTIONS
X.TP
X.B \-1\|2\|4
XSpecify the number of logical pages that are to be printed
Xon a physical page.  By default,
X.I psf
Xwill print one logical page per physical page.
X
XIf two logical pages are specified
Xwith
X.B -2
X, then two pages are printed in "landscape" format:
X
X.nf
X      +-----------+-----------+
X      |           |           |
X      |   pg 1    |   pg 2    |
X      |           |           |
X      +-----------+-----------+
X.fi
X
XIf two-up printing in portrait layout is desired, use
X.I -2n
X(i.e. two up, narrow).  On letter sized paper this gives
Xtwo logical pages: each is 80 columns by 126 lines.
XThis layout may be preferred for programme listing.
X
X
XIf four logical pages are specified with
X.B -4
X, then the pages
Xare printed in "portrait format:
X
X.nf
X      +-----------+-----------+
X      |           |           |
X      |   pg 1    |   pg 2    |
X      |           |           |
X      +-----------+-----------+
X      |           |           |
X      |   pg 3    |   pg 4    |
X      |           |           |
X      +-----------+-----------+
X.fi
X
XEach logical page printed in 2-up or 4-up format contains the same number
Xof lines and print columns as if it were printed in 1-up portrait format.
XThe characters may be compressed or expanded horizontally to fill to the
Xlogical page width.  For example, printing with:
X
X.nf
X       psf -4 my.text | lp
X.fi
X
Xcreates four miniature pages, each of which would contain 63 print
Xlines and 80 characters on a line.
X
XPrinting 2-up or 4-up preserves the number of lines on a logical printed
Xpaged. Identical results (in terms of lines and columns on a logical
Xpage) are realized with 1-up, 2-up or 4-up printing.
X
XClipping is performed in 2-up and 4-up printing.  If the line lengths on
Xthe left half of the page exceed the logical page width, the lines will
Xbe truncated.
X
X.TP
X.B \-b n
XSelect paper bin
X.I n.
XIf this option is not specified, the
Xdefault paper bin is used.
X
X.TP
X.B \-c n
XSets the number of print columns on a line.  The character width is based
Xon the Courier font (10 pitch, character width of 7.2 points).  The text
Xis scaled to print the desired number of characters over the entire page
Xwidth.  Setting the character count does NOT alter the number of print
Xlines.
X
XThe option
X.B -c40
Xon letter sized paper
Xhorizontally elongates the characters to twice normal width.
XSimilarily,
X.B -c160
Xon letter size paper compresses the characters
Xto one half normal width.
X
X.TP
X.B \-d
XPrepare for double sided printing.  The resulting print stream
Xis written to
X.I psfbook.psd
Xwhich must be subsequently filtered with
X.I psfdoub.
XRefer to the man page for
X.I psfdoub
Xfor operational details.
X
X.TP
X.B \-f n
XAny of the standard postscript
Xfonts may be selected in lieu
Xof the default Courier.  These are selected from the following
Xtable:
X.nf
X
X         0 Courier
X         1 Helvetica
X         2 Times-Roman
X         3 AvantGarde-Book
X         4 Bookman-Light
X         5 NewCenturySchlbk-Roman
X         6 Palatino-Roman
X         7 Helvetica-Narrow
X         8 Garamond-Light
X         9 Korinna-Regular
X         a Helvetica-Condensed
X         b ZapfChancery-MediumItalic
X.fi
X
XThe target printer may not have exactly these fonts.  To see which
Xfonts are configured, display the psf usage information with:
X
X.nf
X    psf -
X.fi
X
XSince Courier is the only fixed-pitch font, it is usually used for
Xprinting of man pages or programme listings.  The other fonts are
Xproportionally spaced.
X
XThe selected font becomes the new "default font".
X
XThe font may be specified either by the font number or the font name.  For
Xexample, the Courier font could be selected with either option '-f 0'
Xor '-f Courier'.  If the selection is by name, then only a few of the
Xcharacters of the name must be provided.  The NewCenturySchlbk-Roman font
Xcould be selected with the option '-f New'.
X
X.TP
X.B \-g type
XSets the working paper type.  The
X.I type
Xmay be one of
Xthe following with the default number of lines and
Xcolumns (assuming 12 point, 10 pitch Courier characters):
X
X.nf
X        type       lines     columns
X       -------     -----     -------
X       letter       63         80
X       legal        81         80
X       a4           67         78
X       b5           58         67
X.fi
X
XThe number of lines/columns represents the number of possible
Xlines/columns in the printable region of the postscript printer -
Xexclusive of the unprintable margin area.
X
X.TP
X.B \-h
XThe file name, page number and current date are printed at
Xthe top of each page.  The point size is automatically scaled to
Xpermit the specified number of text lines to be printed to account
Xfor the additional two lines consumed by the title line.
X
X.TP
X.B \-H text
XPlace a header (like
X.B -h
X) however use
X.I text
Xrather than the filename.
X
X.TP
X.B \-i n
XIndent the left margin by
X.I n
Xpoints.  This may be used to center
Xthe text in the page.
X
X.TP
X.B \-l n
XSets the number of printed lines per page.  The default is 63 lines for
Xletter sized paper.  If more than 63 lines per page are specified, the
Xpoint size is automatically reduced to accomodate the line count.
X
XThe number of printed lines specified by
X.B -l
Xmay be less than
Xthe number of possible print lines specified by
X.B -L.
XFor example,
Xthe default total number of print lines is 63 (as though you
Xhad specified
X.B -L63
X).  If you used the option
X.B -l20
X, then only
Xthe first 20 lines of the possible 63 would be printed.  A skip to new
Xpage would be performed for the 21st line and the remainder
Xof the page would be blank.
X
X.TP
X.B \-L n
XSpecifies the number of possible print lines available on the page.
XIf
X.B -L
Xis
Xspecified, then the page scale is adjusted to accomodate the
Xline count.   However, only the number of lines specified by the
X.B -l
Xoption will actually print.
X
X.TP
X.B \-m n
XMove the top margin down by
X.I n
Xpoints.  This may be used to center
Xthe text in the page.
X
X.TP
X.B \-n
XThe page is printed in portrait (narrow) format.  This is the default
Xfor 1-up and 4-up printing.
XIf portrait layout is desired for 2-up printing, then the
X.B -n
Xoption must be specified.
X
X.TP
X.B \-p n
XSets the nominal point size to
X.I n
Xpoints.  This is accurate only to "1-up" printing.  If "2-up" or "4-up" or
X"1-up, landscape" printing is desired, the nominal point size is
Xautomatically scaled.
X
XThe selected point size becomes the new "default point size".
X
X.TP
X.B \-R n
Xremoves
X.I n
Xlines from the beginning of the file.
X
X.TP
X.B \-r n
Xremoves
X.I n
Xlines between pages of the file.
X
XUse this option if the text
Xfile has blank lines that must be removed between pages.
XFor example, a typical "accounting" report may print 60 lines
Xand 132 columns
Xof text.  Usually, such reports have two blank lines before
Xthe first printed text on a page  and 6 blank lines to
Xskip to the top of the next page.
X
XTo generate exactly 60 printed lines with psf, the first
Xtwo blank lines should be removed with
X.B -R2
Xand the blank lines between pages removed with
X.B -r6:
X
X.nf
X       psf -R2 -r 6 -l 60 -c 132 account.rpt | lp
X.fi
X
XThe
X.B -r
Xand
X.B -R
Xmay be used together as needed.
X
XIf a skip to new page was caused by a formfeed imbedded in the
Xtext file, then removal of lines is not performed for that page.
X
X.TP
X.B \-s
Xgenerates a display of commonly used page layouts, point sizes
Xand the associated line and column counts for the Courier font.
XThe display looks like:
X
X.nf
X          point size:      8       10       12
X                        lin col  lin col  lin col
X   -- Page Layout --    --- ---  --- ---  --- ---
X    Letter  portrait:    95 120   76  96   63  80
X    Letter landscape:    72 159   57 128   48 106
X     Legal  portrait:   122 120   97  96   81  80
X     Legal landscape:    72 204   57 164   48 136
X        A4  portrait:   101 117   81  94   67  78
X        A4 landscape:    70 170   56 136   46 113
X        B5  portrait:    87 100   69  80   58  67
X        B5 landscape:    60 146   48 117   40  97
X.fi
X
XStatistics for point sizes between 6 and 16 are shown.
X
X.TP
X.B \-t n
XSets the width of the tab stops.  By default this is set to 8.  If the
Xfirst line of a text file contains the string "ta=", then the tab stop
Xwidth is automatically determined from this string.  For example, if the
Xfirst text line contains "/* ta=4 */" then the tab width is automatically
Xset to 4.  This feature is useful if programme source files use a tab
Xspace of 4.
X
X.TP
X.B \-u f.def
Xcauses the specified file to be used rather than the
Xdefault printer definition file
X.I psfprint.def.
X
X.TP
X.B \-v
XPrint pages in reverse order.
X
X.TP
X.B \-w
XThe page is printed in landscape (wide, horizontal format).
XThis is the default for 2-up printing.  If 1-up or 4-up printing is
Xdesired in landscape mode, then the
X.B -w
Xswitch must be specified.
X
X.TP
X.B \-x
XDraws a cross in the to separate the logical pages.  This is
Xeffective for 4-up or 2-up printing.  If 1-up is used,
Xthis option is ignored.
X
X.TP
X.B \-z
XThis option applies to
X.I psflpd
Xuse for print filtering with
X.I lpr
Xor
X.I psffilter
Xused for print filtering with
X.I lp
Xspooling systems.
XAscii to postscript translation is forced, even if the
Xfile is already postscript code.  This
Xallows the printing of a postscript programme.
X
X.SH PSF NOTES
X
X.I Psf
Xfilters text in a "minimally conforming" postscript format (as
Xspecified in the Postscript Language Reference Manual).
X
XIf the text contains escape sequences (possibly generated by
X.I psfbs, psfmail
Xor a text editor), the escape sequences are analyzed to
Xperform limited font and underline selection.  The escape sequences
Xare translated into appropriate postscript code.
X
XThe permitted sequences have the
Xfollowing format:
X.nf
X
X        ^E<command>
X.fi
X
XThe following sequences are recognized:
X
X.nf
X         ^EB     begin bold (in current font family)
X         ^Eb     end bold
X         ^EI     begin italics
X         ^Ei     end italics
X         ^EU     begin underline
X         ^Eu     end underline.
X         ^EFn    begin font 'n' (0..9, a..f)
X         ^Ef     revert to default font
X         ^EPnn   begin point size 'nn' (2 digits)
X         ^Ep     revert to default point size
X         ^E+     skip 1/2 line foreward
X         ^E-     skip 1/2 line backward
X
X         "^E" is a true ctrl-E character, not
X                the ascii text string "^", "E"
X.fi
X
XNote that point sizes with ^EPnn must be two digits such as ^EP07 or ^EP14.
X
XSequences may be nested: bold, italic, underlined would be
Xgenerated with:
X.nf
X
X     ^EB^EI^EUbold, italic and underlined^Eu^Ei^Eb
X.fi
X
XFont numbers are consistent across printers.  However, the available fonts
Xmay be different on different printers.  For a
Xgiven printer, the font numbers available are as specified on the
Xusage menu of
X.I psf
X(generated with "psf -").
X
XAny unrecognized escape sequences are ignored.
X
X.SH PRINTER SPOOLING
X
XIf
X.I psffilter
Xhas been installed as part of the lp/lpsched
X.I lp
Xspooling system,
X.I psf
Xoptions may be passed in the
X.I lp
Xcommand line using the
X.B -o
Xoption for
X.I lp
X:
X
X.nf
X        lp -o"-4xh" this.file that.file
X           --------
X.fi
X
XThe additional options of "banner" and "nobanner"
Xmay be passed to the spooler to print or not print a banner page:
X
X.nf
X        lp -o"nobanner -4xh" this.file that.file
Xor
X        lp -o"banner -4xh" this.file that.file
X.fi
X
XThe spooler system also recognizes the
X.B -z
Xoption to force printing of postscript code.
X
XIf the spooler is
X.I lp/lpsched,
Xthen the spooler binary is normally
X.I psffilter.
XIf the spooler is
X.I lpr/lpd,
Xthe binary is
X.I psflpd.
X
XIf the system's spooler is
X.I lpr/lpd
Xthen options may not be passed to the print filter: usually
Xthe system administrator has configured a number of different
Xprinter names that use different default printing characteristics
Xof
X.I psf.
X
XFor example, printing 2-up on a page could be done with
Xthe command:
X
X    lpr -P2up my.file
X
X.SH ENVIRONMENT
XIf the environment variable
X.B PSFLP
Xis set, then
X.I psf
Xand
X.I psfdoub
Xwill use the value as the name of the output print file.
XIf this variable is not set, the default output file
Xis
X.I stdout.
X
XFor example.
X
X    set PSFLP=prn
X
Xwould be a convenient way to always direct the output
Xof
X.I psf
Xto
Xthe MSDOS printer
X.I prn.
X
XIf the environment variable
X.B PSFDEF
Xis set,
X.I psf
Xuses the set value as the name of the
X.I .def
Xfile to use.
X
XFor example:
X
X    set PSFDEF=/etc/psfprint.def
X
X.SH DIAGNOSTICS
X.nf
Xno alternate bins permitted
Xpaper bin greater than maximum for printer
XDouble sided or book in reverse ordered not supported
XFont number invalid
X        - use 'psf -' to see a list of fonts available
Xcannot create work file
Xcannot allocate enough memory
XCannot open output file
XUnknown file xxxx
XBad psfprint.def file
X        - the psfprint.def file is corrupted.  Contact
X          your systems administrator.
X.fi
X
X.SH BUGS
XDouble sided reverse ordered printing with the
X.B -dv
Xoptions is not supported.
X
X.SH FILES
X.nf
X\/usr/spool/lp/model/psfprint.def:  printer definition file
Xpsfbook.psd:  output file for double sided printing.
X.fi
X
X.SH SEE ALSO
X
Xpsfmail psfbs psfman psfnroff psfmbox psfdoub lp lpadmin lpr lpd
X
X.SH AUTHOR
X
XTony Field.         [e-mail]
END_OF_FILE
if test 17637 -ne `wc -c <'man/psf.1'`; then
    echo shar: \"'man/psf.1'\" unpacked with wrong size!
fi
# end of 'man/psf.1'
fi
if test -f 'man/psf.doc' -a "${1}" != "-c" ; then
  echo shar: Will not clobber existing file \"'man/psf.doc'\"
else
echo shar: Extracting \"'man/psf.doc'\" \(18761 characters\)
sed "s/^X//" >'man/psf.doc' <<'END_OF_FILE'
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X     NAME
X      psf -    postscript filter
X
X
X     SYNOPSIS
X      psf [    -1|2|4 ] [ -b n    ] [ -c n ] [ -f    n ] [ -g type ]    [ -h ]
X          [    -H text    ] [ -i n ] [ -l    n ] [ -L n ] [ -m n ] [    -n ]
X          [    -p n ] [ ] [ -R    n ] [ -r n ] [ -s ] [ -t n ]
X          [    -u f.def ] [ -v    ] [ -w ] [ -x ]
X          [    -z ] file... >out.file
X
X       where -1|2|4       print 1,2 or    4 up on    a page (default    = 1)
X         -b n       select paper    bin n
X         -c n       print columns (based    on Courier font)
X         -d       allow double    sided printing
X         -f n       font    number/name (default = 0 = Courier)
X         -g type   page    type (default =    letter)
X         -h       put file name as header on each page
X         -H text   put text as header on each page
X         -i n       indent left margin n    points
X         -l n       print lines per page
X         -L n       page    length in lines
X         -m n       indent top margin in    points
X         -n       set portrait    (narrow) format
X         -p n       set point size to n
X         -R n       remove n lines from beginning of file
X         -r n       remove n lines between pages
X         -s       show    page stats (line+column    count)
X         -t n       set tabs to n (default = 8)
X         -u f.def  use this printer definition file
X         -v       print pages in reverse
X         -w       set landscape (wide)    format
X         -x       draw    cross with 4-up    page
X         -z       force postscript translate (spooler only)
X         file..       name    of files to be printed (or stdin)
X
X         Fonts selection with -f n    (printer dependent)
X         0 Courier         1 Helvetica
X         2 Times-Roman         3 AvantGarde-Book
X         4 Bookman-Light     5 NewCenturySchlbk-Roman
X         6 Palatino-Roman     7 Helvetical-Narrow
X         8 Garamond-Light     9 Korinna-Regular
X         a Helvetica-Condensed     b ZapfChancery-MediumItalic
X
X
X     DESCRIPTION
X      Psf accepts text and filters it to print on postscript
X      printers.  The print may be "1-up", "2-up", or "4-up"    on a
X      page.    Psf is a general purpose filter    for most text and
X      programme listings.  By using    various    escape sequences
X      (described below), any portion of the    text may be printed in
X      different fonts and at different point sizes.
X
X
X
X     Page 1                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X      If "letter" sized paper is used, the page is assumed to have
X      63 lines and 80 columns wide.     For "legal" sized paper, the
X      effective size is 81 lines by    80 columns.  These dimensions
X      account for the "print region" (excluding margins) of    the
X      page.
X
X      The actual number of print lines and characters per line may
X      be over-ridden by specifing suitable options.
X
X      The most commonly used options are page rotation, setting
X      point    size, column count and line count: all of which    allow
X      you to place more printed information    on a page.  Additional
X      options are for special formatting purposes and may be used
X      if desired.
X
X      Special formatting for nroff'ed documents and    mail box
X      printing are encapsulated in shell scripts such as psfnroff
X      and psfmbox. These scripts hide some of the more complex
X      options.
X
X
X     EXAMPLES
X      General text may be printed with a command such as:
X
X           psf this.file that.fil |    lp
X
X      If page rotation and print scaling is    desired, typical
X      commands are:
X
X          psf -             (show help    information)
X          psf my.file my2.fil    (normal print)
X          psf -2  my.file         (print 2 up on a page)
X          psf -2xn my.c         (typical source listing)
X          psf -4x my.file         (print 4 up on a page)
X          psf -p8 my.fil         (print 8 point)
X          psf -l66 -c132 -w    a.b  (print 66 lines, 132 cols,    landscape)
X
X
X     PRINT SIZE
X      Two ways are available to adjust the print size.  If the
X      point    size (using the    -p option) is used, choosing a smaller
X      point    size than the default of 12 results in smaller letters
X      and more printed lines.  Choosing a larger points size
X      results in larger letters and    reduces    the number of printed
X      lines    and columns on a page.
X
X      A table of various point sizes, page sizes and their
X      associated line and column count is printed with:
X
X        psf -s
X
X      If the column    count (-c) or the line count (-l) is adjusted,
X
X
X
X     Page 2                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X      the number of    printed    rows and colums    can be changed form
X      the defaults for the paper size.  For    example, a 132 column,
X      60 line page in landscape layout may be selected with:
X
X        psf -w -c132 -l60 my.fil | lp
X
X      If "unfortunate" row and column counts are selected, the
X      resulting letters could be squashed or elongated.
X
X
X     OPTIONS
X      -124 Specify the number of logical pages that    are to be
X           printed on a physical page.  By default,    psf will print
X           one logical page    per physical page.
X
X           If two logical pages are    specified with -2 , then two
X           pages are printed in "landscape"    format:
X
X             +-----------+-----------+
X             |         |         |
X             |     pg 1     |   pg    2    |
X             |         |         |
X             +-----------+-----------+
X
X           If two-up printing in portrait layout is    desired, use
X           -2n (i.e. two up, narrow).  On letter sized paper this
X           gives two logical pages:    each is    80 columns by 126
X           lines.  This layout may be preferred for    programme
X           listing.
X
X
X           If four logical pages are specified with    -4 , then the
X           pages are printed in "portrait format:
X
X             +-----------+-----------+
X             |         |         |
X             |     pg 1     |   pg    2    |
X             |         |         |
X             +-----------+-----------+
X             |         |         |
X             |     pg 3     |   pg    4    |
X             |         |         |
X             +-----------+-----------+
X
X           Each logical page printed in 2-up or 4-up format
X           contains    the same number    of lines and print columns as
X           if it were printed in 1-up portrait format.  The
X           characters may be compressed or expanded    horizontally
X           to fill to the logical page width.  For example,
X           printing    with:
X
X              psf -4 my.text | lp
X
X
X
X     Page 3                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X           creates four miniature pages, each of which would
X           contain 63 print    lines and 80 characters    on a line.
X
X           Printing    2-up or    4-up preserves the number of lines on
X           a logical printed paged.    Identical results (in terms of
X           lines and columns on a logical page) are    realized with
X           1-up, 2-up or 4-up printing.
X
X           Clipping    is performed in    2-up and 4-up printing.     If
X           the line    lengths    on the left half of the    page exceed
X           the logical page    width, the lines will be truncated.
X
X
X      -b n Select paper bin    n. If this option is not specified,
X           the default paper bin is    used.
X
X
X      -c n Sets the    number of print    columns    on a line.  The
X           character width is based    on the Courier font (10    pitch,
X           character width of 7.2 points).    The text is scaled to
X           print the desired number    of characters over the entire
X           page width.  Setting the    character count    does NOT alter
X           the number of print lines.
X
X           The option -c40 on letter sized paper horizontally
X           elongates the characters    to twice normal    width.
X           Similarily, -c160 on letter size    paper compresses the
X           characters to one half normal width.
X
X
X      -d   Prepare for double sided    printing.  The resulting print
X           stream is written to psfbook.psd    which must be
X           subsequently filtered with psfdoub. Refer to the    man
X           page for    psfdoub    for operational    details.
X
X
X      -f n Any of the standard postscript fonts may    be selected in
X           lieu of the default Courier.  These are selected    from
X           the following table:
X
X            0 Courier
X            1 Helvetica
X            2 Times-Roman
X            3 AvantGarde-Book
X            4 Bookman-Light
X            5 NewCenturySchlbk-Roman
X            6 Palatino-Roman
X            7 Helvetica-Narrow
X            8 Garamond-Light
X            9 Korinna-Regular
X            a Helvetica-Condensed
X            b ZapfChancery-MediumItalic
X
X
X
X     Page 4                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X           The target printer may not have exactly these fonts.
X           To see which fonts are configured, display the psf
X           usage information with:
X
X            psf    -
X
X           Since Courier is    the only fixed-pitch font, it is
X           usually used for    printing of man    pages or programme
X           listings.  The other fonts are proportionally spaced.
X
X           The selected font becomes the new "default font".
X
X           The font    may be specified either    by the font number or
X           the font    name.  For example, the    Courier    font could be
X           selected    with either option '-f 0' or '-f Courier'.  If
X           the selection is    by name, then only a few of the
X           characters of the name must be provided.     The
X           NewCenturySchlbk-Roman font could be selected with the
X           option '-f New'.
X
X
X      -g type
X           Sets the    working    paper type.  The type may be one of
X           the following with the default number of    lines and
X           columns (assuming 12 point, 10 pitch Courier
X           characters):
X
X               type      lines        columns
X              -------      -----        -------
X              letter       63          80
X              legal       81          80
X              a4       67          78
X              b5       58          67
X
X           The number of lines/columns represents the number of
X           possible    lines/columns in the printable region of the
X           postscript printer - exclusive of the unprintable
X           margin area.
X
X
X      -h   The file    name, page number and current date are printed
X           at the top of each page.     The point size    is
X           automatically scaled to permit the specified number of
X           text lines to be    printed    to account for the additional
X           two lines consumed by the title line.
X
X
X      -H text
X           Place a header (like -h ) however use text rather than
X           the filename.
X
X
X
X
X
X     Page 5                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X      -i n Indent the left margin by n points.  This may be    used
X           to center the text in the page.
X
X
X      -l n Sets the    number of printed lines    per page.  The default
X           is 63 lines for letter sized paper.  If more than 63
X           lines per page are specified, the point size is
X           automatically reduced to    accomodate the line count.
X
X           The number of printed lines specified by    -l may be less
X           than the    number of possible print lines specified by -
X           L. For example, the default total number    of print lines
X           is 63 (as though    you had    specified -L63 ).  If you used
X           the option -l20 , then only the first 20    lines of the
X           possible    63 would be printed.  A    skip to    new page would
X           be performed for    the 21st line and the remainder    of the
X           page would be blank.
X
X
X      -L n Specifies the number of possible    print lines available
X           on the page.  If    -L is specified, then the page scale
X           is adjusted to accomodate the line count.   However,
X           only the    number of lines    specified by the -l option
X           will actually print.
X
X
X      -m n Move the    top margin down    by n points.  This may be used
X           to center the text in the page.
X
X
X      -n   The page    is printed in portrait (narrow)    format.     This
X           is the default for 1-up and 4-up    printing.  If portrait
X           layout is desired for 2-up printing, then the -n    option
X           must be specified.
X
X
X      -p n Sets the    nominal    point size to n    points.     This is
X           accurate    only to    "1-up" printing.  If "2-up" or "4-up"
X           or "1-up, landscape" printing is    desired, the nominal
X           point size is automatically scaled.
X
X           The selected point size becomes the new "default    point
X           size".
X
X
X      -R n removes n lines from the    beginning of the file.
X
X
X      -r n removes n lines between pages of    the file.
X
X           Use this    option if the text file    has blank lines    that
X           must be removed between pages.  For example, a typical
X
X
X
X     Page 6                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X           "accounting" report may print 60    lines and 132 columns
X           of text.     Usually, such reports have two    blank lines
X           before the first    printed    text on    a page    and 6 blank
X           lines to    skip to    the top    of the next page.
X
X           To generate exactly 60 printed lines with psf, the
X           first two blank lines should be removed with -R2    and
X           the blank lines between pages removed with -r6:
X
X              psf -R2 -r 6 -l 60 -c 132    account.rpt | lp
X
X           The -r and -R may be used together as needed.
X
X           If a skip to new    page was caused    by a formfeed imbedded
X           in the text file, then removal of lines is not
X           performed for that page.
X
X
X      -s   generates a display of commonly used page layouts,
X           point sizes and the associated line and column counts
X           for the Courier font.  The display looks    like:
X
X             point size:      8      10       12
X                       lin col    lin col     lin col
X          -- Page Layout --    --- ---    --- ---     --- ---
X           Letter  portrait:    95 120     76  96      63  80
X           Letter landscape:    72 159     57 128      48 106
X            Legal  portrait:   122 120     97  96      81  80
X            Legal landscape:    72 204     57 164      48 136
X               A4  portrait:   101 117     81  94      67  78
X               A4 landscape:    70 170     56 136      46 113
X               B5  portrait:    87 100     69  80      58  67
X               B5 landscape:    60 146     48 117      40  97
X
X           Statistics for point sizes between 6 and    16 are shown.
X
X
X      -t n Sets the    width of the tab stops.     By default this is
X           set to 8.  If the first line of a text file contains
X           the string "ta=", then the tab stop width is
X           automatically determined    from this string.  For
X           example,    if the first text line contains    "/* ta=4 */"
X           then the    tab width is automatically set to 4.  This
X           feature is useful if programme source files use a tab
X           space of    4.
X
X
X      -u f.def
X           causes the specified file to be used rather than    the
X           default printer definition file psfprint.def.
X
X
X
X
X
X     Page 7                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X      -v   Print pages in reverse order.
X
X
X      -w   The page    is printed in landscape    (wide, horizontal
X           format).     This is the default for 2-up printing.     If
X           1-up or 4-up printing is    desired    in landscape mode,
X           then the    -w switch must be specified.
X
X
X      -x   Draws a cross in    the to separate    the logical pages.
X           This is effective for 4-up or 2-up printing.  If    1-up
X           is used,    this option is ignored.
X
X
X      -z   This option applies to psflpd use for print filtering
X           with lpr    or psffilter used for print filtering with lp
X           spooling    systems.  Ascii    to postscript translation is
X           forced, even if the file    is already postscript code.
X           This allows the printing    of a postscript    programme.
X
X
X     PSF NOTES
X      Psf filters text in a    "minimally conforming" postscript
X      format (as specified in the Postscript Language Reference
X      Manual).
X
X      If the text contains escape sequences    (possibly generated by
X      psfbs, psfmail or a text editor), the    escape sequences are
X      analyzed to perform limited font and underline selection.
X      The escape sequences are translated into appropriate
X      postscript code.
X
X      The permitted    sequences have the following format:
X
X          ^E<command>
X
X      The following    sequences are recognized:
X
X           ^EB       begin bold (in current font family)
X           ^Eb       end bold
X           ^EI       begin italics
X           ^Ei       end italics
X           ^EU       begin underline
X           ^Eu       end underline.
X           ^EFn       begin font 'n' (0..9, a..f)
X           ^Ef       revert to default font
X           ^EPnn   begin point size 'nn' (2 digits)
X           ^Ep       revert to default point size
X           ^E+       skip    1/2 line foreward
X           ^E-       skip    1/2 line backward
X
X           "^E"    is a true ctrl-E character, not
X
X
X
X     Page 8                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X              the ascii text string    "^", "E"
X
X      Note that point sizes    with ^EPnn must    be two digits such as
X      ^EP07    or ^EP14.
X
X      Sequences may    be nested: bold, italic, underlined would be
X      generated with:
X
X           ^EB^EI^EUbold, italic and underlined^Eu^Ei^Eb
X
X      Font numbers are consistent across printers.    However, the
X      available fonts may be different on different    printers.  For
X      a given printer, the font numbers available are as specified
X      on the usage menu of psf (generated with "psf    -").
X
X      Any unrecognized escape sequences are    ignored.
X
X
X     PRINTER SPOOLING
X      If psffilter has been    installed as part of the lp/lpsched lp
X      spooling system, psf options may be passed in    the lp command
X      line using the -o option for lp :
X
X          lp -o"-4xh" this.file    that.file
X             --------
X
X      The additional options of "banner" and "nobanner" may    be
X      passed to the    spooler    to print or not    print a    banner page:
X
X          lp -o"nobanner -4xh" this.file that.file
X      or
X          lp -o"banner -4xh" this.file that.file
X
X      The spooler system also recognizes the -z option to force
X      printing of postscript code.
X
X      If the spooler is lp/lpsched,    then the spooler binary    is
X      normally psffilter. If the spooler is    lpr/lpd, the binary is
X      psflpd.
X
X      If the system's spooler is lpr/lpd then options may not be
X      passed to the    print filter: usually the system administrator
X      has configured a number of different printer names that use
X      different default printing characteristics of    psf.
X
X      For example, printing    2-up on    a page could be    done with the
X      command:
X
X           lpr -P2up my.file
X
X
X     ENVIRONMENT
X
X
X
X     Page 9                         (printed 1/18/92)
X
X
X
X
X
X
X     PSF(1)               Unix System V            PSF(1)
X
X
X
X      If the environment variable PSFLP is set, then psf and
X      psfdoub will use the value as    the name of the    output print
X      file.     If this variable is not set, the default output file
X      is stdout.
X
X      For example.
X
X           set PSFLP=prn
X
X      would    be a convenient    way to always direct the output    of psf
X      to the MSDOS printer prn.
X
X      If the environment variable PSFDEF is    set, psf uses the set
X      value    as the name of the .def    file to    use.
X
X      For example:
X
X           set PSFDEF=/etc/psfprint.def
X
X
X     DIAGNOSTICS
X      no alternate bins permitted
X      paper    bin greater than maximum for printer
X      Double sided or book in reverse ordered not supported
X      Font number invalid
X          - use    'psf -'    to see a list of fonts available
X      cannot create    work file
X      cannot allocate enough memory
X      Cannot open output file
X      Unknown file xxxx
X      Bad psfprint.def file
X          - the    psfprint.def file is corrupted.     Contact
X            your systems administrator.
X
X
X     BUGS
X      Double sided reverse ordered printing    with the -dv options
X      is not supported.
X
X
X     FILES
X      /usr/spool/lp/model/psfprint.def:  printer definition    file
X      psfbook.psd:    output file for    double sided printing.
X
X
X     SEE ALSO
X      psfmail psfbs    psfman psfnroff    psfmbox    psfdoub    lp lpadmin lpr
X      lpd
X
X
X     AUTHOR
X      Tony Field.          [e-mail]
X
X
X
X     Page 10                         (printed 1/18/92)
X
X
X
END_OF_FILE
if test 18761 -ne `wc -c <'man/psf.doc'`; then
    echo shar: \"'man/psf.doc'\" unpacked with wrong size!
fi
# end of 'man/psf.doc'
fi
echo shar: End of archive 8 \(of 9\).
cp /dev/null ark8isdone
MISSING=""
for I in 1 2 3 4 5 6 7 8 9 ; do
    if test ! -f ark${I}isdone ; then
    MISSING="${MISSING} ${I}"
    fi
done
if test "${MISSING}" = "" ; then
    echo You have unpacked all 9 archives.
    rm -f ark[1-9]isdone ark[1-9][0-9]isdone
else
    echo You still need to unpack the following archives:
    echo "        " ${MISSING}
fi
##  End of shell archive.
exit 0

exit 0 # Just in case...