Usenet 1994 January

home *** CD-ROM | disk | FTP | other *** search

/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume27 / psf3 / part08 < prev next >

Wrap

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

Newsgroups: comp.sources.misc From: tony@ajfcal.cuc.ab.ca (Tony Field) Subject: v27i099: psf3 - Postscript print filter system, v3, Part08/09 Message-ID: <1992Jan21.013538.11814@sparky.imd.sterling.com> X-Md4-Signature: 49f968825a9b6e1a928d85f9f0f47a02 Date: Tue, 21 Jan 1992 01:35:38 GMT Approved: kent@sparky.imd.sterling.com Submitted-by: tony@ajfcal.cuc.ab.ca (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. tony@ajfcal.cuc.ab.ca 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. tony@ajfcal.cuc.ab.ca 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...