home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 184.lha / LaserWriterFilter / lwf_1.man < prev    next >
Text File  |  1988-04-28  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4. LWF(1-LOCAL)      UNKNOWN SECTION OF THE MANUAL      LWF(1-LOCAL)
  5.  
  6.  
  7.  
  8. NAME
  9.      lwf - ASCII to PostScript filter
  10.  
  11. SYNOPSIS
  12.      lwf [-c#] [-d] [-i#] [-l] [-m] [-n] [-olist] [-p[str]]
  13.          [-P filename] [-r] [-s#] [-S] [-t#] [-v] [file ...]
  14.  
  15. DESCRIPTION
  16.      _L_w_f takes one or more ASCII text files as input and produces
  17.      PostScript  instructions  that may be sent (see lpr(1)) to a
  18.      PostScript printer (e.g., an Apple LaserWriter)  for  print-
  19.      ing.   If  no files are given on the command line, the stan-
  20.      dard input is read.  The program correctly handles the  form
  21.      feed  character and tabs and understands backspacing; under-
  22.      scores followed by backspaces  may  be  used  to  underline.
  23.      Courier  font is used.  The output conforms to the Adobe 2.0
  24.      file structuring conventions.
  25.  
  26.      Note that flag arguments apply to all of the  files  in  the
  27.      argument  list.   For  example, using ``-s8'' prints each of
  28.      the files in 8 point type.
  29.  
  30.      Multiple copies of each page can be printed  by  immediately
  31.      following  the  -c  flag  with the number of copies to make.
  32.      The pages are not collated.
  33.  
  34.      Lines may be indented (shifted to the right)  using  the  -i
  35.      flag.   This flag is immediately followed by the distance in
  36.      inches to shift all text from the left  edge  of  the  paper
  37.      instead  of  the  default amount (about 1/3 of an inch); the
  38.      resolution is approximately 1/72 of an inch.
  39.  
  40.      The -l flag indicates that landscape format is  to  be  used
  41.      instead of the default portrait format.
  42.  
  43.      Margins suitable for use with a  three  hole  punch  can  be
  44.      obtained  using  the  -m  flag.   This flag may be used with
  45.      either portrait or landscape mode.  In portrait mode the  -m
  46.      flag  and  any  indentation specified by a -i flag are addi-
  47.      tive.
  48.  
  49.      To get top and bottom margins suitable for printing 66 lines
  50.      per  page (with the default 10 point size), use the -n flag.
  51.      This option works good when printing manual pages.
  52.  
  53.      The -o flag is immediately followed by a range specification
  54.      that  indicates  which  pages  are  to  be printed.  A range
  55.      specification is  a  comma-separated  list  of  numbers  and
  56.      ranges.   A  number  N  selects  the  Nth  page; a range N:M
  57.      selects the Nth through Mth pages, inclusive; an initial  :N
  58.      selects from the beginning up to and including the Nth page;
  59.      and a final N: selects from the Nth page to  the  end.   The
  60.  
  61.  
  62.  
  63. Sun Release 3.2   Last change: 21 February 1988                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LWF(1-LOCAL)      UNKNOWN SECTION OF THE MANUAL      LWF(1-LOCAL)
  71.  
  72.  
  73.  
  74.      default, ``:'', is to print all pages.
  75.  
  76.      The -p flag indicates that pr(1) is to be  used  to  perform
  77.      pagination and print page headers.  An argument string to be
  78.      passed on to pr(1) can immediately  follow  the  flag.   The
  79.      usual  way  of  producing multicolumn output is to pass a -n
  80.      flag to pr(1), where n is the number of columns to generate.
  81.      Note that this string must be properly quoted if it contains
  82.      whitespace, metacharacters, backslashes, etc.  _L_w_f passes on
  83.      the number of lines and columns to pr(1) so that multicolumn
  84.      output is handled correctly.  When  specifying  multicolumns
  85.      you  are responsible for selecting an appropriate point size
  86.      and/or landscape format.  The formfeed character is  handled
  87.      incorrectly  by some versions of pr(1) when multiple columns
  88.      have been specified.  Instead of starting a  new  column  or
  89.      page  it  simply  passes formfeeds through.  Lwf filters out
  90.      these formfeeds.
  91.  
  92.      _L_w_f normally includes a standard internal PostScript  prolo-
  93.      gue in its output.  Optionally, a compile time option is not
  94.      to include it in _l_w_f. In this case _l_w_f  will  look  for  the
  95.      file    lwf.prologue    in   a   standard   place   (usually
  96.      /usr/local/lib/lwf.prologue).  The argument following  a  -P
  97.      flag  specifies  a  prologue  file to be substituted for the
  98.      standard system file.
  99.  
  100.      The default is to perform page reversal,  which  is  correct
  101.      for  printers  like the Apple LaserWriter.  The -r flag dis-
  102.      ables page reversal so that the pages appear in the  correct
  103.      sequence in the output tray of printers like the NEC Silent-
  104.      writer LC-890.
  105.  
  106.      The -s flag, immediately followed by a 7, 8, 9, 10,  11,  or
  107.      12  causes  the  corresponding  point  size to be used.  The
  108.      default point size is 10.
  109.  
  110.      By default, the output of _l_w_f is intended to  go  through  a
  111.      spooler   that  monitors  the  status  of  the  printer  and
  112.      separates jobs.  The -S flag indicates that such  a  monitor
  113.      is  not  being used and that a header page should be printed
  114.      to  separate  jobs  and  end-of-file  characters  should  be
  115.      inserted in the output.
  116.  
  117.      The -t flag is immediately followed by a  number  indicating
  118.      the  distance  between  tab  stops.   The default value is 8
  119.      characters.
  120.  
  121.      The -d and -v flags are used for debugging.
  122.  
  123. EXAMPLES
  124.      The command
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 3.2   Last change: 21 February 1988                 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LWF(1-LOCAL)      UNKNOWN SECTION OF THE MANUAL      LWF(1-LOCAL)
  137.  
  138.  
  139.  
  140.           lwf -p-2 -i0.5 -s12 file1.c file2.c | lpr -Plw
  141.  
  142.  
  143.      would print the two files on printer 'lw' in portrait format
  144.      with page headings, indenting 0.5 inches from the left edge,
  145.      using 12 point type.  Each file  would  be  printed  in  two
  146.      columns.
  147.  
  148.      The command
  149.  
  150.  
  151.           lwf -l -s7 -p'-h foo' | lpr -Plw
  152.  
  153.  
  154.      would  print  the  standard  input  with  page  headings  in
  155.      landscape  format  using 7 point type.  The filename for the
  156.      header line would be 'foo'.
  157.  
  158.      The command
  159.  
  160.  
  161.           lwf -p'-h foo .login -h bar .cshrc' | lpr -Plw
  162.  
  163.  
  164.      would print the file ``.login'' with a header title  ``foo''
  165.      and ``.cshrc'' with the header title ``bar''.
  166.  
  167.      A useful csh alias is:
  168.  
  169.  
  170.           alias prlw 'lwf -s7 -t4 -l -p-2 \!* | lpr -Plw'
  171.  
  172.  
  173.      which, when invoked as
  174.  
  175.  
  176.           prlw foo1 foo2
  177.  
  178.  
  179.      prints foo1 and foo2, two columns per page, on printer 'lw'.
  180.  
  181. FILES
  182.      /tmp/lwfXXXXXX      - temporary file used for page reversal
  183.  
  184. SEE ALSO
  185.      pr(1), lpr(1)
  186.  
  187. LIMITATIONS
  188.      The maximum input line  length  is  1024  characters.   This
  189.      should  not present a problem since the corresponding output
  190.      line length would be too long to be  printed.   The  program
  191.      quits  and  prints  a  message if an input line is too long.
  192.  
  193.  
  194.  
  195. Sun Release 3.2   Last change: 21 February 1988                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LWF(1-LOCAL)      UNKNOWN SECTION OF THE MANUAL      LWF(1-LOCAL)
  203.  
  204.  
  205.  
  206.      Output lines that are too long are normally  silently  trun-
  207.      cated by the printer.
  208.  
  209.  
  210.      _L_w_f can be compiled such that there is a limit on the number
  211.      of pages it can produce.
  212.  
  213. BUGS
  214.      It might be argued that flags should be allowed to be inter-
  215.      spersed between file arguments.
  216.  
  217.  
  218.      The character '\001' (SOH) should not appear in the input as
  219.      it is used within the program to delimit columns.  The first
  220.      time the program reads  this  character  it  determines  the
  221.      number  of  columns  being printed; all subsequent lines are
  222.      expected to have this  number  of  columns  or  be  ``single
  223.      column''.
  224.  
  225.  
  226.      A -s flag should not be passed on to pr(1)  since  _l_w_f  uses
  227.      it.
  228.  
  229.  
  230.      The program can only handle the 6 different point sizes  and
  231.      the single font.
  232.  
  233.  
  234.      So much for metric.
  235.  
  236. AUTHOR
  237.      Barry Brachman
  238.      Dept. of Computer Science
  239.      University of British Columbia
  240.  
  241.      With additions/revisions and Amiga port by:
  242.  
  243.      Dr. Samuel Paolucci
  244.      1351 Roselli Dr.
  245.      Livermore, CA 94550
  246.      (415)294-2018
  247.      ARPA: paolucci@snll-arpagw.llnl.gov
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Sun Release 3.2   Last change: 21 February 1988                 4
  262.  
  263.  
  264.  
  265.