home *** CD-ROM | disk | FTP | other *** search
/ Hall of Fame / HallofFameCDROM.cdr / util1 / disklst2.lzh / DISKLIST.DOC < prev    next >
Text File  |  1991-04-23  |  51KB  |  1,213 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                  D I S K L I S T
  7.  
  8.  
  9.  
  10.                     Prints a Directory Listing on any Printer
  11.  
  12.  
  13.  
  14.  
  15.               DISKLIST is a commercial program and is copyrighted.
  16.               It is distributed using the Shareware marketing
  17.               concept.  The Shareware concept allows you to try the
  18.               fully functional program on your own computer before
  19.               you buy it.  If you continue to use DISKLIST or keep
  20.               it for when you might use it, then you MUST send the
  21.               $25 registration fee to the author.  Press F to print
  22.               the registration form from the program.
  23.  
  24.  
  25.  
  26.  
  27.               When you register DISKLIST you will receive:
  28.  
  29.                   Telephone and mail support.
  30.                   A copy of the latest version of DISKLIST
  31.                   Removal of Registration Screen & reminders.
  32.                   Skip the Help screen at the start of the program.
  33.                   Skip the Registration Form reminder at the end
  34.                     of the program.
  35.                   A loan amortization program with both the
  36.                     BASIC source code and the compiled
  37.                     program.  No registration is required for
  38.                     the amortization program. 
  39.                   Copies of PC-ACCOUNT and SHERLOCK for you
  40.                     to try before registering.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.                                _______
  47.                           ____|__     |               (R)
  48.                        --|       |    |-------------------
  49.                          |   ____|__  |  Association of
  50.                          |  |       |_|  Shareware
  51.                          |__|   o   |    Professionals
  52.                        -----|   |   |---------------------
  53.                             |___|___|    MEMBER
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                 Table of Contents
  60.  
  61.  
  62.                     OVERVIEW...............................1
  63.  
  64.                     FASTSTART..............................2
  65.  
  66.                     OPERATION..............................3
  67.  
  68.                     PARAMETERS and COMMANDS................4
  69.  
  70.                     LIST FORMATS...........................6
  71.  
  72.                     NONLASER PRINTER CONTROL CODES.........8
  73.  
  74.                     LASER COMMANDS........................10
  75.  
  76.                     LASER DOWNLOAD........................12
  77.  
  78.                     TEXT INPUT............................12
  79.  
  80.                     STATUS MESSAGES...................... 13
  81.  
  82.                     MONOCHROME MONITOR....................13
  83.  
  84.                     SUMMARY OF NON-DISPLAYED COMMANDS.....14
  85.  
  86.                     FILENAMES............................ 14
  87.  
  88.                     DISKFLAP..............................15
  89.  
  90.                     SHAREWARE............................ 16
  91.  
  92.                     EPILOGUE..............................17
  93.  
  94.                     COMMERCIAL LABELS.....................17
  95.  
  96.                     OMBUDSMAN............................ 18
  97.  
  98.                     IBM GRAPHICS EXAMPLE..................19
  99.  
  100.  
  101.                                  Copyright 1991
  102.                              John P. Bauernschub, Jr.
  103.  
  104.                                    Gulf Sierra
  105.                                14809 Clavel Street
  106.                                Rockville, MD 20853
  107.                                   301-460-0354
  108.  
  109.                               CompuServe ID 73270,77
  110.  
  111.  
  112.  
  113.  
  114.      OVERVIEW
  115.  
  116.      DISKLIST is designed to print the directory of any disk,
  117.      including subdirectories, on a stick on label, a sheet of paper
  118.      that can be cut to the size of the diskette, on an 8.5 x 11
  119.      sheet, the screen, or a disk file.  The list is in a format that
  120.      is the size of the floppy so that it can be attached to the
  121.      floppy, or, if on paper, trimmed to fit into the floppy sleeve.
  122.      DISKLIST lists the contents of all of the subdirectories on the
  123.      disk.  DISKLIST provides an easy method to configure the output.
  124.      Here is an example of one form of the output of DISKLIST.
  125.  
  126.              --------------------------------------------------
  127.              |               GREAT SHAREWARE                  |
  128.              |           Volume ID is DISKLIST                |
  129.              | 1,457,664 Total Space    893,440 Bytes Free    |
  130.              |------------------------------------------------|
  131.              | A:\                             153,664 BYTES  |
  132.              |   DISKLIST.DOC    34,377  08/15/90  19:32:16   |
  133.              |   DISKLIST.EXE   119,144  08/14/90  22:02:18   |
  134.              |   DISKLIST.PRM       124  03/25/90  11:11:48   |
  135.              |   DISKLIST.TTL        19  03/25/90  11:05:06   |
  136.              |                                                |
  137.              | A:\PC-ACCOU.NT                  230,862 BYTES  |
  138.              |   PCACT220.EXE   156,150  11/08/89  19:03:52   |
  139.              |   PCACT220.TXT     6,838  11/09/89  18:30:42   |
  140.              |   PCDOC220.EXE    67,874  11/08/89  19:09:22   |
  141.              |                                                |
  142.              | A:\SHERLOCK                     175,967 BYTES  |
  143.              |   SHERLOCK.DOC    30,895  08/15/90  19:35:14   |
  144.              |   SHERLOCK.EXE   145,072  08/15/90  19:44:04   |
  145.              |------------------------------------------------|
  146.              |        9 Files   08-17-1990   18:46:00         |
  147.              |                                                |
  148.              |                                                |
  149.              |                                                |
  150.              |                                                |
  151.              |                                                |
  152.              |                                                |
  153.              |                                                |
  154.              |                           Created by DISKLIST  |
  155.              --------------------------------------------------
  156.  
  157.      This example is in the 5.25 inch normal format for that size
  158.      diskette.  DISKLIST can also print it in the 3.5 inch compressed
  159.      format for the 3.5 inch diskettes, or in the 8.5 x 11 inch page
  160.      format.  There are 33 formats for you to chose from, all easily
  161.      selectable from the DISKLIST control window.  They contain from 1
  162.      to 6 columns of filenames.
  163.  
  164.      ASCII lines were selected for the frame of this display so that
  165.      it would print properly on all printers.  If your printer can
  166.  
  167.  
  168.                                     -1- 
  169.  
  170.  
  171.  
  172.      print the IBM graphics characters (lines, boxes, etc.) then you
  173.      can select IBM (unbroken) lines for your list and the frame will
  174.      be smooth single or double lines.  Such an example is given on
  175.      the last page of this manual.  Or you can select a format without
  176.      any lines.
  177.  
  178.      Half of the formats do not have any border lines to save space so
  179.      that you can print on stick on labels.  They are identified with
  180.      Label or Lab in the Format Size.  Labels also leave off the
  181.      'Created by DISKLIST'.
  182.  
  183.      Printer control codes can in inserted in the program.  The length
  184.      of the label in lines can be set.  In the label mode, DISKLIST
  185.      will space to the next label.  Each format has its own set of
  186.      laser commands.  All setup parameters can be saved.
  187.  
  188.  
  189.      FAST START
  190.  
  191.      To run DISKLIST, just enter DISKLIST at the DOS prompt.  Read the
  192.      Shareware screen carefully, then press RETURN.  The control
  193.      window and Help window are displayed.  Read the Help window for
  194.      instructions on how to navigate the DISKLIST control window.
  195.      Press any key to close the Help window, it's available anytime by
  196.      pressing H.  If you are using a monochrome monitor, press M  to
  197.      toggle on an arrow to indicate the selected parameter.  Setup the
  198.      parameters as you want them, then press P to print a list.
  199.  
  200.      When registered, the program will skip the Shareware screen and
  201.      the help window and be immediately ready for business.  After you
  202.      have used DISKLIST, enter the F command to print the registration
  203.      form, fill it out and send it with $25 to the program author.
  204.      Thanks.
  205.  
  206.      When DISKLIST starts, it assumes that you want to print the
  207.      directory of the default drive.  This is easily changed from the
  208.      DISKLIST control window in the program by selecting the first
  209.      parameter and pressing the right or left arrow keys.
  210.  
  211.      You can also select the source directory drive from the DOS
  212.      command by entering the drive letter (colon not necessary).  For
  213.      example, if you were going to print the directory of drive A: and
  214.      your default drive is C:, then the command would be:
  215.  
  216.                                 DISKLIST  a
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.                                     -2- 
  227.  
  228.  
  229.  
  230.      OPERATION
  231.  
  232.      When DISKLIST runs it reads several data files.  These files must
  233.      be in the same directory as DISKLIST.EXE.  If your operating
  234.      system is DOS 3.3 or above, you can run DISKLIST from any
  235.      directory and it will find its data files.  For older versions of
  236.      DOS, make the directory DISKLIST.EXE is in the default before
  237.      running it.
  238.  
  239.      To run DISKLIST, just enter DISKLIST at the DOS prompt.  After
  240.      the Shareware screen, the DISKLIST control window will appear.
  241.  
  242.  
  243.             Parameters         D I S K L I S T         Commands
  244.      ===================================================================
  245.  
  246.      1 - Disk Drive        A:              H or F1 - HELP  A - Space Yes
  247.      2 - Filespec          *.*             P - Print List  Z - ZIP   No
  248.      3 - Sort Files by     Name            L - Line Feed   E - Eject Page
  249.      4 - Sort Direction    Ascending       D - Save DISKLIST Parameters
  250.      5 - Display on the    Laser Printer   S - Save Title on Disk Drive
  251.      6 - Format            5  Normal       R - Read Title from Disk Drive
  252.      7 - Border Line Type  ASCII  |---|    F - Print Registration Form
  253.      8 - Lines Per List    30              C - Configuration
  254.      9 - Title for List                    F10 or ESC - Quit DISKLIST
  255.          The List Title is Displayed Here
  256.  
  257.                      Illustration of the Control Window
  258.  
  259.  
  260.      Press Function Key 1 or H to display the following help window.
  261.  
  262.                                   H E L P
  263.                    ======================================
  264.                    Select Parameter        or Digit
  265.                    Change Parameter         or Space Bar
  266.                    Select Command        Press Letter
  267.                    ESC              Erase text input line
  268.                          Press any key to resume
  269.  
  270.  
  271.      If you printed this documentation on your printer and the
  272.      characters before 'or Digit' did not print, they are the up and
  273.      down arrows for the cursor control.  Likewise the characters
  274.      before 'or Space Bar' are the left and right arrows.  To see how
  275.      this window really looks with the graphics characters, run
  276.      DISKLIST and press Function Key 1 to see the Help window.
  277.  
  278.      The words Parameters and Commands on the control window only
  279.      appear when the HELP window is active.
  280.  
  281.  
  282.  
  283.  
  284.                                     -3- 
  285.  
  286.  
  287.  
  288.      Select a parameter by entering the sequence number of the
  289.      parameter, or move the highlight with the up and down arrow keys.
  290.      Change the parameter by scrolling through the allowable values
  291.      with the left and right arrow keys or the space bar.  If you are
  292.      using a monochrome monitor, press M to toggle on an arrow to
  293.      indicate the selected parameter.
  294.  
  295.      Be sure to select the proper printer (Laser or Nonlaser) with
  296.      parameter 5.  Then press D to save the parameters.  A common
  297.      problem is to have the wrong control codes sent to the printer
  298.      because the wrong printer was selected.
  299.  
  300.      When parameters 2, 8 or 9 are selected, a window will open up for
  301.      text entry.  Press ESC to delete the previous entry, or edit it
  302.      with the standard editing functions.  Insert also works.  When
  303.      the entry is complete, press the up or down arrow key or RETURN.
  304.  
  305.      The input window will disappear.  The title will be displayed at
  306.      the bottom of the control window.  If you completed the entry
  307.      with a RETURN, the highlight will stay on the parameter.  Use the
  308.      left or right arrow key to reopen the window.
  309.  
  310.      To execute a command, press the command letter when no other
  311.      window is open.
  312.  
  313.  
  314.      PARAMETERS and COMMANDS
  315.  
  316.      DISKLIST lets you configure your directory lists to your
  317.      requirements.  You can save this configuration as the default
  318.      with the D command.  The configuration file will be automatically
  319.      read the next time DISKLIST is run.
  320.  
  321.      The parameters permit you to:
  322.  
  323.           Select any disk drive - floppy, hard, or ram disk.
  324.           Provide a file selection specification, Filespec.
  325.           Sort files by name, date, extension, size, or no sort.
  326.           Sort direction - ascending, descending.
  327.           Display on a laser printer, a nonlaser printer, the
  328.                screen, or write to a file.
  329.           Select a form and print size - 33 formats available
  330.           Select a border line type - None, ASCII dashes, IBM single
  331.                or double lines.
  332.           Change the number of lines to be printed on the list.
  333.           Enter a title for the list.
  334.  
  335.      Read the list of commands from the Control Window figure.  Most
  336.      are self explanatory.  The others are discussed below.
  337.  
  338.      There are two printer modes.  One is for nonlaser (mechanical)
  339.      printers and the other for laser printers.  The difference has to
  340.  
  341.  
  342.                                     -4- 
  343.  
  344.  
  345.  
  346.      do with which set of control codes DISKLIST sends to the printer.
  347.      The control codes for mechanical printers are saved with the
  348.      general setup parameters in the file DISKLIST.PRM and the laser
  349.      printer commands are saved in DISKLIST.LSR.  These will each be
  350.      discussed separately.
  351.  
  352.      As you move through the Format selections with the right and left
  353.      arrows, the Lines Per List data will change to reflect the value
  354.      for that size parameter.  When the Lines Per List parameter is
  355.      selected, a window pops up for entry of the new value.  The
  356.      original value that came with DISKLIST is in parens for your
  357.      reference.
  358.  
  359.      When DISKLIST prints a list that is physically longer than the
  360.      diskette, either 5.25 or 3.5 inches, it will put marks on the
  361.      border indicating where to fold the paper to neatly match the
  362.      disk size.  In the ASCII border line type there is a - instead of
  363.      the |.  In the IBM border line type the horizontal tick mark is
  364.      part of the vertical line and is harder to notice, but it is
  365.      there.  The line this prints on is determined by the value for
  366.      Lines Per Inch.
  367.  
  368.      The border line type selection does not apply when the 8.5 X 11
  369.      Page, any label format, or the Display on the File is selected.
  370.      There are no borders on the 8.5 x 11 Page, Label or File outputs.
  371.      All of the borders are available on the output to the Screen.
  372.      None of the compressed or multiple column modes are available
  373.      when the output is directed to the Screen or File.
  374.  
  375.      For the nonlaser printer, when a mode that uses compressed print
  376.      is selected, DISKLIST combines the codes for compressed on and 8
  377.      lines per inch (in that order) and prints a line with those
  378.      codes.  This will cause the printer to advance one line.
  379.      Likewise, on completion of the list printing, another line with
  380.      the codes for compressed off and 6 lines per inch will be
  381.      printed.  These two blank lines are included in the number of
  382.      lines per list for the nonlaser printer.  So, you can put any
  383.      codes in these parameters.  There is no limit to the number of
  384.      codes you may use.  When a non compressed format is selected, no
  385.      codes are sent to the printer.
  386.  
  387.      For a laser printer, the laser commands are always sent.  There
  388.      is a set of laser commands for each format.
  389.  
  390.      The printer mode with the 8.5 x 11 Page format and the File mode
  391.      are ideal for producing a list of all files on a hard drive and
  392.      saving the list in a loose-leaf notebook.
  393.  
  394.      The C command pops up a Configuration menu for selecting the
  395.      Nonlaser Printer Control Codes (F5), the Laser Commands (F6), the
  396.      Format editor (F7), the date format selector, or to download a
  397.      font (F3).  You may bypass this menu and go directly to these
  398.  
  399.  
  400.                                     -5- 
  401.  
  402.  
  403.  
  404.      functions from the control window by pressing the associated
  405.      function keys.
  406.  
  407.      The format of file dates can only be changed from the
  408.      Configuration menu.  Press 4 until the date format you want to
  409.      use is displayed.  The date formats are:
  410.  
  411.                MM/DD/YY       DD/MM/YY       YY/MM/DD
  412.                MM-DD-YY       DD-MM-YY       YY-MM-DD
  413.                MM.DD.YY       DD.MM.YY       YY.MM.DD
  414.  
  415.      Save your date format from the main control window with the D
  416.      command.
  417.  
  418.      DISKLIST will save the title for a disk in a file on that disk
  419.      with the S command and retrieve it with the R command.  DISKLIST
  420.      also prints the disk volume name at the top of the list.
  421.  
  422.      The E command (Eject Page) sends a form feed to the printer.  The
  423.      L command (Line Feed) sends a carriage return to the printer.
  424.      CTRL R or CTRL E sends the laser printer Reset command, ESC E, to
  425.      the printer (it is not listed on the control window).  When these
  426.      commands are sent, DISKLIST acknowledges by beeping.  If the beep
  427.      is annoying, press CTRL B to turn the beep off, then D to save
  428.      this parameter in the parameter file (DISKLIST.PRM).  Another
  429.      CTRL B will turn the beep on.
  430.  
  431.      Before DISKLIST prints the name of a subdirectory, it prints a
  432.      blank line.  The blank line can be avoided by toggling the
  433.      status of Space to No by pressing the letter A.  See the upper
  434.      right corner of the control window.
  435.  
  436.      Notice the Z - ZIP in the upper right corner of the control
  437.      window.  It signifies the status of DISKLIST reading the file
  438.      directory in ZIP, ARC, PAK, ZOO, and LZH files.  These file names
  439.      are displayed in lower case letters to signify that they are from
  440.      an archive.  Pressing Z toggles the status of this function
  441.      between Yes and No.
  442.  
  443.  
  444.      LIST FORMATS
  445.  
  446.      DISKLIST provides a large selection of list layouts.  Some
  447.      contain all the file information, name, size, date, and time.
  448.      Others contain only the name, or the name and date, or the name
  449.      and size.  You may have from one to six columns of file names on
  450.      a list.  Remember, Label formats do not print any border lines
  451.      and they skip to the beginning of the next label.  They also do
  452.      not print Created by DISKLIST.
  453.  
  454.      The following table lists all of the Formats and indicates which
  455.      use the compressed mode.
  456.  
  457.  
  458.                                     -6- 
  459.  
  460.  
  461.  
  462.                        Sized for
  463.        Format          Diskette  Columns   Info Printed        Pitch     Type
  464.  
  465.      8.5 x 11 Page                  1    Name Size Date Time              List
  466.      3.5  Compressed      3.5"      1    Name Size Date Time  Compressed  List
  467.      3.5  Comp Label      3.5"      1    Name Size Date Time  Compressed  Label
  468.      3.5  2 & Size        3.5"      2         Name Size       Compressed  List
  469.      3.5  2 & Size Lab    3.5"      2         Name Size       Compressed  Label
  470.      3.5  2 & Date        3.5"      2         Name Date       Compressed  List
  471.      3.5  2 & Date Lab    3.5"      2         Name Date       Compressed  Label
  472.      5.25 Normal          5.25"     1    Name Size Date Time              List
  473.      5.25 Norm Label      5.25"     1    Name Size Date Time              Label
  474.      5.25 Compressed      5.25"     2    Name Size Date Time  Compressed  List
  475.      5.25 Comp Label      5.25"     2    Name Size Date Time  Compressed  Label
  476.      5.25 2 & Size        5.25"     2         Name Size                   List
  477.      5.25 2 & Size Lab    5.25"     2         Name Size                   Label
  478.      5.25 2 & Date        5.25"     2         Name Date                   List
  479.      5.25 2 & Date Lab    5.25"     2         Name Date                   Label
  480.      5.25 3 & Size        5.25"     3         Name Size       Compressed  List
  481.      5.25 3 & Size Lab    5.25"     3         Name Size       Compressed  Label
  482.      5.25 3 & Date        5.25"     3         Name Date       Compressed  List
  483.      5.25 3 & Date Lab    5.25"     3         Name Date       Compressed  Label
  484.      5.25 4 & Size        5.25"     4         Name Size       Compressed  List
  485.      5.25 4 & Size Lab    5.25"     4         Name Size       Compressed  Label
  486.      5.25 4 & Date        5.25"     4         Name Date       Compressed  List
  487.      5.25 4 & Date Lab    5.25"     4         Name Date       Compressed  Label
  488.      3.5  3 Across        3.5"      3           Name          Compressed  List
  489.      3.5  3 Across Lab    3.5"      3           Name          Compressed  Label
  490.      5.25 3 Across        5.25"     3           Name                      List
  491.      5.25 3 Across Lab    5.25"     3           Name                      Label
  492.      5.25 4 Across        5.25"     4           Name          Compressed  List
  493.      5.25 4 Across Lab    5.25"     4           Name          Compressed  Label
  494.      5.25 5 Across        5.25"     5           Name          Compressed  List
  495.      5.25 5 Across Lab    5.25"     5           Name          Compressed  Label
  496.      5.25 6 Across        5.25"     6           Name          Compressed  List
  497.      5.25 6 Across Lab    5.25"     6           Name          Compressed  Label
  498.  
  499.      The format to use is selected with item 6, Format, on the control
  500.      window.  There are over 30 selections.
  501.  
  502.      The display at the bottom of the control window screen displays
  503.      information from the above table.  It explains the selected
  504.      format in more detail.  Columns are the number of groups of data
  505.      that are printed on a line and Info Printed is the data in each
  506.      group.  This display can be toggled on and off with CTRL L and
  507.      saved in the parameter file with the D command.
  508.  
  509.      DISKLIST provides a way for you to quickly select a format.  F7
  510.      displays the Format Configuration Editor.  Move the cursor to the
  511.      format you want and press F10.  That will then be the format
  512.      selected to use in the command window.
  513.  
  514.  
  515.  
  516.                                     -7- 
  517.  
  518.  
  519.  
  520.      You can also use the Format Configuration Editor to create a list
  521.      of formats that you want available from the control window.  If,
  522.      for example, you only have a 3.5 inch diskette, then you do not
  523.      want to scan through all the selections for 5.25 inch drives.
  524.      Select or deselect the items you want with the space bar.  Use
  525.      the cursor keys to move around the list.  Press F10 when done.
  526.      Save this configuration with the D key from the control window.
  527.  
  528.      Use the 8.5 x 11 format to list the files on your hard drive and
  529.      put the pages in a notebook for reference.
  530.  
  531.  
  532.      NONLASER PRINTER CONTROL CODES
  533.  
  534.      DISKLIST has a generic set of nonlaser (dot matrix) printer
  535.      control codes.  It only uses the codes to switch to and from
  536.      compressed (17 characters per inch) and regular (10 characters
  537.      per inch), and between 6 and 8 lines per inch for the compressed
  538.      printer modes.  The default generic printer control codes work on
  539.      many printers and have been tested on the Epson FX-86e and IBM
  540.      Proprinter II.
  541.  
  542.      DISKLIST provides a nonlaser printer code editor.  It is
  543.      activated with the C command or directly with F5.  Use it to
  544.      install your printer control codes for these functions if the
  545.      default codes do not work with your printer.  It is easy to do
  546.      this with information supplied in your printer manual.  Save the
  547.      printer control codes in the same file with the other DISKLIST
  548.      parameters with the D command in the control window.
  549.  
  550.      When you enter the editor to change the printer codes, this
  551.      window will pop up.  The figure illustrates an example when key 1
  552.      was pressed to change the codes for compressed on.
  553.  
  554.  
  555.                             NONLASER PRINTER CODES
  556.                     ======================================
  557.                     1 - Compressed ON      15
  558.                     2 - 8 Lines per Inch   27, 48
  559.                     3 - Compressed OFF     18
  560.                     4 - 6 Lines per Inch   27, 50
  561.                     ======================================
  562.                      1 to 4 - Enter the Decimal Codes
  563.                           D - Restore the Default Codes
  564.                           R - Restore Before Entry Codes
  565.                           C - Clear All Codes
  566.                         F10 - Quit and Use these Codes
  567.                     ======================================
  568.                      Enter the codes for Compressed ON
  569.                        ?  15,7,65
  570.  
  571.  
  572.  
  573.  
  574.                                     -8- 
  575.  
  576.  
  577.  
  578.      Printer manuals contain a section or appendix on printer
  579.      commands, software commands, or control codes.  These codes are
  580.      sent from the computer to the printer by DISKLIST to change the
  581.      character size and line spacing.
  582.  
  583.      If DISKLIST doesn't print the directory list in a conventional
  584.      format, use the nonlaser printer code editor to tell DISKLIST
  585.      what codes to send to your printer to make it print correctly.
  586.  
  587.      Your printer manual may have the codes in three different
  588.      formats, ASCII, decimal, and hexadecimal.  Only enter decimal
  589.      codes into DISKLIST.  These are all numbers between the values of
  590.      0 to 127.  There are usually 1 to 3 numbers for each function
  591.      being changed.
  592.  
  593.      Enter all of the numbers for one function on one line and
  594.      separate the numbers with a space or comma.  There is no program
  595.      limit to the number of control codes you may enter.  The above
  596.      figure of the codes window illustrates how a new code is being
  597.      entered for the function Compressed On.
  598.  
  599.      To delete the line of codes on the prompt line, press the ESC
  600.      key.  DISKLIST will only accept numbers from 0 to 255.  It will
  601.      ignore all other numbers and beep as it does.  It will accept any
  602.      quantity of numbers for each function but will only display those
  603.      that fit in the window.
  604.  
  605.      DISKLIST only transmits these codes to the printer when a
  606.      compressed mode is selected.  See the table that defines the
  607.      print formats on or near page 7.
  608.  
  609.      When data on the prompt line exceeds the width of the window,
  610.      then the prompt line scrolls horizontally.  You can then scroll
  611.      the data horizontally with the cursor keys; the display window
  612.      shows only the numbers that fit in the window.
  613.  
  614.      The D command on the Printer Codes window will restore the built
  615.      in codes that came with DISKLIST.
  616.  
  617.      If you want to print the IBM graphic lines on a DISKLIST listing,
  618.      then you must select the IBM mode on your printer.  Try printing
  619.      a directory list with the IBM lines selected in DISKLIST with the
  620.      Border Line Type parameter.  If it does not print the IBM lines,
  621.      read your printer manual to locate the switch to flip to activate
  622.      this mode on your printer.  This applies to dot matrix printers
  623.      only.
  624.  
  625.      If you do not have a laser printer, you may delete the file
  626.      DISKLIST.LSR so DISKLIST doesn't have to read it.
  627.  
  628.  
  629.  
  630.  
  631.  
  632.                                     -9- 
  633.  
  634.  
  635.  
  636.      LASER COMMANDS
  637.  
  638.      DISKLIST has a set of laser commands for each format that are in
  639.      the file DISKLIST.LSR.  It also has a laser command editor,
  640.      accessed with F6, so you can easily change them.  The laser
  641.      commands are setup in the following categories:
  642.  
  643.                              Symbol
  644.                              Spacing
  645.                              Pitch & Point Size
  646.                              Orientation
  647.                              Top Margin
  648.                              Lines per inch
  649.                              Left Margin, Row
  650.  
  651.                              Reset
  652.  
  653.      You can put any commands on any line.  These categories are for
  654.      reference only.  Just remember, when laser printer is selected,
  655.      DISKLIST concatenates all of the commands in the first 7
  656.      categories and sends them to the printer.  After the list is
  657.      printed, DISKLIST sends the commands in the eighth category,
  658.      Reset.  You don't have to have any laser commands, and there is a
  659.      key (F8) to delete all commands for a format.  Or, you can delete
  660.      the file DISKLIST.LSR and that will clear out all of the commands
  661.      and DISKLIST will still run.
  662.  
  663.      Laser commands are all printable ASCII characters except ESC.
  664.      The IBM character set displays ESC as a left pointing arrow.  So
  665.      does DISKLIST.  To enter ESC on the command line, just press the
  666.      ESC key.  Now, since the ESC key is used for input, how do you
  667.      get out of the editor?  Press Function Key 10.  To be consistent,
  668.      DISKLIST will quit all functions when F10 is pressed.
  669.  
  670.      There is a space after ESC in this documentation for clarity.  In
  671.      the actual HP laser command there is no space.  In the laser
  672.      command editor the ESC is displayed as a left arrow with no
  673.      space.
  674.      The laser editor has the following functions:
  675.  
  676.                          F1 - Help
  677.                          F2 - Copy to Pass Buffer
  678.                          F3 - Insert from Pass Buffer
  679.                          F6 - Insert Default Commands
  680.                          F7 - Clear Active Command Line
  681.                          F8 - Clear All Commands for this size
  682.                          F9 - Save All Commands for all sizes
  683.                         F10 - EXIT
  684.  
  685.      When in the laser editor, you may change to another format with
  686.      F11 & F12, or ALT or Control with the left and right arrows.
  687.  
  688.  
  689.  
  690.                                     -10- 
  691.  
  692.  
  693.  
  694.      The file DISKLIST.LSR is an ASCII file.  It can be edited with a
  695.      text word processor like PC-WRITE.  Each format has an ID number.
  696.      These numbers and the format name are written to the file so you
  697.      can locate the commands.  When DISKLIST reads this file, it uses
  698.      the ID number to identify the format, but it ignores the name.
  699.      It only needs the commands for the formats that you want to use,
  700.      and the formats do not have to be in sequence in this file.
  701.  
  702.      The default laser commands include a reset command ESC E with the
  703.      symbol command ESC (10U.  The HP reset command is ESC E.  If you
  704.      want to print more than one list on a page, then remove both of
  705.      the reset commands (ESC E) because it forces a form feed.  You
  706.      may then force a form feed with E for Eject Page or CTRL R from
  707.      the control window.  CTRL R sends the laser command ESC E to the
  708.      printer.  So does CTRL E, ALT R, & ALT E.
  709.  
  710.      The top margin command is ESC &l#E.  That is a lowercase L before
  711.      the # sign and not the number 1.  Replace the # with the line
  712.      number of the top line of the label.
  713.  
  714.      You may want to change the laser commands that control the
  715.      position of the left margin and row.  The default commands for
  716.      these are ESC &a0l0R.  Again that is a lower case L between two
  717.      numeric zeros.  These define the upper left corner of the list.
  718.      Replace the first zero with the number of the column to start the
  719.      list (left margin) and the second with the line number (row).
  720.  
  721.      Laser commands that you may want to change to adjust where the
  722.      label is printed are the left margin and row.  The default
  723.      commands for these are ESC &a0l0R.  Again that is a lower case l
  724.      between two numeric zeros.  These define the upper left corner of
  725.      the list.  Replace the first zero with the number of the column
  726.      to start the list (left margin) and the second with the line
  727.      number (row).
  728.  
  729.      F2 and F3 operate a pass buffer.  They are used to copy the laser
  730.      commands one format to another.  F2 copies the laser commands
  731.      from the displayed format to the pass buffer.  Select another
  732.      format, press F3 and the laser commands from the pass buffer are
  733.      copied to this format.
  734.  
  735.      F9 saves all the laser commands to the file DISKLIST.LSR.  F6
  736.      will replace all the laser cammands for one format with the
  737.      default laser commands that were originally in DISKLIST.LSR.
  738.  
  739.      DISKLIST prints the disk volume name and the title in bold
  740.      italic.  If the font does not have bold italic, the printer will
  741.      print normal.  The command that is sent for bold italic is
  742.      ESC (s1s7B and to return to normal, ESC (s0s0B.  These commands
  743.      are coded into DISKLIST and you can't change them easily.  If
  744.      this causes problems with any printer, please let me know and I
  745.      will fix the problem.
  746.  
  747.  
  748.                                     -11- 
  749.  
  750.  
  751.  
  752.      If you are only going to use DISKLIST with a laser printer, I
  753.      suggest that you remove all nonlaser printer codes.  See the
  754.      previous section on Nonlaser Printer Control Codes.  Use the C
  755.      command to clear all codes then exit.  Select Laser Printer for
  756.      item 5 on the Control Window then press D to save the parameters.
  757.      This will prevent the accidental sending of nonlaser codes to a
  758.      laser printer.
  759.  
  760.      See the file DISKLASR.DOC for additional information on laser
  761.      commands.
  762.  
  763.  
  764.      LASER DOWNLOAD
  765.  
  766.      DISKLIST will download your soft fonts for you.  Here's how.
  767.  
  768.      Create an ASCII file with a text editor or word processor.  Name
  769.      this file DISKLIST.FNT.  Insert the DOS file name and a
  770.      description of the font.  Place a comma after the DOS file name.
  771.      You may enter up to 10 names, each must be on a different line.
  772.      Example:
  773.  
  774.              CO085R16.USP, Courier 8.5 Point 16.6 Pitch
  775.              RO100R12.UPS, Times Roman 10 Point 12 Pitch
  776.  
  777.      Copy your font files and DISKLIST.FNT to the directory with
  778.      DISKLIST.EXE.  Fonts do not come with DISKLIST.
  779.  
  780.      The download section is accessed by pressing F3 from the Control
  781.      window, or selection 5 from the configuration window.  DISKLIST
  782.      will display the file names and fonts and you select the one to
  783.      download.  DISKLIST will download the font and select it.  The HP
  784.      command codes that DISKLIST uses are given in the file
  785.      DISKLIST.LZR.
  786.  
  787.      You may have to change the laser commands, particularly the Lines
  788.      per inch, to properly utilize this font, or delete them all with
  789.      F8.  You may also want to change the Lines per List, parameter 8
  790.      in the Command window.
  791.  
  792.  
  793.      TEXT INPUT
  794.  
  795.      There are several prompts where DISKLIST asks for text input.
  796.      All follow these rules.  DISKLIST always presents the previous
  797.      data in that field for you to edit if you wish.  ESC will erase
  798.      the entire line.  All standard editing features of the computer
  799.      are available: insert, delete, home, end, left and right arrows.
  800.  
  801.      DISKLIST has a novel feature.  If you want to enter more
  802.      characters than will fit into the input window, then DISKLIST
  803.      scrolls the text sideways.  All data will not be displayed in the
  804.  
  805.  
  806.                                     -12- 
  807.  
  808.  
  809.  
  810.      text window, but it will be used.  One exception is the filespec
  811.      input.  It will truncate any input to eight characters before the
  812.      period and three after the period to comply with DOS standards.
  813.  
  814.      When a title for a disk is entered, it will be displayed at the
  815.      bottom of the control window as illustrated by the text in the
  816.      control window display above, "The List Title is Displayed Here".
  817.      To reuse the title, save it with the S command.  DISKLIST will
  818.      save it on the disk drive selected by parameter 1 on the control
  819.      window.  Retrieve it the next time with the R command.
  820.  
  821.      Press RETURN or the up or down arrow when you are finished with a
  822.      text input.
  823.  
  824.  
  825.      STATUS MESSAGES
  826.  
  827.      Status messages are displayed in a pop up window.  In some cases,
  828.      such as error messages, you are prompted to press any key to
  829.      continue.  In other cases, such as completion messages, they are
  830.      displayed for a few seconds then go away.  You do not have to
  831.      wait for these latter messages to go away before entering a
  832.      command.
  833.  
  834.      When you are producing a list, DISKLIST will display the path and
  835.      file names as it prints them in a status window.  Sometimes this
  836.      goes too fast to read, but the purpose is to let you know that
  837.      something is happening.  DISKLIST will STOP PROCESSING a list IF
  838.      ANY KEY IS PRESSED and beeps to alert you that it stopped
  839.      prematurely.
  840.  
  841.      DISKLIST requires 256 K of free memory and DOS 2.1 or later.
  842.  
  843.  
  844.      MONOCHROME MONITOR
  845.  
  846.      The highlight of the selected parameter in the Control Window and
  847.      the Format Selection Window may not be visible on monochrome
  848.      monitors.  To make it possible for such users to know which
  849.      parameter is selected, press M to toggle the display of arrows
  850.      before the item on and off.
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.                                     -13- 
  865.  
  866.  
  867.  
  868.      SUMMARY OF NON-DISPLAYED COMMANDS.
  869.  
  870.            M   Toggles display arrows for monochrome monitors.
  871.           ^B   Toggles the blind command action beeper on/off.
  872.           ^L   Toggles display of Format data at bottom of screen.
  873.           ^E   Sends the laser printer reset command ESC E.
  874.           ^R   Sends the laser printer reset command ESC E.
  875.  
  876.      ^ means hold the Control Key down, then press the letter.  You
  877.      may use the ALT key instead of the Control Key for these four
  878.      keys.
  879.  
  880.  
  881.      FILENAMES
  882.  
  883.      The names and purpose of all DISKLIST system files are listed
  884.      below.  There are no hidden files.  Only the first four files are
  885.      distributed with DISKLIST.  The next three are created by it, and
  886.      the last is created by you.
  887.  
  888.           DISKLIST.EXE    Program
  889.           DISKLIST.DOC    Documentation
  890.           DISKLIST.LSR    HP LaserJet Commands for each format
  891.           DISKLASR.DOC    Additional documentation on laserjet commands
  892.  
  893.           DISKLIST.PRM    Saved program configuration & nonlaser
  894.                           printer control codes
  895.           DISKLIST.TTL    Disk title
  896.           DISKLIST.TXT    Default file name or a list output to a disk
  897.           DISKLIST.FNT    File containing names of your softfonts
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.                                     -14- 
  923.  
  924.  
  925.  
  926.      DISKFLAP
  927.  
  928.      Lists for 5.25 inch disks can be kept in the disk sleeve.  Some
  929.      3.5 inch disks have plastic sleeves, but few people use them.
  930.      DISKLIST lists can be attached to a 3.5 inch disk in a way that
  931.      allows them to remain attached when inserted in most floppy
  932.      drives.  The list can even be read when it is in horizontal
  933.      drives.
  934.  
  935.      This is accomplished by tapping the list to the back of the
  936.      diskette with one small piece of tape placed along the edge of
  937.      the diskette that doesn't go into the drive.  You then have a
  938.      list that stays attached to the diskette even when it is inserted
  939.      in the drive.
  940.  
  941.  
  942.         Edge of disk that
  943.         does not go into drive
  944.         _______=====________             _ <-----Masking Tape Hinge
  945.        |                    |           | |\
  946.        |                 [] |           | | \
  947.        |                    |           | |  \
  948.        |                    |           | |   \<------ List printed
  949.        |         0          |           | |    \       by DISKLIST
  950.        |                    |           | |     \      Printed side
  951.        |      Front of      |           | |      \     out
  952.        |     3.5 " disk     |           | |       \
  953.        |                    |           | |        \
  954.         \___________________|           |_|
  955.  
  956.  
  957.              Front View              Side View
  958.  
  959.  
  960.      The tape only has to be 3/4 to 1 inch by 1/2 inch.  When you cut
  961.      the list out, leave about 1/4 inch of paper above the printed
  962.      frame of the list.  Place the list on the back of the disk with
  963.      the top edge of the list along the back edge of the disk,
  964.      printed side out.  Tape the list to the disk.
  965.  
  966.      The tape acts as a hinge so the list can fold against the disk
  967.      for storage, or fold straight out away from the disk when the
  968.      disk is inserted into the drive.  Masking tape works best and the
  969.      list can be pulled from the tape to be replaced.  Scotch tape
  970.      also works.
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.                                     -15- 
  981.  
  982.  
  983.  
  984.      SHAREWARE
  985.  
  986.      DISKLIST is NOT a public domain program.  It is copyrighted and
  987.      distributed as Shareware.  DISKLIST may be distributed on
  988.      bulletin boards, by computer user groups and by disk vendors.
  989.      DISKLIST.EXE, DISKLIST.DOC, and DISKLIST.LSR must be distributed
  990.      together and unaltered.
  991.  
  992.      If after evaluating DISKLIST, you decide to use it or keep it for
  993.      when you will need it, then you MUST submit the registration fee.
  994.      The registration form must be printed from DISKLIST with the F
  995.      command.
  996.  
  997.      When you register DISKLIST you will receive:
  998.  
  999.            Telephone and mail support.
  1000.            A copy of the latest version of DISKLIST
  1001.            Removal of Registration Screen & reminders.
  1002.            Skip the Help screen at start of the program.
  1003.            Skip the Registration Form reminder at the end
  1004.              of the program.
  1005.            A loan amortization program with both the
  1006.              BASIC source code and the compiled
  1007.              program.  No registration is required for
  1008.              the amortization program. 
  1009.            Copies of PC-ACCOUNT and SHERLOCK for you
  1010.              to try before registering.
  1011.  
  1012.      You will also receive a free introductory membership certificate
  1013.      to CompuServe with a $15.00 credit towards online time.
  1014.  
  1015.      Your registered copy of DISKLIST will NOT display the initial
  1016.      Shareware title screen, the registration reminders, or the
  1017.      initial or laser command setup help screens.
  1018.  
  1019.      Because I will send you all of this software, please indicate on
  1020.      the registration form the size of the floppy disks that you can
  1021.      use.
  1022.  
  1023.      The registration fee is 25.00.  Maryland residents add 5% state
  1024.      sales tax ($1.25).  Orders outside of the United States add $3
  1025.      for postage & handling unless you are sending $25 in travelers
  1026.      checks.  All checks and money orders must be in US funds and
  1027.      drawn on a US bank.  Visa or MasterCard may be used.
  1028.  
  1029.      Most copies of software on bulletin boards and even in software
  1030.      vendor libraries are not the latest version.  It takes a long
  1031.      time for these to get around, and most of the effort is placed on
  1032.      the widest distribution of the initial release.  And with so much
  1033.      emphases being placed on 'safe software' these days, where is
  1034.      there a more reliable place to obtain your software than directly
  1035.      from an ASP author.
  1036.  
  1037.  
  1038.                                     -16- 
  1039.  
  1040.  
  1041.  
  1042.      The following is the schedule of the multi-copy license fees.
  1043.      The fee includes one master diskette which you may then copy and
  1044.      use on the number of machines listed below:
  1045.  
  1046.                    # Users        Price
  1047.                    -------       -------
  1048.                       5        $  100.00   ($20 per copy)
  1049.                      10           140.00   ($19 per copy)
  1050.                      25           425.00   ($17 per copy)
  1051.                      50           750.00   ($15 per copy)
  1052.                     100         1,200.00   ($12 per copy)
  1053.                    Site         2,500.00
  1054.  
  1055.      For corporate, educational institution, and network discounts,
  1056.      contact Gulf Sierra.
  1057.  
  1058.      Once in a while DISKLIST will act like it is registered for non
  1059.      registered users.  It starts running without the shareware screen
  1060.      and displays a window with the message 'Will Run as if
  1061.      REGISTERED' just to show you how it will run when registered.
  1062.  
  1063.  
  1064.      EPILOGUE
  1065.  
  1066.      Please report discrepancies (bugs) that you find in DISKLIST.
  1067.      Include sufficient information for me to replicate the incident.
  1068.      When I correct a bug, the person who reported it gets the first
  1069.      copy.
  1070.  
  1071.      Whenever you write, please include your home phone number.  You
  1072.      can also send CompuServe mail to me.  My CompuServe ID is
  1073.      73270,77.  I usually answer questions by phone on the weekend or
  1074.      early in the evening Eastern time.
  1075.  
  1076.      If you do not like DISKLIST, please let me know that you tried it
  1077.      and, if you wish, why you will not use it again.  Tell me what
  1078.      features would have made DISKLIST useful to you.  Perhaps you had
  1079.      a problem because I didn't clearly convey how to use it.  Many
  1080.      features in my software were suggested by people who did not
  1081.      register.  And of course, many more were suggested by those who
  1082.      did.  You may use the registration form to reply and cross out
  1083.      the word Registration.
  1084.  
  1085.  
  1086.      COMMERCIAL LABELS
  1087.  
  1088.      One company that produces stick on labels for both form fed
  1089.      printers and laser printers is Avery.  These labels are available
  1090.      from many office supply stores and catalogs.  The form fed labels
  1091.      work very well.  The laser labels are difficult to use because
  1092.      you must set the left margin and row for each label on the sheet.
  1093.      There are nine 3.5 and twelve 5.25 disk labels to a sheet.  Avery
  1094.  
  1095.  
  1096.                                     -17- 
  1097.  
  1098.  
  1099.  
  1100.      says a laser sheet can only be run through the printer once.  A
  1101.      future version of DISKLIST may automatically position the
  1102.      printing of laser labels so that many lists can be printed on one
  1103.      sheet.  Let me know if you want that.
  1104.  
  1105.      The Avery disk labels are:                               Catalog
  1106.                                                 Label Size    Number
  1107.  
  1108.      For 3.5" disks and form fed printers       2.75 x 2.75    4241
  1109.      For 5.25" disks and form fed printers      1.25 x 4.75    4240
  1110.  
  1111.      For 3.5" disks and laser printers          2.75 x 2.75    5196
  1112.      For 5.25" disks and laser printers         1.50 x 4.00    5197
  1113.  
  1114.  
  1115.      OMBUDSMAN
  1116.  
  1117.      I am a member of the Association of Shareware Professionals
  1118.      (ASP).  ASP wants to make sure that the Shareware principle works
  1119.      for you.  If you are unable to resolve a Shareware-related
  1120.      problem with an ASP member by contacting the member directly, ASP
  1121.      may be able to help.
  1122.  
  1123.      The ASP Ombudsman can help you resolve a dispute or problem with
  1124.      an ASP member, but does not provide technical support for
  1125.      members' products.  Please write to the ASP Ombudsman at 545
  1126.      Grover Road, Muskegon, MI 49442-9427 or send a CompuServe message
  1127.      via CompuServe mail to ASP Ombudsman 70007,3536.
  1128.  
  1129.  
  1130.  
  1131.  
  1132.  
  1133.  
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.  
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.                                     -18- 
  1155.  
  1156.  
  1157.  
  1158.      IBM GRAPHICS EXAMPLE
  1159.  
  1160.      This is an example of another format for the DISKLIST output.  It
  1161.      can be seen on the computer screen and printed on a printer setup
  1162.      for IBM graphics.  If this figure is not framed in continuous
  1163.      lines, then your printer is not setup for IBM graphics.  Read your
  1164.      printer manual to determine if it is possible to switch to that
  1165.      mode.  Otherwise, you can still use DISKLIST with the ASCII
  1166.      character frame as illustrated on page 1.
  1167.  
  1168.  
  1169.  
  1170.              ┌────────────────────────────────────────────────┐
  1171.              │               GREAT SHAREWARE                  │
  1172.              │           Volume ID is DISKLIST                │
  1173.              │ 1,457,664 Total Space    893,440 Bytes Free    │
  1174.              ├────────────────────────────────────────────────┤
  1175.              │ A:\                             153,664 BYTES  │
  1176.              │   DISKLIST.DOC    34,377  08/15/90  19:32:16   │
  1177.              │   DISKLIST.EXE   119,144  08/14/90  22:02:18   │
  1178.              │   DISKLIST.PRM       124  03/25/90  11:11:48   │
  1179.              │   DISKLIST.TTL        19  03/25/90  11:05:06   │
  1180.              │                                                │
  1181.              │ A:\PC-ACCOU.NT                  230,862 BYTES  │
  1182.              │   PCACT220.EXE   156,150  11/08/89  19:03:52   │
  1183.              │   PCACT220.TXT     6,838  11/09/89  18:30:42   │
  1184.              │   PCDOC220.EXE    67,874  11/08/89  19:09:22   │
  1185.              │                                                │
  1186.              │ A:\SHERLOCK                     175,967 BYTES  │
  1187.              │   SHERLOCK.DOC    30,895  08/15/90  19:35:14   │
  1188.              │   SHERLOCK.EXE   145,072  08/15/90  19:44:04   │
  1189.              ├────────────────────────────────────────────────┤
  1190.              │        9 Files   08-17-1990   18:46:20         │
  1191.              │                                                │
  1192.              │                                                │
  1193.              │                                                │
  1194.              │                                                │
  1195.              │                                                │
  1196.              │                                                │
  1197.              │                                                │
  1198.              │                           Created by DISKLIST  │
  1199.              └────────────────────────────────────────────────┘
  1200.  
  1201.  
  1202.      This is shown in the 5.25 inch normal format.  DISKLIST can also
  1203.      print it in 32 other formats.
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.                                     -19- 
  1213.