BRAINY SMURF'S FILE PRINTER
      PC/DOS VERSION - Rev: C

Difficulties or suggestions:
Rick Hughes - rbhughes@infi.net

SMURF is a relatively unsophisticated file printer that is easy to use,
has some very useful options and has been ported to several platforms.

Usage:    smurf [/options] [file1] [file2] [. . .]

Examples: smurf filea.txt
          smurf /0cw fileb.asc
          smurf filea.txt fileb.asc read.me foobar.dta

The first example above is the normal mode of execution.  After the program
locates the file it asks you to position the paper & enter any options that
you require.  Enter a '?' to see a list of the options available. (See below)
The options can be entered in any order and the program will ask for further
information as required.  Entering just a 'return' will accept the default
settings.  These settings are: print one copy of the file on an 80 column
printer at 66 lines per page; the lines are indented 3 spaces to allow for
hole punching; lines exceeding 80 characters will be continued on the
next line preceeded by '>c '.

The second example illustrates entering options on the command line.  The
options are the first argument and start with a '/'.  The program will
assume that the paper is positioned correctly and bypass the question.

The third example shows how to print several small related files one after
another in the same run.

SMURF uses line counts to keep track of top and bottom of form.  It will
usually print 61 lines of data before going to the top of the next page.
If it encounters a line that reads '*$*EOP' or '*$*eop' or Ctl-L it will
print blank lines to the top of the next page.

Non-printable characters encountered in the record are printed as '~'.
Tab characters are expanded to eight spaces.

OPTIONS AVAILABLE:          Multiple options can be entered in any order
   0 - ZERO LEADING SPACES       - No room for hole punching
   A - COLUMN ALIGNMENT          - Wrap at column 70 (with alignment header)
   B - BLANK LINE SUPPRESSION    - Only print 1st of multiple blank lines
   C - COPIES NEEDED             - Will prompt for number needed
   D - DOUBLE COLUMN COMPRESSED  - 2 columns of '63 character' records
   E - EconoMode                 - HP DeskJet Draft mode
   H - NO HEADERS                - No print of page, date & file name
   L - LINE NUMBERS              - Instead of leading spaces
   N - NUMBER OF LINES PER PAGE  - Default = 66, Prompts for number
   P - COMPRESSED PRINT          - 88 lines/page 132 characters/line
   Q - NEAR LETTER QUALITY       - For 9/24 pin printers
   R - START AT RECORD           - Prompts for start record number
   S - START AT PAGE             - Prompts for start & end page numbers
   T - TRUNCATE AT LINE LENGTH   - No '>c ' continuation lines
   W - 132 COLUMN PRINTER        - Non-Compressed - no leading spaces
   Z - HP LASER JET/DESK JET printer
   X - EXIT

Most of the above options are self explanatory but a few warrant further
explanation.

   A - COLUMN ALIGNMENT
       Quite often you will be dealing with records that are larger than
       130 characters.  This option will print a 'character count header'
       and wrap the record lines at every 70th character.  This allows for
       easily location of any given field in the record.

   D - DOUBLE COLUMN COMPRESSED
       If you have a file where the records are less than 64 characters
       long this option will print the records in two columns on the page.
       Records 1 through 85 will be on the left and records 86 through
       171 will be on the right.  Records greater than 63 characters long
       are truncated