CP/M/CPM_CDROM.iso/lambda/soundpot/a/d-d1.lbr/D.DZC/D.DOC

Text File | 1993-10-26 | 11.3 KB | 274 lines

D: Display Disk/Drive Directory

    Copyright (c) 1985 by Kent Anderson, Berkeley, CA  94704
    Commercial sale of this program and documentation without
    written permission is prohibited.


To run: 'D'         Displays sorted directory of files on default drive.
    or: 'D <drive/user/filename>'  Displays files matching <dr/usr/file>.
    or: 'D <drive/user/filename> <options>'
    or: 'D $<options>'

<drive/user/filename>  - may contain wildcards ('*' and '?'): e.g. *.COM
               - may be just drive/user: 'D A' will list
                files on A drive.  (To search for a
                file called 'A', put a drive code in
                front of it: e.g. 'B:A'.)
               - may use 'ZCPR' format: e.g. B1 refers to
                drive B, user 1.

OPTIONS:

   Mnemonic    Function
-- -----------    -------------------------------------------------------
$  Options    Ignored, but used to indicate an option string with no
           filename; e.g. 'D $D' lists all drives.

A  All users    ALL users, starting with user 0 or whatever user was
        specified in the filename or the U option (below).

C  Clear    CLEAR screen before listing files.  (Assumes ADM3a-like
        device.)

D  Drives    All active DRIVES, starting with A or specified drive.

F  File        Make a disk FILE of the directory display.  The default
        filename is SD.DIR.

N  No paging    NO paging of screen output.  Otherwise, screen output
        will halt every 24 lines, awaiting any keyboard input.
        Control-C will return to CP/M.

P  Print    PRINT a copy directory of the directory display.  This
        option is useful for making slips of paper that can be
        stored with the disk, so you can tell what's on them
        without putting them in the computer.

R  Reset    RESET drives before listing (to get the correct value
        for the "space available" when a disk has been changed
        without doing a "Warm Boot").

S  System Files    Display SYSTEM files.  Otherwise they are omitted.

T  Top        Put summary line at TOP of display.  Otherwise the
        summary line, which gives the number of files, space
        used, and space free, appears at the bottom.

Un User n    Start search with USER n: e.g. U8 starts with user 8.
        There must be no space between the 'U' and the number.

OPTIONS, Cont.

   Mnemonic    Function
-- -----------    -------------------------------------------------------
V  Version    Show VERSION number.  Displays a line identifying
        the program and its release date, so you can see whether
        your version is the latest one.

Z  ZCPR        "ZCPR" format, combining drive and user: e.g. 'A0', 'B10',
        'M15'. Setting the 'Z' option causes the drive/user to
        appear at the beginning of each line of file information.
        It also causes the user number to appear with the drive
        code, even with user 0.  The 'Z' option is set
        automatically whenever the input contains a filename
        that uses ZCPR format.  It is also set if the 'A' or 'U'
        option is used.

+  Plus        When used with 'F' option, ADDS display to previously-
        existing disk file, instead of making a new disk file.
        The default makes a new disk file.

!  Only!    Resets all of the above options.  This option is used
        with '=' option, below, to define exactly the options
        you want set in a new version of the directory program.

2  20-column    20-column, 40-column, 60-column, or 80-column format.
4  40-column    Adjusts the display for different screen sizes.  Lists
6  60-column    files in 1, 2, 3, or 4 columns, respectively.  The
8  80-column    default is 4 columns ('8' option).  NOTE: 'D $2FN'
        makes a disk file that can easily be made into an
        annotated directory listing with your text editor.

/<FileName>    Changes the name of the file made by the 'F' option.
        The default is SD.DIR.

=<ProgName>    Makes a new version of the directory program itself,
        with default options as specified.  If the filetype is
        omitted, it will be set to '.COM'.  For example:
            'D $!T4 =A:D'
        will make a program called 'D' on the A drive, which
        will display the summary line above the files and will
        list the files in two columns.  (Note the use here of
        the '!' option to guarantee that all options except T
        and 4 are reset.  Also note that we could not have
        identified the new program as just 'D'; this would have
        been interpreted as a drive code without a filename,
        which is invalid in this case.)


Note that filenames must have a space separating them from any further
options.  Everywhere else (except after the 'U' option) spaces are
insignificant.  Upper case/lower case is also insignificant, of
course.


EXAMPLES:

D        Display all non-system files on default drive.
D $R        Same as above, but reset drives first (if disk was changed).
D $S        Display all files on default drive (including system files).
D A        Display all non-system files on A drive.
D A:*.COM    Display .COM files on A drive.
D *.??M        Display files with 'M' in last character of filetype.
D $D        Display all non-system files for current user on all drives.
D $ADS        Display all files for all users on all drives.
D $P        Display all non-system files with copy to printer.
D B CRV        Display files on drive B after clearing CRT, resetting
            drives, and showing version date.
D $4TZ        Display files on default drive, use 40-column format,
            put summary line at top of display, and use
            ZCPR format.
D *.MSS F+/MSSFILES.MSS
        Display .MSS files on default drive, append display to
            disk files named MSSFILES.MSS.


DISCLAIMER

    While this program has been carefully tested, no warranty is
offered, and no liability is assumed for any loss or damage caused, or
alleged to be caused, directly or indirectly by this program.  This
includes, but is not limited to, any interruption of service, loss of
business, anticipatory profits, or consequential damages resulting
from the use of this program.

COPYRIGHT NOTICE

    This program has been contributed to non-profit users' groups
in support of their activities and to facilitate its distribution.  It
is not fair for profit-seeking enterprises to make money distributing
such material without paying the authors.  Consequently, although this
program has been placed in the public domain, I retain all copyrights to
it.  This program and its associated documentation MAY NOT BE SOLD BY
ANY PARTY except non-profit users' groups, unless specifically
authorized by the author, Kent Anderson, in writing, prior to sale of
the first copy.  Furthermore, this program MAY NOT BE INCLUDED IN ANY
PACKAGE FOR SALE, even if this program is indicated as being "in the
public domain".  All of the above applies to both the original and any
derived or modified copies of the original.  Any modified copies MUST
NOT have the copyright notice violated or altered.

    Please report any copyright violations to the author.  I'm in
the phone book.

                    Kent Anderson
                    34 Panoramic Way
                    Berkeley, CA  94704

CONTRIBUTIONS

    I spent a lot of effort to make this program as useful, tiny,
flexible, and polished as possible, and I hope and believe you find that
it makes your computer better.  If this program is valuable to you,
please feel free to tell me so, by sending a contribution (say, $15, or
whatever you think it's worth) to the above address. Suggestions for
enhancement would also be appreciated.


OVERVIEW

This 2k directory program contains almost all of the features of SD98
(an advanced version of an earlier public-domain directory program), but
it uses less than half the disk space. It is also somewhat easier to use
and more flexible:

    - Drive/user can be specified without a colon:
        'D A' will list files on the A drive.
        'D B1' will list files on drive B, user 1.
    - '$' need not precede options if a filename is used:
        'D B5 R' will list files on drive B, user 5
        after resetting drives.
    - Format of display is flexible: see T,Z,2,4,6, and 8 options.
    - CAN CREATE NEW VERSIONS OF ITSELF, with different default
        options: see '=' option.
    - 'No files' message echoes the filename sought, if one was
        given.
    - Error message reports the point at which the problem was
        detected in the input.
    - Can create a useful cataloging program.  See below.
     - Contains '2' option, listing files and sizes in a single
        column: convenient for making annotated directory
        listings.

Differences between D and SD98:
    - D is 2k; SD98 is 5k.
    - D has no library option.
    - Default version of D differs slightly in the format of
        the summary line and in its option settings.  Most
        of these differences can be overcome by changing
        the default options: 'D $!TZ+=SD99'.



Note that there is a tradeoff for making it easier to specify
drive/user: while you don't have to type a colon to specify a drive
or a drive/user combination ('B:' or 'C4:'), if you actually ARE looking
for a file called 'B' or 'C4', you can't just type 'B' or 'C4'.
Instead--in these special cases--you MUST specify the drive/user: e.g.
'B:B' or 'A:C4'. Similarly, since '$' in the first character of the
filename signifies an option list to follow, if you really do want a
list of files with names beginning with '$', put a drive code in front
of the filename.




D can also produce a simple but serviceable cataloging program:
        D A RF+/CATALOG.DOC =B:C
will make a program called 'C' (for Catalog) on the B drive; the
program will reset drives, display all files on the A disk, and append
the listing to the file 'CATALOG.DOC'.  You can then feed disks one at
a time into the A drive, type 'C' and <CR>, and produce a listing of
the contents of your disks.  This is not as fancy as real cataloging
programs, but it may be perfectly satisfactory.  The main thing your
catalog will lack that fancier systems provide is a cross-referenced
list of files.  But you can simply use your text editor to search the
CATALOG.DOC to find what disk(s) it appears on.

Helpful hint: put a dummy filename on each disk that has a '-' in the
first character of the name and a three-digit number in the filetype.
This names and numbers each disk, and the '-' in the filename will
make it appear first in the directory display.  Give your disks names
like '-EDITDSK.002' or '-CH1.034'.  Write the disk number on the
label. To put these filenames on the disk without using any space, use
the SAVE command: e.g. 'SAVE 0 -EDITDSK.002'.  This creates a directory
entry, but uses no disk space.

Note that 'D A D' may be easily remembered as "Display All Drives".


ASSUMPTIONS, LIMITATIONS, AND HOOKS FOR FURTHER CUSTOMIZATION:
1. Requires Z80 processor, at least 16k RAM, and CP/M version 2.2 or
    later.
2. The maximum number of files for any user on any drive is 256.
3. Assumes the command tail is passed through the CP/M buffer at 0080h,
    and that it is already capitalized, as per the CP/M standard.
4. Addresses for modification:
    Value              Location
    -------------------   --------
    ClearString        08F9  String that clears CRT.  Maximum 6
                    characters, followed by '$' (24h).
                    Default: 1Ah, for ADM3-like device.
    FenceChar        08F7  Character that separates entries
                    on the same line.  Default: '|'.
    LinesPerScreen - 1      05E2  Limit used in "paging" output to CRT.
                    Default: 23 (17h), i.e. 24 lines.
    OptionChars        08D8  List of valid option characters.
                    By setting any of these to 00h,
                    the corresponding option can be
                    disabled.
 but uses no disk space.

Note that