home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT069.ZIP / DISTR / ASCLIST.EXE / LISTASC.DOC < prev    next >
Text File  |  1991-12-21  |  5KB  |  88 lines
  1.  
  2.                 LISTASC       VERSION 5.7       December 21, 1991
  3.                Program designed and developed by GEORGE SMALL
  4.              (C) Copyright George Small 1985 - 1992
  5.  
  6.                 LISTASC.DOC            Page 1
  7.  
  8.     LISTASC.EXE (version 5.7) is designed to list "BASIC" type files saved
  9.     with an .ASC, .BAS or .PRG extension in an ASCII format.  Files using IBM
  10.     BASIC, IBM BASICA, MICROSOFT QUICK BASIC, DBase III and a word processor
  11.     have been successfully listed using this program.  The common denominator
  12.     for all these files is that they were all "saved" in ASCII format.  For
  13.     BASIC or BASICA, use [SAVE "FILENAME.ASC",A]; for QUICK BASIC, use the
  14.     option to save the file in ASCII format (note that the extension [.BAS] is
  15.     automatic: or, optionally, add the extension [.ASC] to the filename);
  16.     Dbase III automatically saves the file with an extension of [.PRG] to the
  17.     filename in ASCII format; and, for word processor created files, save the
  18.     file in "ASCII format" and add the extension [.ASC] (most word processors
  19.     have this as an optional save file command).  The LISTASC program was
  20.     primarily designed to document and print source program coding; 
  21.     unfortunately, most of the programming languages don't provide a uniform
  22.     and formatted output listing.
  23.  
  24.     The LISTASC program will format the coding statements in "paragraph" type
  25.     format, preserving the original coding format (including imbedded blank
  26.     lines), using either normal or compressed printer font; line overflow is
  27.     indented to provide easy reading.  Maximum line length coding, including
  28.     imbedded blank spaces, tab spacing, special characters, comments, etc. is
  29.     variable and dependant upon the programming language and/or editor being
  30.     used.  Depending upon whether the listing is printed in normal 10 CPI or
  31.     compressed 17.5 CPI font, the listing line length will be either 80 or 132
  32.     characters in length.  The listing will be printed using 56 lines of text
  33.     per page and include a heading consisting of the filename, date and time of
  34.     file creation, page number, and, the current system date on each each page.
  35.     The printed listing format also allows for hole punching without
  36.     interferring with the source code statements.
  37.  
  38.     The C.ITOH (8510), EPSON (MX-80), OKIDATA (92), and IBM PROPRINTER are
  39.     supported.    The printer default is the IBM PROPRINTER character set with a 
  40.     compressed font [CHR(15)] default:  PFK 9 is used to select any of the
  41.     other printers supported.
  42.  
  43.     The program is started by entering [d:][\path] LISTASC.EXE at the DOS
  44.     prompt.  A maximum of 60 programs may be consecutively entered for
  45.     printing; normal or compressed font may be toggled from file to file as
  46.     well as drive allocation of the file to be printed during input.  The
  47.     program checks whether the file(s) are in ASCII format and if the file
  48.     is in the designated drive directory.  The file input format is as
  49.     follows:  [d:][\path]FILENAME[/a][/b][p][/n]|[/c]
  50.  
  51.                 LISTASC       VERSION 5.7       December 21, 1991
  52.                 LISTASC.DOC            Page 2
  53.  
  54.     USER NOTES:
  55.     o     [d:][\path] drive parameter:  omission indicates filename is
  56.      located on the default drive and path.
  57.     o     FILENAME is the name of the ASCII file that is to be printed.  The
  58.      file must have an extension of ".ASC", ".BAS" or ".PRG".  Use the
  59.          extension parameter of /a, /b or /p after the filename to indicate the
  60.          extension;  ommission of the extension parameter assumes an ".ASC"
  61.          extension to the filename.
  62.     o     [/n]|[/c] are font parameters to control normal or compressed
  63.      printing of the file and are mutually exclusive parameters.
  64.      Omission of a font parameter defaults to the font displayed at the
  65.      bottom of the screen.
  66.     o     Do not leave any blank spaces between optional parameters and
  67.      the filename.    Do not include the filename extension.
  68.     o     The program uses a temporary work space on the default drive;
  69.      therefore the media on the default drive must not be write
  70.      protected.
  71.     o     PFK 1 terminates printing the current file.
  72.     o     PFK 9 resets "global" printer parameters.
  73.     o     PFK 10 terminates program operation and returns to DOS.
  74.  
  75.     If this program is useful to you, a $15 program registration fee would be
  76.     appreciated.  Program registration will entitle you to being informed of
  77.     program revision and program customization service -- i.e., special printer
  78.     support, etc..  This program may be freely copied and shared with others.
  79.     For progam registration, send check or money order (or write) to:
  80.  
  81.                   GEORGE SMALL
  82.               4631 N. Camino Campero
  83.             Tucson, Arizona 85715-6321
  84.                 PHONE: 602/299-1587
  85.  
  86.     Thank you and enjoy.
  87.  
  88.