DA.DOC
                             ------
                    Documentation for DA.COM
                 Version 1.1  - E.Meyer -  07/84



       DA.COM is a utility for manipulating "Directory Attributes".
It was written for a CP/M 3 system, but should work on 2.x as well.
       DA.COM takes only 1K of disk space, yet it not only allows
the setting of attributes, but also functions as a uniquely selective
"directory" program, including file sizes and free disk space.

SYNTAX:    A>da [filespec] [[option]attributes]

  where "filespec" may contain wildcards, and defaults to "*.*";
  IF it is not absent,  "option" may be "+", "-", or "~";
                    and "attributes" are:  "S" = System
                                           "R" = Read/only
                                           "A" = Archive
                                     "1" - "4" = User att. 1-4

       If you omit "attributes" entirely, DA just displays the names,
attributes, and sizes of the specified files, in alphabetical order.
If there are no such files, you get the message "++ No file ++".
       You can get a selective display too; if you specify an attribute
list, DA will display only those files which do (or do not, if "~" was
used) have the specified attributes.

SAMPLE DISPLAY:  [ DA 1.1 - E.Meyer 07/84 ]           :: 99k free ::
                 A:ALPHA   FIL  6k   A 2   :BETA    FIL 51k   A
                 A:GAMMA   COM 18k SR      :OMEGA        9k

INTERPRETATION:  Disk A has 99k free.  ALPHA.FIL is 6k, and has attributes
                Archive and "2".  OMEGA is 9k, and has no attributes; etc.

       If you wish to change attributes on the specified file(s), you
must give the attribute list, preceded by "+" to set them or "-" to
clear them.  DA will then display the new status of the file(s).
       If you specify an illegal attribute, or some other error arises,
DA will abort with the message "++ Error ++".


                      EXAMPLES: Displaying

A>DA B:MYFIL.DOC  simply displays the attributes of file MYFIL.DOC
                   on the B: disk.
B>A:DA ~SR  is a mistake: DA will read "~SR" as the filespec, since
             none was specified, and the messate "++ No file ++" results.
B>A:DA B: ~SR  does what you want: displays all files on the B: disk
                which have NEITHER the System NOR Read/only attributes.
A>DA B:*.CQ A2  displays only files with filetype CQ on the B: disk
                 which have BOTH the Archive AND "2" attributes.

                       EXAMPLES: Changing

B>A:DA ART.NDX +SA1  sets the System, Archive, and "1" attributes of
                      the single file B:ART.NDX.
A>DA *.COM -SRA1234  removes all seven attributes from all COM files
                      on the A: disk.


            TECHNICAL REMARKS: DA.COM and your machine

  (1) DA.COM requires a Z80 CPU; it will NOT work on a system with
a plain 8080.  Most recent 8-bit computers use the Z80.
  (2) The "free disk space" feature uses BDOS function 46, and will
function only under CP/M Plus.  It will not display under CP/M 2.x.
  (3) Due to a limitation in DA's printing algorithm, any file sizes
or disk free space that exceed 255K (!) will print out as "++".  
  (4) You can vary the number of columns in which DA.COM displays the
directory.  Patch address 0103 with DDT to the number you want.  Each
column is 25 characters wide; three columns are standard.
  (5) DA.COM is set up to use an alternate video mode (typically dim)
to display the file attributes, to improve legibility.  It has room for
a two-byte sequence to enable (at 0104-6) and disable (at 0107-9), each
terminated by a 0.  If you don't need the second bytes, patch them to
0. If you don't want the feature at all, patch the first bytes to 0 also.
Example: the Osborne uses ESC ) to enable, ESC ( to disable dim video.
This requires hex bytes 1B,29,00;1B,28,00 at locations 0104-6;0107-9.
orne uses ESC ) to enable, ESC ( to disable dim video.
This requires