High Voltage Shareware/high1.zip/high1/DIR2/D84.ZIP/D.DOC

Text File | 1993-07-16 | 17KB | 333 lines

╒════════════════════════════════════════════════════════════════════════════╕
│        CADMOS Computer WorkShop - 26, Skoufa Street, Athens 106 73         │
│     Phone +30-1- data: 363 5482, 360 6044, 360 6046 (Cadmos/CHAOS BBS)     │
│               voice: 361 1030, 360 6052       FAX: [phone]                │
╘════════════════════════════════════════════════════════════════════════════╛
            ┌──────────────────────────────────────────────────┐
            │ D.EXE, version 8.4, a Directory Display Utility. │
            └──────────────────────────────────────────────────┘
┌────────────────────────────────────────────────────────────────────────────┐
│(c) All rights reserved. Use prohibited in a professional, business or      │
│    commercial environment without prior written licence by the author.     │
│                                                                            │
│ Feel free to copy and distribute this program. You may use it and evaluate │
│ it for 30 days. After this period, you may only use it while you are a     │
│ subscriber to Cadmos/CHAOS BBS :-)                                         │
└────────────────────────────────────────────────────────────────────────────┘

 D is a versitile Directory Information Display Utility.
 When you type  D ?  you 'll get the following Help Screen:

╔══════════════════════════════════════════════════════════════════════════════╗
║ D-Directory Utility, Ver 8.4*, (c) 1988-93, Haris Courouclis, [phone] ║
║ FORMAT:  D [options] [path][filename]                    *DR DOS5 compatible ║
║ Options are:                (You can set env.var. CadmosD to preset options) ║
║   +E  = Exact Match - no added *.*  -E  = Exact path\name - any extension    ║
║   +M  = List Marked files only      -M  = Do not list Marked files           ║
║   +A  = List Archive files only     -A  = Do not list Archive files          ║
║   +R  = List ReadOnly files only    -R  = Do not list ReadOnly files         ║
║   +H  = List Hidden files only      -H  = Do not list Hidden files           ║
║   +S  = List System files only      -S  = Do not list System files           ║
║   +D  = List Directory names only   -D  = Do not list Directory names        ║
║   +U  = List Unusual files only     -U  = Do not list Unusual files (H,S)    ║
║   /C  = Continuous listing          /N  = No info   /BW  = Black & White     ║
║   /d: = Report space required on d: /RED= Redirect output (eg. d /red>PRN)   ║
║   /F  = Fast mode (CLS on start)    /Q  = Quiet mode. Only set ErrorLevel.   ║
║   /=ddmmyy, /~ddmmyy, /{ddmmyy, /}ddmmyy  List files dated on, not on,       ║
║    before, or after date. -n instead of ddmmyy specifies n days before today.║
║    ~,{ and } combinations, ? wildcard, and ddmmmyy allowed (eg. d /=??JUN93).║
║ Smart WildCards are supported (S*T matches SMART, not SOME that DOS would).  ║
║ D.EXE sets ErrorLevel to total files + directories listed. The number of     ║
║ files or dirs not selected due to options or smart wildcards is displayed.   ║
║ Press any key to suspend/resume, RETURN to scroll one line, END to scroll    ║
║ to end of directory, HOME or SPACE for fast new page, ESC to abort.          ║
╚════════════════════════════════════════════════════════════════════CADMOS════╝

If you want to redirect D's help screen to a printer or file, use D /?
(instead of the normal D ?). For example, D /? >prn,   D /? >d.hlp

Normally D.EXE clears the keyboard buffer before proceeding. With the /k
switch (not shown in the Help Screen), the contents of the Keyboard Buffer are
stored at program start and restored when the program exits. Usefull with
keyboard enhancers that allow you to execute macros from a batch file etc.

You can preset options you use regularly via the CadmosD environmental variable.
For example, for monochrome systems include the line "SET CadmosD=/bw" somewhere
in your AutoEXEC.BAT file. If you want D to ignore the CadmosD environmental
variable, use the /NE switch.

══════════════════════════════════════════════════════════════════════════════
                       D.EXE's Date selection system
──────────────────────────────────────────────────────────────────────────────
You can use date specifiers to filter the files you wish displayed. The date
operators are:
  =    -    selects files created of modifyed on a given date.
  }    -    selects files created of modifyed after a given date.
  {    -    selects files created of modifyed before a given date.
  ~    -    selects files created of modifyed on a date differing from a
            given date.

Depending on the country settings on each host system, the date format can be
ddmmyy (Europe), mmddyy (USA), or yymmdd (Japan). Starting from version 7.6,
regardless of the country setting, ddmmmyy can be also used, and is
translated internally to the current setting. D.EXE is about the only program
I know that automatically inputs and outputs the date using the correct format
even on its help display!

With all formats, if the date consists of between 1 and 5 digits, a 0 is
prefixed.  If the number of digits is still less than 6, the missing digits
are borrowed from the current date's string. Providing less than 6 digits
should be avoided when using the Japanese format.

A question mark anywhere in the date string will be replaced by the
equivalent digit of today's date string.

A minus sign before a date number is replaced by the date of so-many-days ago.

The special 0 date with which certain programs open a new file can be caught
with D /=0 (or /=000080). Such dates are recorded, for example, by Zmodem when
an uploaded file is aborted. DOS 6 will not show any date for such files.
D will show such a date as 0-0-80.

The following examples assume European format and that today is 28 Oct 91.

  D /=281091  or  D /=2810  or  D /=28Oct  or  D /=28  or  D/=
        will list all files created or modified today.
  D /~28??91
        will list all files created or modified on any day but the 28th day
        of any month in 1991.
  D /}-4
        will list all files created or modified less than 4 days ago.
  D /{12oct
        will list all files created or modified before October 12, 1991.
  d /{12oct /}20???? /~??1?90 +a-d
        will list all files (but not directories) with their archive bit set,
        created or modified before October 12, 1991, but at a day after the
        20th of any month or year, except files dated October, November,
        December (months 10,11,12) of 1990.
═══════════════════════════════════════════════════════════════════════════════

Of course you can combine date qualifiers with all other options.

For examle,
  d +a s*t /= -d /a:
will list all files:
  (+a) whose archive bit is set, AND
  (s*t) their name starts with an s and ends with a t (any extension) AND
  (/=) were created or modified today AND
  (-d) are not directories.
It will also report (/a:) the space required on the diskette in drive a: if
you were to copy them (this space differs from disk to disk, depending on the
disk's cluster size. D.EXE will determine the disk's cluster size first).

Note that date qualifiers should be separated by a space, other options may
be concatenated.

══════════════════════════════════════════════════════════════════════════════
                      The Cadmos Smart WildCard System
──────────────────────────────────────────────────────────────────────────────
   The normal DOS * wildcard substitutes for any number of letters  and is
   not concerned with the length of the resulting string. For example, S*T
   expands to: ST, SmarT, SemicolumnorwhateverT, etc or even: Smarter T,
   S       T (asterisk expanded to 7 spaces, T 9th). The expansions are then
   truncated to the 8 letter DOS limit. S*T will therefore match with ST,
   SMART, SEMICOLU, SMARTER, S and indeed any name starting with S.

   The Smart * wildcard will substitute for only such a number of letters
   that will not throw out of the 8 letter DOS file name length limit any
   following letters.

   In S*T the asterisk can substitute from 0 to 6 letters since there are
   two letters to be accomodated. Therefore it will match any name with S
   as its first letter and T as its last letter, be it 2nd or 3rd or ... or
   8th. The same principle applies to more complex specifications such as
   W*D*T.*E. The first * can substitute up to 5 chars, the second up to 5 -
   the number substituted by the first, and the third up to 2. Therefore it
   will match WilDtesT.exE but not WILD.EXE or WILDTEST.EXA that DOS would.

   There is no difference between the normal DOS ? wildcard and the ? Smart
   wildcard. They both substitute for exactly one letter.

   The DOS DIR command will append '.*' to a file name when no extension is
   given. D.EXE will append *.* except if otherwise specified by the +E
   switch (nothing is appended), or the -E switch (.* is appended)


══════════════════════════════════════════════════════════════════════════════
D.EXE - Revision History
──────────────────────────────────────────────────────────────────────────────

08 Jul 1993, version 8.4*
──────────────────────────
Changed file size field width to accomodate huge files such as the DBLSPACE.???
        files created by DOS 6's Stacker look-alike Double Space utility.

28 Jun 1993, version 8.3*
──────────────────────────
Added   /k switch. Normally D.EXE clears the keyboard buffer before proceeding.
        With the /k switch, the contents of the Keyboard Buffer are stored at
        program start and restored when the program exits. Usefull with keyboard
        enhancers that allow you to execute macros from a batch file etc,
        especially when D is used with the /Q switch set.
Compiled using the official TP 6.0 Turbo.TPL. Norbert Juffa's library update
        probably works faster with D but was dropped alltogether since it
        is rather slow with For-To loops.

22 Jun 1993, version 8.2*
──────────────────────────
Added   /=0 date specifier to catch failed uploads etc.}

28 Mar 1993, version 8.1a*
──────────────────────────
Compiled using the new Turbo-Pascal 6.0 runtime library update
        by Norbert Juffa, Wielandtstr. 14, 7500 Karlsruhe 1, Germany
        Internet: [e-mail]
        ( about 5-10% quicker )

21 Mar 1993, version 8.1*
──────────────────────────
Added   /Q switch for Quiet mode. Only the ErrorLevel is set.

05 May 1992, version 8.0*
──────────────────────────
BugFix  When a path\name was given and path was not found, an 'invalid drive'
        error was reported. Fixed!
Added   /g parameter for 'Machine gun' error messages (not shown in help),
        just for fun, to amuse your friends! 8*)
──────────────────────────────────────────────────────────────────────────────

19 Apr 1992, version 7.10*
──────────────────────────
BugFix  Fixed problem of not properly restoring Text Colors
──────────────────────────────────────────────────────────────────────────────

28 Nov 1991, version 7.9*
──────────────────────────
Added   CadmosD environmental variable can store often used options. To ignore
        the CadmosD options, use /ne (No Env. variable).
      - New option /bw translates Yellow to LightGray, other colors to White.


03 Nov 1991, version 7.7*
──────────────────────────
BugFix. The HELP display did not fit properly on the screen. Fixed.
──────────────────────────────────────────────────────────────────────────────

28 Oct 1991, version 7.6*
──────────────────────────
Added   MMM in date formats. The date format is based on the DOS country
        settings and is selected automatically. Now you can also use DDMMMYY
        regardless of your country setting. For example, even if you have a
        USA country setting, you can also use /=28oct91 instead of /=102891
BugFix  When the disk catalogued had no volume name, and the disk for which a
        required space report was asked could not be read, an unpredictable
        volume name was reported for the nameless disk! Fixed.
──────────────────────────────────────────────────────────────────────────────

12 Oct 1991, version 7.5*
──────────────────────────
BugFix. The -n date option would only work on systems using the European
        DDMMYY date format. Now works on all systems.
──────────────────────────────────────────────────────────────────────────────

06 Jun 1991, version 7.4*
──────────────────────────
BugFix. The -n date option, introduced in version 7.0, would incorrectly wrap
        around 1 Jan 1980, the older date DOS can handle. Now a warning is
        issued and the program aborts.
──────────────────────────────────────────────────────────────────────────────

31 May 1991, version 7.3*
──────────────────────────
BugFix. An Error 18 (no more files) was wrongly issued when you tried to see
        the root dir of a diskette drive, and that drive was empty. Fixed.
──────────────────────────────────────────────────────────────────────────────

14 May 1991, version 7.2*
──────────────────────────
BugFix. The pause feature did not work correctly under certain conditions, due
        to an uninitialized variable in the Page routine. Fixed.
──────────────────────────────────────────────────────────────────────────────

03 May 1991, version 7.1*
──────────────────────────
BugFix. The -n date specifier routine was not aware of months with less than
        31 days. Thus an "Illegal Date" error would occur if you used, for
        example, D /=-3 on May 3d (April 31 was calculated). Fixed.
──────────────────────────────────────────────────────────────────────────────

27 Apr 1991, version 7.0*
──────────────────────────
Added   Now you can use -n in place of a date, where n is the number of days
        before todate's date.
──────────────────────────────────────────────────────────────────────────────

01 Feb 1991, version 6.5*
──────────────────────────
Added   Total Kilobytes report (xxx out of ttt free)
──────────────────────────────────────────────────────────────────────────────

28 Jan 1991, version 6.4*
──────────────────────────
Added   ? wildcard in date specifiers. Stands for ANY digit in the date field.
BugFix  Better handling of Volume name. There was a problem when a dot (.)
        was included in the volume name. Fixed.
──────────────────────────────────────────────────────────────────────────────

24 Dec 1990, version 6.3b*
──────────────────────────
Change  Pressing SPACE has now the effect of fast new page.
Added   Partial date specification possible. I.e. D /=1 is the same as
        D /=011290 if today is any day in Decemper 1990.
       -Custom FindFirst and FindNext procedures allow for DR DOS 5
        compatibility. DR DOS 5's implementation of DOS services 4Eh and 4Fh
        differs from standard DOS. The * in this and subsequent version numbers
        specify DR DOS compatibility.
──────────────────────────────────────────────────────────────────────────────

18 Dec 1990, version 6.3a
──────────────────────────
BugFix  A 12:00 am time would not display correctly. Fixed.
──────────────────────────────────────────────────────────────────────────────

26 Nov 1990, version 6.3
──────────────────────────
Added   NotThisDate option (~ddmmyy). Shows all files with a date differing
        from the date specified.
──────────────────────────────────────────────────────────────────────────────

10 Nov 1990, version 6.2
──────────────────────────
Added   Scrolling window display. Now, if the directory listing does not fit
        in one page, the screen is divided in two windows. The top 3 line
        window will always display the directory titles (volume name,
        Directory of ..., etc.)
──────────────────────────────────────────────────────────────────────────────

06 Oct 1990, version 6.0
──────────────────────────
Major Update!
Added   Smart WildCard system. S*T matches SMART, not SOME that DOS would!

Added   Date selection system.
        /=ddmmyy will select all files dated on ddmmyy
        /}ddmmyy will select all files dated after ddmmyy
        /=ddmmyy will select all files dated before ddmmyy
        ddmmyy follows your particular country information. That is, if your
        country information specifies the USA mmddyy, then specify dates
        using that format. Even the HELP screen senses the right format and
        lists the options accordingly.
──────────────────────────────────────────────────────────────────────────────

06 Oct 1990, version 5.5
──────────────────────────
Added   Colors, and better layout of directory listing.
Started recording info on version updates.
──────────────────────────────────────────────────────────────────────────────

1987, version 1.0
──────────────────
Exploited Turbo Pascal's direct screen writes to produce a faster alternative
to DOS's DIR command.