Date   : Thu, 04 Nov 1982 19:30:16-EST (Thu)
From   : Rick Conn <rconn@BRL>
Subject: XDIR3, Version 1.2

       XDIR3, complete with its installation program (XDIR3INS) and
its HLP file, are now ready for distribution on MIT-MC.  Keith will let
you know where the files are when he is ready.

       Some documentation on what XDIR3 is and does follows:

                        Overview of XDIR3

     XDIR3  is an extended directory display utility designed  to 
run  under CP/M 2.2 and support some of the extended features  of 
ZCPR2 as well.  Any conventional CP/M 2.2 user may use XDIR3, but 
he  should make sure he turns off the ZCPR2-specific features  by 
running  the XDIR3 Installation Program,  XDIR3INS,  and manually 
turning them off before using XDIR3.

     XDIR3  automatically  adapts to any Org-0 CP/M  2.2  system, 
regardless of the size of its disks.  It reads the disk parameter 
block information from the operating system to determine what the 
attributes  of  the  disk it is working with  are,  and  it  then 
presents its display information accordingly.

     XDIR3 runs in two basic modes:
          . as a directory display utility
          . as a file scanner utility (File Name Buffer Facility)

     XDIR3  is a ZCPR2 utility which supports the extended  ZCPR2 
features, particularly named directories.

     As   a  directory  display  utility,   it  displays  to  you 
information  about  the files on a particular disk in  all  or  a 
particular user area.  It gives you the following information:
          . Name of File
          . Size of File (in K bytes)
          . Attributes of File (R/O or System)
          . Sum of Sizes of All Files Displayed
          . Total Number of Files on Disk
          . Amount of Space Remaining on Disk
          . What Disk and What User Area you are looking at

     As a file scanner utility, it does the following:
          . Logs a group of selected files to disk for later scan
          . Prints the contents of such a log file
          . Scans a log file and compares it with the files
               selected by you, telling you what files are
               missing and what files are additional

     XDIR3 is quite human-oriented,  with many built-in  features 
which  provide  a  human-interface type of service to  the  user.  
Some of these include:

          . Named Directories may be specified
          . The file listing is alphabetized by file name and
               type or file type and name, depending on user
               preference
          . The file listing is organized vertically or
               horizontally, depending on user preference
          . Output may also be send to disk or printer
          . XDIR3 is designed to run quickly, having an optimum
               design in its directory load and sort modules



                 Basic Use of XDIR3 under ZCPR2

     XDIR3 is invoked by one of the following command lines:

          XDIR afn oooo... or XDIR afn /oooo...
and
          XDIR /oooo...

where all elements after the XDIR command are optional.

     'afn'  is an ambiguous file reference,  as described on  the 
following frames.   'o' is an option letter, which is one or more 
of  the options described on the next frame.   Note that since  a 
slash denotes that an option follows, an afn may not begin with a 
slash.   This  can be changed by an equate in the source code  of 
XDIR3 if desired.


          Aa - Set the attributes of the files to be displayed
               a=S for System Files, a=N for Non-System Files
               a=A for All Files (Non-System and System)
          D  - Send Output to Disk
          Ff - Engage File Name Buffer Facility
               f=L to Log File Names to Disk
               f=P to Print Names Logged to Disk
               f=S to Scan Disk for File Names and Compare to
                    Log
          G  - Toggle Grouping (group files by name and type or
                    type and name)
          H  - Toggle Horizontal or Vertical display format
          I  - Inspect files selected by FL option
          N  - Negate Selection; select those files which do NOT
                    match the ambiguous file name
          P  - Send Output to Printer


     'afn' is an ambiguous file reference, of the general form:

          dir:filename.typ

where
     filename.typ   is a conventional CP/M ambiguous file name
                         (wild card characters of ? and * are OK,
                         but file name must NOT start with /)
     dir:           is a ZCPR2 directory specification, which may
                         be one of the following forms:
          d:        where 'd' is a disk letter (A-P) to indicate
                         the current user area on that disk
          u:        where 'u' is a user number (0-31) to indicate
                         that user on the current disk; 'u' may
                         be a '?', in which case all user areas
                         are selected
          du:       where 'du' specifies both disk and user
          name:     where 'name' is the name of a directory
                         (disk/user area)