home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / OS2D40.ZIP / D.DOC next >
Text File  |  1988-10-18  |  8KB  |  183 lines
  1.  
  2.                           D.EXE - Version 4.0
  3.                     An Alternative Directory Lister
  4.  
  5.                            (Now for OS/2!)
  6.  
  7.               Copyright 1987, 1988  FreeLance Programming
  8.                           All rights reserved
  9.  
  10.  
  11. Usage: D FILENAME  /M /W /N /E /S /D /T
  12.  
  13. Where FILENAME may be any valid Dos 2.x+ file name (drive:dir\name.ext)
  14.  
  15. Note that both the file specification and all switches are optional.
  16. Defaults are:
  17.     FILENAME: *.* in current directory
  18.         SORT: None
  19.      MONITOR: Based on hardware switch settings
  20.  
  21. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  22.  
  23. D is a user-support program that has seen many hours of work.  It is
  24. currently a 1600+ line ASM program, and I have ideas for at least one
  25. (probably two) more major revision(s).  If you like this program, and
  26. especially if you are interested in the future upgrades, please help
  27. defray the cost of its development by sending $1 to:
  28.  
  29.                         FreeLance Programming
  30.                         PO Box 726
  31.                         Washington, Dc  20044-0726
  32.  
  33. Please be honest about payment.  If you use it, pay for it.  If you
  34. don't use it, then feel free to pass it around and delete your copy.
  35. Registered users will receive notice of all upgrades and such support
  36. as I can offer.
  37.  
  38. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  39.  
  40.                      About the Program:
  41. 1) Specifying the files to be displayed :
  42.    D accepts ALL wild cards (?, *, . and ..).  Generally, anything
  43.    that is a valid file specification for the Dos DIR command is valid
  44.    as the FILENAME on the execution line (and sometimes more besides).
  45.  
  46. 2) Scrolling thru the listing :
  47.    As of this rev, D always displays the current page # and maximum #
  48.    of pages in the lower-left corner, and waits for keyboard input.
  49.    Pressing PgUp or PgDn will scroll thru multi-page listings; ESC or
  50.    Q will exit to Dos, and ALT-W will toggle between the two display
  51.    modes (1 column or 4 column).
  52.  
  53. 3) The statistics line :
  54.    The bottom line of each screen contains the following information:
  55.    - The current page # & total # of pages
  56.    - The total # of files in this directory
  57.    - The total # of SUB-dirs in this directory
  58.      (Does NOT include the . and .. sub-directory entries)
  59.    - The total amount of space used by all files in this directory
  60.      (Does NOT include space used by sub-directories)
  61.    - The total amount of space used by all files on the disk
  62.    - The total amount of free space left on the disk
  63.  
  64.    Note that under OS/2, all "space used" totals are rounded up to the
  65.    nearest allocation size, to reflect the space the files are actually
  66.    taking up.  Under Dos, these totals reflect the actual sizes of the
  67.    files, but do not account for 'wasted' space.
  68.  
  69. 4) Command switches :
  70.    Switches, if used, must follow the FILENAME (if any), and must
  71.    be seperated by at least one space.  A complete list of command
  72.    line switches and their explanations appears below:
  73.  
  74.   /M - Uses monochrome attributes when displaying rather than
  75.        color attributes.  Use of this switch will override the
  76.        default read from your system board switch settings.  This
  77.        switch changes the actual colors only; the address of the
  78.        screen memory is determined by the operating system.
  79.  
  80.   /W - Displays files in 1 column, including date, time, and attrs.
  81.        The default is 4 colum mode (name/size only).  Note that ALT-W
  82.        can be used to toggle displayed listings between these two modes.
  83.  
  84.   /N - Causes sorting by file name
  85.   /E - "                    " extension
  86.   /S - "                    " size
  87.   /D - "                    " date
  88.   /T - "                    " time
  89.  
  90.      ┌──────────────────────────────────────────────────────────┐
  91.      │                                                          │
  92.      │            Sort Switches:                                │
  93.      │ The order in which a switch appears determines its place │
  94.      │ in the sort order.  Any, All, or None of the sort options│
  95.      │ may be selected.  The default is UNSORTED.  Attempts to  │
  96.      │ select the same sort option more than once per run will  │
  97.      │ be ignored (ie: "D /N /E /N" is the same as "D /N /E".   │
  98.      └──────────────────────────────────────────────────────────┘
  99.  
  100. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  101.      For this and other fine FreeLance Programming products, call:
  102.  
  103.                         The Wizard's Workshop
  104.  
  105.                          (301) - 322 - 8678
  106.                          (301) - 322 - 2115 (Contributors only)
  107.  
  108.        24 hours/day     300/1200/2400     8/N/1     90+ Megabytes
  109.  
  110.  
  111. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  112.                               D.EXE
  113.                           (Change Log)
  114.  
  115. Version   Comments / Changes / Etc
  116. -------   --------------------------------------------------------------
  117.     1.0   Inital Release.  D was designed as an alternative directory
  118.           listing utility, providing a FAST display of file names,
  119.           extensions and sizes, and displaying more information about
  120.           disk space usage.
  121.  
  122.     2.0   This really should have been a 1.1 release, as it only
  123.           addressed correcting the 'Filespec: ' portion of the display.
  124.           This release had a nasty bug in it, but since I use this
  125.           program almost exclusively, it was caught and stomped within
  126.           24 hours.
  127.  
  128.     2.1   This release fixed the bug in version 2.0.
  129.  
  130.     3.0   This really was a major release.  New features added were:
  131.  
  132.           - A bug causing this program not to work with mono display
  133.             adapters has (finally) been stomped.
  134.  
  135.           - Displayed files can now be SORTED by any combination
  136.             of file characteristics (modifiable default is unsorted)
  137.  
  138.           - READ-ONLY files now cause the 1st char of the file name
  139.             to be hilited.
  140.  
  141.           - HIDDEN files cause the entire file name to be hilited
  142.             (unless the file is also READ-ONLY, in which case both
  143.             attributes are displayed (in different colors).
  144.  
  145.           - SYSTEM files cause the file SIZE to be hilited.
  146.  
  147.           - ALL colors (there are currently 13) and many default
  148.             options can be easily changed with a simple DEBUG script.
  149.  
  150.           - PgUp/PgDn to swap pages of multiple-page listings
  151.             (Esc or Q to Exit.  Not used if there is only 1 page.)
  152.  
  153.           - Several other options were introduced.
  154.  
  155.     3.1   Two known bugs were killed in this release.  They are:
  156.  
  157.           - Not handling a variety of multi-dir path requests, such
  158.             as "D \DIRx\DIRy" (though \DIRx\DIRy\ did & does work).
  159.  
  160.           - Only displaying page 1 of 2 if there were exactly 84
  161.             files in the dir being displayed (regardless of sub-dirs).
  162.  
  163.           - Also in this release, PgUp/PgDn 'rollover' was implemented.
  164.             PgUp from the 1st page of any listing will go to the last
  165.             page, and vice-versa.
  166.  
  167.     3.2   A bug in the PgUp/PgDn rollover was fixed.  This was causing
  168.           divide overflows & system lock-ups under certain conditions.
  169.  
  170.  
  171.     3.3   The input parsing routines were changed to prevent the current
  172.           directory from being displayed when an invalid directory was
  173.           requested.  D now recognizes invalid drive and invalid dir
  174.           requests, with appropriate error messages.
  175.  
  176.     4.0   Added OS/2 compatibility.  D now runs under OS/2, the OS/2 Dos
  177.           Box, or any Dos 3.x environment.  D now always waits for a
  178.           keystroke before exiting.  Use ESC to exit, or ALT-W to switch
  179.           between the "wide" (4 column) and "narrow" (1 column) displays.
  180.           The "wide" display mode was changed to a single column in order
  181.           to include a display of the file attributes (if any).
  182.  
  183.