home *** CD-ROM | disk | FTP | other *** search
/ TopWare Tools / TOOLS.iso / tools / top1094 / pascii.doc < prev    next >
Encoding:
Text File  |  1994-02-01  |  5.7 KB  |  129 lines
  1.  
  2.  
  3.            PASCII 1.4   Copyright 1993-1994 by Joohee Jeong
  4.  
  5.                      (Released on Feb.2, 1994)
  6.  
  7.  
  8.  
  9.   Overview:  PASCII prepares an ASCII file for printing.   Supports
  10.     header/footer, pagination,  file-name,  time/date  of  printing,
  11.     time/date of file, one/two-sided printing, line numbering, left
  12.     margin (even/odd side), top margin, bottom margin, line-breaking,
  13.     FormFeed character,  TAB character expansion.   Removes trailing
  14.     blanks. Handles UNIX text files.         ** Freeware **
  15.  
  16.  
  17.   Installation:  Put the two files PASCII.EXE and PASCII.CFG in some
  18.     directory in your PATH.
  19.  
  20.  
  21.   Usage:  pascii [options] filespec1 [filespec2 [...]]
  22.  
  23.           options = -1 or -2         (1 or 2 sided printing)
  24.                     -num[+-]         (line numbering on/off)
  25.                     -c filename      (configuration file)
  26.                     -tab n           (TAB size 1 <= n <= 16)
  27.                     -header[+-]      (header on/off)
  28.                     -footer[+-]      (footer on/off)
  29.                     -headfooter[+-]  (header/footer on/off)
  30.  
  31.     If one-sided printing option is selected, then PASCII produces the
  32.     output file PASCII.OUT (in the current directory), which can be sent
  33.     to the printer by the DOS command:
  34.       copy pascii.out prn
  35.     If two-sided printing option is selected, then PASCII produces two
  36.     output files PASCII.EVN (for page 2,4,6,...) and PASCII.ODD (for
  37.     page 1,3,5,...), which can be sent to the printer by the DOS
  38.     commands:
  39.       copy pascii.evn prn
  40.       copy pascii.odd prn
  41.     It is convenient to have batch files pout.bat (peven.bat, podd.bat,
  42.     resp.) that consists of the single line "copy pascii.out prn" ("copy
  43.     pascii.evn prn", "copy pascii.odd prn", resp.) in some directory in
  44.     your PATH.
  45.  
  46.     If an input file is non-ASCII, then no output is generated.
  47.  
  48.  
  49.   Configuration:  All options are specified in a configuration file, say
  50.     PASCII.CFG, which is first searched in the current directory and
  51.     then in the directory in which PASCII.EXE resides.  This
  52.     configuration file PASCII.CFG can be freely edited by any text
  53.     editor.  The order of the configuration variables (i.e., options)
  54.     matters.  You should not mess up the order.  Blank lines are ignored.
  55.     Any text after the comment character `%' is ignored.
  56.       Following is an example of PASCII.CFG:
  57.  
  58.       70                              % 30 <= pageheight <= 80
  59.       80                              % 30 <= pagewidth <= 90
  60.       2                               % 1 or 2 sided
  61.       2                               % 0 <= top margin <= 30
  62.       2                               % 0 <= bottom margin <= 30
  63.       6                               % 0 <= even margin <= 40
  64.       10                              % 0 <= odd margin <= 40
  65.       8                               % 1 <= TabSize <= 16
  66.       \page/\npages \hfill{─} \filename      % even header
  67.       \filename \hfill{─} \page/\npages      % odd header
  68.       \page/\npages \hfill{─} (Printed on \ptime) \filename % even footer
  69.       Last modified on \ftime \hfill{─} \page/\npages       % odd footer
  70.       0                               % line numbering iff 1/0
  71.       1                               % use header iff 1/0
  72.       1                               % use footer iff 1/0
  73.  
  74.     If one-sided printing option is selected, then the parameters for
  75.     odd pages are used for all pages, odd or even. (That is, parameters
  76.     for even pages are ignored.)
  77.  
  78.     Everything except possibly the "commands" in header/footer will be
  79.     self-evident:
  80.       \page is the current page
  81.       \npages is the total number of pages
  82.       \filename is the input filename
  83.       \ptime is the date and time of printing
  84.       \ftime is the date and time of the input file
  85.       \hfill{x} inserts the characters x to fill the line.  \hfill
  86.          is identical to \hfill{ }
  87.  
  88.  
  89.   Command line options:  Some configuration options in PASCII.CFG that
  90.     need frequent change can be overridden by command line switches.
  91.       The switch -1 (-2, resp.) forces one-sided printing (two-sided
  92.     printing, resp.).
  93.       The switch -num (-num-, resp.) forces line numbering (line
  94.     no-numbering, resp.).  -num+ has the same effect as -num.
  95.       The switch -tab n can be used to set the tab size to n, where
  96.     1 <= n <= 16.
  97.       The switch -header (-header-, resp.) forces to use header (not to
  98.     use header, resp.).  -header+ has the same effect as -header.
  99.       The switches -footer[+-] and -headfooter[+-] should be obvious.
  100.  
  101.     Moreover, the configuration file itself can be specified by the
  102.     command line switch -c: for instance,
  103.  
  104.       pascii -c source.cfg somefile
  105.  
  106.     processes the input file SOMEFILE using the configuration variables
  107.     in SOURCE.CFG (first searched in the current directory and then in
  108.     the directory in which PASCII.EXE resides).
  109.  
  110.  
  111.   Limitations:
  112.     (i)   Doesn't accept multiple input files.
  113.     (ii)  FormFeed character can only appear as the first character
  114.          of a line.
  115.     (iii) Doesn't process an input file if the file name is one among
  116.          PASCII.OUT, PASCII.EVN and PASCII.ODD.
  117.  
  118.  
  119.   DISCLAIMER:  This software comes with absolutely no warranty.  In
  120.     no event the author shall be liable for direct, indirect or con-
  121.     sequential damages, loses, costs, fees or expenses of any nature
  122.     or kind.
  123.  
  124.   ----------------------------------------------------------------
  125.   Joohee Jeong                        Author of jspell (Shareware)
  126.   CompuServe: 73072,3651               Spell-checker w/TeX-ability
  127.   Internet: jeong@violet.berkeley.edu     Phone/Fax (510) 528-8753
  128.   Nemosoft Technologies, P.O.Box 1619, El Cerrito, CA 94530, U.S.A.
  129.