home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 300 / 294 / tfl.doc < prev    next >
Text File  |  1985-09-20  |  5KB  |  104 lines
  1.  
  2.   -= TFL =- Text File Lister
  3.  
  4.   Version 1.02  09/20/85
  5.  
  6.   (C) Copyright 1985 by William D. Hileman
  7.                         2262-3 Lucretia Ave.
  8.                         San Jose, CA  95122
  9.                         (408) 971-8416 (home)
  10.  
  11.      Released to the Public Domain for distribution free of charge.
  12.   The user is welcome to freely distribute this software, provided it
  13.   is distributed in its original form, and that there is no compensation
  14.   for the distribution.
  15.  
  16.      TFL is a simple ASCII text file lister which provides a header line
  17.   containing filename, system date and time, and page number at the top of
  18.   each page.  It also provides a small margin at the top and bottom of each
  19.   page.  TFL is very generic, and does not even issue a form-feed character
  20.   to page, it instead counts lines.  TFL also expands TAB characters to
  21.   white space so that all printers should handle it.  TFL does not strip-
  22.   out any other characters, so files which contain form-feed characters, or
  23.   other control characters, may produce undesireable results.
  24.  
  25.      TFL can be invoked in any one of several ways:
  26.  
  27.      Entering 'TFL ?' and pressing [ENTER] displays a short description of
  28.   the program and proper command line syntax.
  29.  
  30.      Entering 'TFL' and pressing [ENTER] prompts the user for the filespec,
  31.   and proceeds to send it to the printer.
  32.  
  33.      Entering 'TFL filespec' and pressing [ENTER] proceeds to send the
  34.   selected file to the printer.  'filespec' is the optional drive i.d. with
  35.   colon (i.e. 'C:'), and/or the optional path specifier (i.e. '\ROOT\FILES\'),
  36.   and/or the required filename (i.e. 'TFL.DOC').
  37.  
  38.      Entering 'TFL d:\path\TFL.DAT' and pressing [ENTER] sequentially
  39.   reads filespecs contained in the text file TFL.DAT on the optional drive
  40.   and path specified and sends them, one after the other, to the printer.
  41.  
  42.      The last two invocations also have the option of passing page size
  43.   definition switches on the command line.  TFL defaults to printing 66
  44.   lines per page (six lines per inch on an eleven-inch long sheet), and 80
  45.   characters across each page (ten characters per inch on an 8-1/2 inch
  46.   wide sheet).  The program does not send control codes to the printer
  47.   to set any desired print mode (unless they are contained in the text file
  48.   itself), so the printer would need to be set-up appropriately before
  49.   using TFL.  Refer to your printer manual for more information.
  50.  
  51.      To change the page length, use the `/PL' switch AFTER the filespec,
  52.   i.e., 'TFL TFL.BAS /PL 88' to list file TFL.BAS at 88 lines per page.
  53.   The spaces after the filespec are optional.
  54.  
  55.      To change the page width, use the '/PW' switch AFTER the filespec,
  56.   i.e., 'TFL TFL.DAT /PL 88 /PW 132' to list the files contained in
  57.   file TFL.DAT at 88 lines per page and 132 columns per page.
  58.  
  59.      There is minimal file integrity checking done.  The selected file(s)
  60.   are checked to see if they exist.  If they do, they are checked to see
  61.   if they are empty.  If they are not, they are check to see if they are
  62.   BASIC 'protected' or 'binary' files.  If they are not, TFL will attempt
  63.   to print them.  Otherwise, a corresponding error message will be displayed.
  64.  
  65.      When doing a batch listing ('TFL TFL.DAT'), any invalid files en-
  66.   countered during the listing process will cause the appropriate error
  67.   message to display, but TFL will not terminate execution unless the file
  68.   was the last one in the list.
  69.  
  70.      TFL.DAT can be created with any word processor, DOS's EDLIN, DOS's
  71.   'COPY CON filespec' feature, or with an edited 'DIR > TFL.DAT'.  Refer
  72.   to your DOS manual for more information.  The file must contain ONLY a
  73.   list of filespecs with no blank lines.
  74.  
  75.      Pressing [ESC] during printing will abort the current file, and ALL
  76.   files if you are running a batch listing.
  77.  
  78.      Hope you can find as much use for this program as I have.  I've been
  79.   using various versions of this utility over the years at work as I never
  80.   liked the DOS 'PRINT' utility, and never cared for anything too fancy...
  81.  
  82.      I ask for no donations for my software, I write programs for a living
  83.   eight hours (plus) a day, and do these because I enjoy it.  These are my
  84.   small contributions to the public domain, mostly dedicated to the numerous
  85.   sysops I've encountered who feel no sacrifice in donating their priceless
  86.   time, effort, and equipment for our usage.  If you do find one of my
  87.   programs interesting or useful, or have an objective criticism then by all
  88.   means, please drop me a line.  I'd rather receive a compliment on my
  89.   programming skills than a few dollars contribution any time!  I can be
  90.   reached at any of the following BBS's in the Silicon Valley (CA) area:
  91.  
  92.                 Big Foot         RBBS (408) 225-1845
  93.                 North San Jose   RBBS (408) 945-8358
  94.                 Sigma Designs    RBBS (408) 946-3269
  95.                 Animal House     RBBS (408) 374-0966
  96.                 P.D.S.E.         RBBS (408) 735-7190
  97.                 Logon Unlimited  RBBS (408) 735-7390
  98.                 General Electric RBBS (408) 925-2518
  99.                 Compushop        RBBS (408) 226-4277
  100.                 Crystal Castles       (408) 733-1364
  101.  
  102.      I am a SIG sysop on Crystal Castle BBS's SIG 6 - the Programming
  103.   Techniques SIG.  Call my SIG sometime!
  104.