home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 2 / fishmore-publicdomainlibraryvol.ii1991xetec.iso / dirs / cbbs_415.lzh / CBBS / CBBS.lzh / docs / print.doc < prev    next >
Text File  |  1990-05-09  |  4KB  |  72 lines
  1. This is a simple print utility program that I wrote many moons ago.
  2.  
  3. The syntax of the command is:
  4.  
  5.    print [-f | -c | -lN | -r | -e | -nN] file [file [ file .....]  ]
  6.  
  7.          with no arguments at all the program will print a brief summary
  8.          of its usage.
  9.  
  10.          With only filename arguments, the program by default prints the
  11.          named files using whatever current font, fontsize and number of
  12.          lines per page are set in the printer. Usually this is PICA,
  13.          10 chars per inch, 66 lines per page. After each file (including
  14.          the last) the program prints a carriage return and a line feed.
  15.          These defaults can be overridden by using the follwoing options.
  16.          The options always apply to all files on the argument line.
  17.  
  18.          If the program sends a command sequence to the printer, it uses
  19.          the standard ISO commands. This does not cause a problem even if
  20.          you specify, for example, both '-e' and '-r' as the driver will
  21.          accept both standard and raw commands.
  22.  
  23.       -f means that the program should NOT print the carriage return and
  24.          formfeed at the end of each file ... useful when printing multiple
  25.          copies of files that have been formatted and are already an exact
  26.          number of pages long or already contain a formfeed at the end of
  27.          the file.
  28.  
  29.       -c causes the program to transmit the following command sequences to
  30.          the printer and then terminate without printing anything further:
  31.          reset (clear), set left margin to 1, set right margin to 80,
  32.          set font to PICA, 10 chars per inch, 66 lines per page.
  33.          -c exits and does not print any files.
  34.  
  35.       -l sets the number of lines per page to N. If this is not specified
  36.          then a line spacing command is not sent to the the printer and
  37.          therefore the printer default will be used. This is usually
  38.          66 lines per page. If -e (elite) is specified without -lN then
  39.          88 lines per page is used. -lN is used to override the default and
  40.          does not usually have to be specified. -lN can be used to print
  41.          a preformatted file containing labels with a formfeed between each
  42.          label. 
  43.  
  44.       -r causes 'print' to write the files using raw I/O which
  45.          means that all characters go through exactly as in the file.
  46.          This allows you to put machine-specific control codes in the
  47.          file.
  48.          If -r is not specified then the normal device is used and any
  49.          escape sequences are assumed to be the standard ISO ones used
  50.          by the driver (see include/devices/printer.h for a list of codes)
  51.  
  52.       -e use the elite font (12 cpi AND 88 lines per page) instead of pica.
  53.          The 88 lines per page default can be overidden by the -lN option.
  54.          For the environmentally conscious, this is a good option to use
  55.          when printing program listings since it will save paper by printing
  56.          88 lines per page instead of 66. WARNING, saving the environment
  57.          may cause you some eyestrain. Life's never easy!
  58.  
  59.       -nN If this option is used then only ONE file should be specified
  60.          and that file will be printed N times.
  61.  
  62.  
  63.       If -e or -lN were specified then after the program has finished
  64.       printing all specified files, it will change the default font back
  65.       to PICA, 10cpi and 66 lines per page.
  66.  
  67. BUGS: Yep. The ^C abort does not work properly because the program reads
  68.       512 byte chunks at a time from the file and the printer may have
  69.       a 1K or larger buffer so that the ^C doesn't take effect immediately,
  70.       if at all.
  71.  
  72.