home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / LASER / DLST12.ZIP / DLST.DOC next >
Encoding:
Text File  |  1988-12-03  |  4.5 KB  |  107 lines
  1. Dlst V1.2
  2. ----------
  3.  
  4. Dlst is a program that works along with the Tiny24.usp downloadable font
  5. to allow printing of up to 334 lines of a text file on a page.  This
  6. program can be used to print documentation files of shareware or public
  7. domain programs, program listings, and other Ascii files.  It has been
  8. tested on a HP Laserjet Plus and an HP Laserjet II.
  9.  
  10. Some of the features of Dlst are:
  11.  
  12.    *  Dlst prints output in two column in portrait mode with a verical
  13.       bar dividing the columns.
  14.    *  Dlst ignores any Form Feed characters
  15.    *  Sequences of 3 or more blank lines are output as 2 blank lines
  16.    *  Dlst prints up to 90 characters on a line.  If a line is between 90
  17.       and 170 characters long a second line will be printed preceded by
  18.       "    ....". Lines greater than 170 characters will be truncated.
  19.    *  Dlst expands tabs based on standard tabs stops every 8 positions.
  20.    *  A Heading is printed at the top of the left column consisting of
  21.       the filename and the page number.
  22.    *  Defaults to squeezing the most lines on a page - 168.  Dlst allows
  23.       an optional third argument to change the line spacing of the listing
  24.  
  25. These features have been put in the program for my own personal use.  For
  26. those who would like to modify these features the source in Turbo Pascal 4
  27. is included.
  28.  
  29. Dlst Command Line:
  30.  
  31.     DLST <input-file> <output-file> [ optional # lines ]
  32.  
  33.          output-file usually is prn if you are printing the file
  34.  
  35.          # lines can be a number up to 168.  If you give a different
  36.          number, 100 for example, then Dlst adjusts the line spacing so
  37.          that 100 lines are printed in each column
  38.  
  39.     Examples:
  40.          dlst filea.doc prn
  41.          dlst fileb.doc prn 120
  42.  
  43.  
  44. Soft Font File
  45.  
  46.     DLST works with the included downloadable font Tiny24.usp.  This is a
  47.     non proportional font that prints at 25 characters per inch.  This is
  48.     a very small font and you can decide for yourself if it is readable
  49.     enough for you.  The program assumes that the font is downloaded with
  50.     a font id of 1.  I am including both the downloadable font, and a file
  51.     that includes that font and the control characters necessary to set up
  52.     the font with a font id of 1.  The simplest way to set up the laser
  53.     printer is to "COPY FONT1.DWN/B PRN".  If you have a program for
  54.     downloading fonts you may want to use that program with Tiny24.usp.
  55.  
  56. List of files
  57.  
  58.         DLST.PAS        Turbo Pascal Source for DLST
  59.         DLST.EXE        Executable DLST program
  60.         DLSTW.PAS       Turbo Pascal Source for DLSTW
  61.         DLSTW.EXE       Executable DLSTW program
  62.         TINY24.usp      Downloadable font file for a tiny font
  63.         TINY24.DWN      Font file with control chars to set font to font id 1
  64.         DLST.DOC        This documentation file
  65.  
  66. DLSTW is a variation of DLST which allows wildcard characters in the input
  67. filespec.  This allows printing a whole group of source programs or a group
  68. of any ascii text files together.  Dlstw will print contents lines at the
  69. beginning of the listing which lists each file that will be printed.  At the
  70. start of each file DLSTW will print a dividing line and the name of the next
  71. file to be listed.  DLSTW also requires parameter 1 to be a description of the
  72. files which is printed at the top left of each page.
  73.  
  74. DLSTW Command line
  75.  
  76.     DLSTW <Description> <input-filespec> <output-file> [ optional # lines ]
  77.  
  78.         Description is a single string that is used as a title.  If you have
  79.         several words you want as a title you could use an underscore
  80.         character between the words.
  81.         Input-filespec can include the standard Dos wildcard characters
  82.         "*" and "?" to print multiple files.
  83.  
  84.     Example:
  85.         DLSTW DLST_SOURCE_FILES DLST*.PAS PRN
  86.  
  87. Notice
  88.  
  89.    These programs and files are placed in the public domain and may be freely
  90.    distributed as long as the program is not sold.  It may be placed on
  91.    Bulletin Boards.  This program may be included on collections of public
  92.    domain diskettes for distribution when the only charge associated is for
  93.    media and copy costs.
  94.  
  95.    David L. Peterson, 220 9th St So. Waite Park, Mn 56387
  96.  
  97. Changes for Version 1.2
  98. -----------------------
  99.  
  100.   * Converted to Turbo Pascal 4.  Programs are now smaller and faster
  101.  
  102.   * Made minor font file change.  Changed name of font.
  103.  
  104.   * Fixed some bugs.
  105.  
  106.   * Dlstw now works when the files are not in the current subdirectory.
  107.