home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / D53.ZIP / D.DOC < prev    next >
Text File  |  1990-12-12  |  11KB  |  281 lines
  1.  
  2.                           D.EXE - Version 5.3
  3.                     An Alternative Directory Lister
  4.  
  5.                Copyright 1986 - 1990  FreeLance Programming
  6.                           All rights reserved
  7.  
  8.  
  9. Usage: D[.EXE] [FILESPEC] [/F] [/M] [/W] [/N] [/E] [/S] [/D] [/T]
  10.  
  11.   Where: 
  12.  
  13.     FILESPEC specifies the files to be searched for, and may include
  14.              drive and/or directory information.  Wildcards are permitted
  15.              only in the filename/extension portion(s) of the specification.
  16.              In general, anything that the DIR command accepts, so should D.
  17.              If omitted, the default is to search for *.* in the current dir.
  18.  
  19.     /F - This switch controls screen flicker.  If you experience "snow" on
  20.          your display while D is running, you can use this switch to eliminate
  21.          it.  If snow suppression has been made the default (via the setup
  22.          utility), use of this switch will turn OFF the suppression feature.
  23.          This switch is valid ONLY for the DOS-only version of D.
  24.  
  25.     /M - Uses monochrome attributes when displaying rather than
  26.          color attributes.  Use of this switch will override the
  27.          default read from your system board switch settings.  This
  28.          switch changes the actual colors only; the address of the
  29.          screen memory is determined by the operating system.  If the
  30.          setup utility has been used to make this the default, use of
  31.          this switch will cause the color attributes to be used.
  32.  
  33.     /W - Displays files in 1 column, including date, time, and attributes.
  34.          The default is 4-column mode (name/size only).  Note that ALT-W
  35.          can be used to toggle displayed listings between these two modes.
  36.          If the setup utility has been used to make this the default, use
  37.          of this switch will cause the display to revert to 4-column mode.
  38.  
  39.     /N - Sort files by file name
  40.     /E - Sort files by extension
  41.     /S - Sort files by size
  42.     /D - Sort files by date
  43.     /T - Sort files by time
  44.  
  45.          The order in which a sort switch appears determines its place in 
  46.          the sort order.  Sort switches should be specified in descending
  47.          order of priority.  The default is to display the files in unsorted
  48.          order.  If the same switch is specified more than once, only the
  49.          first instance of that switch is considered.  If the setup utility
  50.          has been used to specify a default sort order, use of any of these
  51.          switches will cause that default order to be ignored.  Note that
  52.          if a default sort order IS specified via the setup utility, there
  53.          is no way to revert to the unsorted order (except to change the
  54.          default with the setup utility).
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                           D.EXE - Version 5.3
  62.                     An Alternative Directory Lister
  63.  
  64.                                - 2 -
  65.  
  66.  
  67. About D.EXE:
  68.  
  69. When executed, D will display the indicated volume name, the (resolved)
  70. file specification being searched for, all matching files/directories
  71. (including HIDDEN, SYSTEM, and READ-ONLY files), and some statistics on
  72. the space in-use and available on the indicated drive.
  73.  
  74. At this point, you can use PgUp or PgDn to scroll thru multi-page displays,
  75. if there are more files than will fit on a single page.  (The current page #
  76. and the total # of pages is displayed in brackets in the lower left corner
  77. of the screen.)  Pressing ESC (or Q) will exit to DOS.  Pressing ALT-W will
  78. toggle the screen between the 1-column and 4-column display versions.
  79.  
  80. In addition to the current and total page #s, the totals line at the bottom
  81. of the screen contains (in order) the # of matching files found, the # of
  82. matching sub-directories found, the space used by all matching files, the
  83. total space in use on the indicated drive, and the total space remaining on
  84. the indicated drive.  If the total # of files or sub-directories is zero,
  85. the appropriate total field is omitted from the display.  Note that the # of
  86. sub-directories found does NOT include the "." and ".." entries, if present.
  87.  
  88. Due to the way DOS and OS/2 allocate files, each file may contain "wasted"
  89. space.  When run under OS/2, the number display for "total space used by
  90. all matching files" accounts for this "wasted" space, and thus reflects the
  91. actual amount of space in use.  Under DOS, this total reflects only the sum
  92. of the file sizes shown.  In either case, the total amount of space left on
  93. the drive is accurate.
  94.  
  95. When displaying files larger than 999,999 bytes, D will not display the file
  96. size.  Instead, ****** will be displayed in its place.  Also, the totals at
  97. the bottom of the screen may omit high-order digits if the space on the drive
  98. exceeds 999,999,999 bytes.
  99.  
  100.  
  101. About SETUP.EXE:
  102.  
  103. Usage is:  SETUP[.EXE] DIRNAME.EXE
  104.  
  105.   Where: DIRNAME.EXE is the name of the executable file to change.
  106.  
  107. SETUP.EXE is capable of modifying any of the three versions of D.  However,
  108. it will only execute under DOS; no OS/2 version of this utility is provided.
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                           D.EXE - Version 5.3
  120.                     An Alternative Directory Lister
  121.  
  122.                                - 3 -
  123.  
  124.  
  125. D is a shareware product from FreeLance Programming.  If you find this
  126. program to be useful, you are STRONGLY URGED to register your copy.  To
  127. register, send a contribution ($5 suggested) to the following address:
  128.  
  129.  
  130.                          FreeLance Programming
  131.                           Post Office Box 726
  132.                        Washington, DC  20044-0726
  133.  
  134.              Please make checks payable to: FreeLance Programming
  135.  
  136.  
  137. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  138.  
  139.  
  140.      For this and other fine FreeLance Programming products, call:
  141.  
  142.                         The Wizard's Workshop
  143.  
  144.                          (301) - 322 - 8678
  145.                          (301) - 322 - 2115 ($$$)
  146.  
  147.        24 hours/day     300/1200/2400     8/N/1     120+ Megabytes
  148.  
  149.  
  150. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  151.  
  152.  
  153. Change Log:
  154.  
  155.  
  156. Version   Comments / Changes / Etc
  157. -------   --------------------------------------------------------------
  158.  
  159.     1.0   Initial Release.  D was designed as an alternative directory
  160.           listing utility, providing a FAST display of file names,
  161.           extensions and sizes, and displaying more information about
  162.           disk space usage.
  163.  
  164.     2.0   This really should have been a 1.1 release, as it only
  165.           addressed correcting the 'Filespec: ' portion of the display.
  166.           This release had a nasty bug in it, but since I use this
  167.           program almost exclusively, it was caught and stomped within
  168.           24 hours.
  169.  
  170.     2.1   This release fixed the bug in version 2.0.
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.                           D.EXE - Version 5.3
  178.                     An Alternative Directory Lister
  179.  
  180.                                - 4 -
  181.  
  182.  
  183. Change Log - Continued:
  184.  
  185.  
  186. Version   Comments / Changes / Etc
  187. -------   --------------------------------------------------------------
  188.  
  189.     3.0   This really was a major release.  New features added were:
  190.  
  191.           - A bug causing this program not to work with mono display
  192.             adapters has (finally) been stomped.
  193.  
  194.           - Displayed files can now be SORTED by any combination
  195.             of file characteristics (modifiable default is unsorted)
  196.  
  197.           - READ-ONLY files now cause the 1st char of the file name
  198.             to be hilited.
  199.  
  200.           - HIDDEN files cause the entire file name to be hilited
  201.             (unless the file is also READ-ONLY, in which case both
  202.             attributes are displayed (in different colors).
  203.  
  204.           - SYSTEM files cause the file SIZE to be hilited.
  205.  
  206.           - ALL colors (there are currently 13) and many default
  207.             options can be easily changed with a simple DEBUG script.
  208.  
  209.           - PgUp/PgDn to swap pages of multiple-page listings
  210.             (Esc or Q to Exit.  Not used if there is only 1 page.)
  211.  
  212.           - Several other options were introduced.
  213.  
  214.     3.1   Two known bugs were killed in this release.  They are:
  215.  
  216.           - Not handling a variety of multi-dir path requests, such
  217.             as "D \DIRx\DIRy" (though \DIRx\DIRy\ did & does work).
  218.  
  219.           - Only displaying page 1 of 2 if there were exactly 84
  220.             files in the dir being displayed (regardless of sub-dirs).
  221.  
  222.           - Also in this release, PgUp/PgDn 'rollover' was implemented.
  223.             PgUp from the 1st page of any listing will go to the last
  224.             page, and vice-versa.
  225.  
  226.     3.2   A bug in the PgUp/PgDn rollover was fixed.  This was causing
  227.           divide overflows & system lock-ups under certain conditions.
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.                           D.EXE - Version 5.3
  236.                     An Alternative Directory Lister
  237.  
  238.                                - 5 -
  239.  
  240.  
  241. Change Log - Continued:
  242.  
  243.  
  244. Version   Comments / Changes / Etc
  245. -------   --------------------------------------------------------------
  246.  
  247.     3.3   The input parsing routines were changed to prevent the current
  248.           directory from being displayed when an invalid directory was
  249.           requested.  D now recognizes invalid drive and invalid dir
  250.           requests, with appropriate error messages.
  251.  
  252.     4.0   Added OS/2 compatibility.  D now runs under OS/2, the OS/2 Dos
  253.           Box, or any Dos 3.x environment.  D now always waits for a
  254.           keystroke before exiting.  Use ESC to exit, or ALT-W to switch
  255.           between the "wide" (4 column) and "narrow" (1 column) displays.
  256.           The "wide" display mode was changed to a single column in order
  257.           to include a display of the file attributes (if any).
  258.  
  259.     5.0   The DOS-only version of D (formerly available only as version 3.3)
  260.           was upgraded for compatibility with the 4.0 release.  In addition,
  261.           several minor bug fixes were implemented to both versions; mostly
  262.           in the area of resolving entered filespecs.  Also, the totals on
  263.           the totals line were increased from a maximum of 99,999,999 bytes
  264.           to 999,999,999 bytes.  Finally, a setup program was added to make
  265.           custom configuration easier.
  266.  
  267.     5.1   A minor bug was fixed in the OS/2 version(s).  When using PgUp to
  268.           go to a page which had only 1 file to display, the full page prior
  269.           to he one containing the single file was actually being displayed,
  270.           and the current page number would be incorrect.  The DOS-only
  271.           version handled this situation correctly.
  272.  
  273.     5.2   Another minor bug was fixed (in both versions).  If a filespec was
  274.           entered with both dir and filename info (as in: C:\UTILS\*.COM),
  275.           the filename info was ignored, and *.* used in its place (as in:
  276.           C:\UTILS\*.*).
  277.  
  278.     5.3   Yet another minor bug was fixed (in the DOS version).  If there was
  279.           insufficient memory to execute, D would display an error message,
  280.           and promptly crash while trying to exit.
  281.