home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / UTILITY / DIR / DLXDR231.ZIP / DDIR.DOC next >
Encoding:
Text File  |  1992-06-10  |  9.8 KB  |  259 lines
  1. ******************************************************************************
  2. *                                                                            *
  3. *                              D e l u x e  D i r                            *
  4. *                                                                            *
  5. *                                 Version 2.31                               *
  6. *                                                                            *
  7. ******************************************************************************
  8.  
  9.  
  10.                                Table of contents:
  11.                                ------------------
  12.  
  13.                              1.   Program description
  14.                              2.   Validation
  15.                              3.   Features
  16.                              4.   Installation
  17.                              5.   Program use and options
  18.                              6.   Comments
  19.  
  20.                     Appendix A:   Version notes and additions
  21.                     Appendix B:   Contacting the author
  22.  
  23.  
  24. 1. Program description:
  25. -----------------------
  26.  
  27.    Deluxe Dir (DDIR) is an experimental Pascal program which turned out to
  28.    be quite a useful directory-lister program. The main advantage of DDIR
  29.    is that it lists the directory files in three columns, instead of the one
  30.    column used by the 'dir' command, yet showing the file sizes, which are
  31.    usually quite important and are not shown by the 'dir /w' command.
  32.    In addition, DDIR adds a few options which are described below, making
  33.    the directory screen appear more clearly and efficiently.
  34.  
  35.  
  36. 2. Validation:
  37. --------------
  38.  
  39.    In order to ensure that the file has not been altered, I'm including the
  40.    info that would be provided by McAfee's VALIDATE program:
  41.  
  42.    File size:               12,246
  43.    File date:            6-10-1992
  44.  
  45.    CRC check method #1:  C E 9 3
  46.    CRC check method #2:  1 6 0 5
  47.  
  48.  
  49. 3. Features:
  50. ------------
  51.  
  52.    * Directory is listed in three columns separated by two vertical lines.
  53.  
  54.    * Executable files are highlighted.
  55.  
  56.    * Hidden and system files are shown along with the regular files.
  57.  
  58.    * The directory can be sorted primarily by filename, extension or size,
  59.      and the files are displayed in vertical order.
  60.  
  61.    * Hebrew filenames can be shown in Hebrew characters.
  62.  
  63.    * File sizes can be shown in kilobytes.
  64.  
  65.    * The '.' and '..' directory files are ignored.
  66.  
  67.    * The directory files are pushed to the beginning or end of the list.
  68.  
  69.    * The file sizes contain commas.
  70.  
  71.    * Zero length files are made to blink.
  72.  
  73.    * DDIR contains a detailed option which shows the file attributes,
  74.      dates, times and the size of the drive being listed.
  75.  
  76.    * The number of files in the subdirectory, the size of the subdirectory
  77.      and the number of bytes free are displayed at the end of the directory.
  78.  
  79.  
  80. 4. Installation:
  81. ----------------
  82.  
  83.    In order for DDIR to be able to run from any path, the program has to be
  84.    present at one of DOS's search paths. Therefore, it is recommended to add
  85.    the path of the file DDIR.EXE to the PATH variable, after copying it to the
  86.    desired path.
  87.  
  88.    Example:
  89.  
  90.      Let's say that DDIR is being copied from a floppy in drive A: to a
  91.      directory called 'utils' in drive C:. The copying command should be:
  92.  
  93.      >copy a:ddir.exe c:\utils
  94.  
  95.      and the line:
  96.  
  97.      'path c:\utils'
  98.  
  99.      should be added to the autoexec.bat file on the root directory.
  100.  
  101.    It is also recommended for fixed-disk users to use this program along with
  102.    an alias program like DOSEDIT, and give it an alias like '-'.
  103.  
  104.  
  105. 5. Program use and options:
  106. ---------------------------
  107.  
  108.    The command line syntax for DDIR is:
  109.  
  110.    >ddir  [options]  [ [drive] [path] [wildcards] ]  [options]
  111.  
  112.    All of the parameters of DDIR are optional, and when a parameter is not
  113.    specified, DDIR automatically chooses the default option. All the options
  114.    of DDIR are preceded with a slash. The default drive and path for DDIR are
  115.    the current drive and the current path. Its default wildcards are the same
  116.    as DOS's default wildcards (*.*).
  117.  
  118.    These are the options of DDIR:
  119.  
  120.    /C   -  This option allows the omission of commas in the file sizes and
  121.            the bottom statistics. It is mainly made for users who need faster
  122.            speed.
  123.  
  124.    /D   -  The detailed option no longer shows the files in three columns, but
  125.            in one. However, it adds the files' attributes, their dates, and
  126.            the size of the drive being listed.
  127.  
  128.            The files' attributes are:
  129.            H - hidden;  R - read-only;  S - system;  A - archive
  130.  
  131.    /E   -  Sorts the files primarily by their extension. Please note that the
  132.            default option sorts the files primarily by name, but sorts their
  133.            extension too. This option sorts files of the same extension by
  134.            their name. (Cannot be used with /Z)
  135.  
  136.    /H   -  This option was made for Israeli users who use Einstein
  137.            HebrewWriter or any other program that makes pseudo Hebrew
  138.            filenames using the IBM extended charcter set. When this switch
  139.            is active, the program will translate these characters to Hebrew
  140.            characters. (Cannot be used with /L)
  141.  
  142.    /K   -  Shows the file sizes in kilobytes instead of bytes. (The size in
  143.            bytes is always rounded upwards). This option helps figure out the
  144.            proportions between sizes of files, and see how much space a
  145.            certain file occupies. (Usually, a file occupies a multiple of
  146.            2Kb's on fixed disks, and a multiple of 1Kb on floppy disks).
  147.  
  148.    /L   -  Displays files in lower case characters. (Cannot be used with /H)
  149.  
  150.    /P   -  Pushes directory files to the end of the list: Sometimes it is more
  151.            convenient to see the directories while typing a command, by moving
  152.            them to the end of a long list of files. This option is active only
  153.            when the file sorting is active.
  154.  
  155.    /R   -  Reverses the order of sort to descending sort. It is especially
  156.            useful for size sort.
  157.  
  158.    /S   -  Skips sorting of files and shows them by DOS order. This option is
  159.            needed only when greater speed is desired, or when the actual order
  160.            of the files of a certain directory needs to be shown.
  161.  
  162.    /T   -  This option disables the text mode changes at the beginning and end
  163.            of program execution. It is needed only for EGA/VGA users who use
  164.            special TSR program drivers or unique pallettes.
  165.  
  166.    /V   -  Enables snow checking for old video adapters: Some old CGA's and
  167.            other graphics adaptors produce an effect called 'snow' when
  168.            characters are output directly to the screen. If such a 'snowing'
  169.            effect occurs, this option should be specified.
  170.  
  171.    /W   -  Swaps the position of the day and the month in the detailed
  172.            option's file dates for country compatibility.
  173.  
  174.    /Z   -  Sorts files by their size from small to large. (Cannot be used
  175.            with /E)
  176.  
  177.    /?   -  This option shows a title screen an a summary of the allowed
  178.            options.
  179.  
  180.  
  181.    Abortion:   DDIR can be terminated whenever it is waiting for a keypress 
  182.                by pressing the <Esc> button.
  183.  
  184.    Exit codes: DDIR uses the following exit codes:
  185.  
  186.                3: when an error occures
  187.                2: when DDIR has been terminated
  188.                1: when help has been requested
  189.                0: otherwise
  190.  
  191.  
  192. 6. Comments:
  193. ------------
  194.  
  195.    *  The programmer disclaims any responsibility for damage caused by this
  196.       program, though the program does not write on or change the contents of
  197.       any device it reads from, and does not stay resident in memory.
  198.  
  199.    *  Any suggestions or comments about the program will be greatfully
  200.       accepted.
  201.  
  202.    *  This program may be distributed as long as its contents are not changed
  203.       and no fee is charged. (The ZIP form is more recommended for
  204.       distribution.)
  205.  
  206. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  207.  
  208. App. A: Version Additions:
  209. --------------------------
  210.  
  211.    2.31: Improves Hebrew display, blinks zero length files, adds an
  212.          option for lower case characters and no longer highlights .COM
  213.          .BAT and .EXE files which are also system files, as they are not
  214.          executable from the command line.
  215.  
  216.    2.30: Adds sort by size and descending sort. Improved display. Adds
  217.          abortion with <Esc>. Fixes a bug when a color graphics adapter
  218.          is not present. Stricter parameter checking.
  219.  
  220.    2.24: Adds time display and allows swapping the day and month
  221.          position of the dates (all in the detailed option).
  222.  
  223.    2.23: Allows canceling of program text mode changes.
  224.  
  225.    2.22: Returns to original text mode, allows snow checking.
  226.  
  227.    2.21: Adds an option to omit commas, and fixes some bugs which occured
  228.          only in ver. 2.20.
  229.  
  230.    2.20: Improved screen usage in small directories, adds extension
  231.          sort, allows skipping sort, adds an option for pushing directory
  232.          files to the end of the list, and adds commas to file sizes.
  233.  
  234.    2.12: Improved path and current directory handling
  235.  
  236.    2.11: Fixes a little bug with empty disks which have no volume label
  237.          and improves error messages
  238.  
  239.    2.10: Adds Hebrew support to Einstein HebrewWriter style filenames.
  240.  
  241.    2.00: Sorts filenames and enhances executable ones.
  242.  
  243. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
  244.  
  245. App. B: Contacting the author:
  246. ------------------------------
  247.  
  248. Mail address:
  249.  
  250.      Oren Souroujon
  251.      Hanasi Harishon St. 38/29
  252.      Rehovot, 76302
  253.      ISRAEL
  254.  
  255. E-Mail Internet address:
  256.  
  257.      NYSOUROU@weizmann.weizmann.ac.il
  258.  
  259. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=