home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / UTILITYS / SDZD-138.ARC / SDZD#138.DOC < prev    next >
Text File  |  1991-02-10  |  12KB  |  283 lines
  1.  
  2. SDZD+138.DOC         Documentary help guide            1 Feb 89
  3.  
  4.             Super Directory program
  5.             -----------------------
  6.  
  7. INTRODUCTION:
  8. ------------
  9.  
  10. This is a help guide to operate the CP/M-80 Super Directory program.  It
  11. is often renamed to "DIR.COM" on RCP/M systems or on systems running CCP
  12. replacements that allow an external directory program.    It is one of the
  13. most useful and one of the most versatile programs available for CP/M-80
  14. computers.  It can direct its output the the CRT, to a printer or to a
  15. disk file for later reference.    It can alphabetize a directory either
  16. vertically or horizontally (selected when assembling the program but
  17. can be changed to the other mode at any time for the current display.)
  18. It shows how many files have been used on the current drive/user area,
  19. how much space this has taken and how much space remains.  Those and
  20. other useful features are mentioned below.  Spend at least a few moments
  21. looking at the quick-reference option list as you may find some things
  22. are now available that would be quite helpful when using your computer.
  23.  
  24. For all changes made to support Z80DOS or CPM3 date stamping, search this file
  25. for the string "Z80DOS","CPM3".
  26.  
  27. NOTE FOR CPM3 USERS: As the date routines in SDZD+138 are the same as those
  28. used by Z80DOS, some Z80 code was used in them, plus a few CPM3 only routines.
  29. So if you DON'T have a Z80 CPU then you CAN'T use the date facilities.
  30. Still can use MAC, RMAC, M80, SLR etc for assembly though!
  31.  
  32.     To get a HELP Summary of Options:
  33.  
  34.             B0>SD ?
  35.               or
  36.             B0>SD //    (if ZCPR33 equate YES)
  37.  
  38.     Example of Option Usage:
  39.  
  40.             B0>SD $ANDLV (...etc.)
  41.  
  42. (The "$"  denotes start of commands but "/" or "[" may also be used.)
  43.  
  44.  
  45. QUICK SUMMARY OF OPTIONS:
  46. -------------------------
  47.  
  48.      A -  all user areas allowed, (0-15), some systems (0-31)
  49.      C -  shows file sizes in records, rather than 'k'
  50.      D -  all  drives starting with first available (usually A:)
  51.      F -  file "DISK.DIR" created/appended to show disk contents
  52.      H -  shows all user areas from here to highest
  53.      L -  LBR/ARC/ARK list option (shows names of member files)
  54.      N -  defeats the page pause, permits non-stop display
  55.      O -  shows only $SYS files in directory
  56.      P -  copies output to printer
  57.      Q -  shows files that have NOT yet been archived
  58.      R -  resets  disk, if not already logged in
  59.      S -  include any $SYS files
  60.      T -  sorts files by type (extent)
  61.      V -  shows version number and date
  62.      X -  uses alternate listing format (horizontal/vertical)
  63.      1 -  files must have attribute 1 set
  64.      2 -  files must have attribute 2 set
  65.      3 -  files must have attribute 3 set
  66.      4 -  files must have attribute 4 set
  67.  
  68. "Z80DOS support"
  69.      = -  Show files whose date matches input date exactly
  70.      + -  Show files whose date is equal or after input date
  71.      - -  Show files whose date is before input date
  72.      ! -  Use creation date for matches
  73.      % -  Use alteration date for matches
  74.      @ -  Use last access date for matches
  75.      Z -  Show file dates
  76.  
  77. "CPM3 support"
  78.     The same syntax as Z80DOS, with the exception of the '!' switch.
  79.     With CPM3 access/create are mutually exclusive. You can have one or the
  80.     other, but NOT both.
  81.  
  82.      = -  Show files whose date matches input date exactly
  83.      + -  Show files whose date is equal or after input date
  84.      - -  Show files whose date is before input date
  85.      % -  Use update date for matches
  86.      @ -  Use last access/create date for matches. 
  87.      Z -  Show file dates
  88.  
  89. COMMENTS:
  90. ---------
  91. Using the $D option automatically starts on the first available drive
  92. (usually A:) regardless of what drive you were on when you started.  It
  93. then checks all available drives.  Similarly, using the $A option will
  94. always start with User 0 and individually display each available user
  95. area.  If desired you can include a specified drive/user area on the
  96. command line.  Any of the following can be used:
  97.  
  98.  
  99. EXAMPLES OF USE:
  100. ---------------
  101.  
  102.         1)  B0>SD
  103.         2)  B0>SD *.*
  104.         3)  B0>SD *.COM
  105.         4)  B0>SD C4:
  106.         5)  B0>SD C4: *.COM
  107.         6)  B0>SD $AND
  108.         7)  B0>SD *.COM $AND
  109.         8)  B0>SD *.COM /AND
  110.         9)  B0>SD *.COM[AND
  111. "Z80DOS or CPM3 support"
  112.         10)  B0>SD *.* /= 7/2/88
  113.         11)  B0>SD /=@ 7/2/88
  114.         12)  B0>SD /+! 7/2/88
  115.         13)  B0>SD *.* / 7/2/88 8/15/88
  116.         14)  B0>SD / *-10 *-5
  117.         15)  B0>SD / 7/2/88+5 7/10/88-1
  118.  
  119.     1)    Shows all files on the current drive/user area
  120.     2)    Same as 1)
  121.     3)    All files with .COM extent on current drive/user area
  122.     4)    All files on C4: drive/user area
  123.     5)    All .COM files on C4:
  124.     6)    Shows files on all drives and all user areas, nonstop
  125.       (very useful for making a remote listing of all files)
  126.     7)    All .COM files on all drives and all user areas, nonstop
  127.     8)    Can use '/' UNIX-type command rather than $ if preferred
  128.     9)    Can use '[' CP/M+ type command, no space is permitted
  129.  
  130. "Z80DOS or CPM3 support"
  131.  
  132.    10)  Show files whose alteration date matches 7/2/88
  133.    11)  Show files whose last access date matches 7/2/88
  134.    12)  Show files whose creation date was on or after 7/2/88
  135.    13)    Show files whose alteration date is beteen 7/2/88 and 8/15/88
  136.    14)    Show files whose alteration date is between current date-5 days and
  137.                             current date-10 days
  138.    15)    Show files whose alteration date is between 7/7/88 and 7/9/88
  139. OPTIONAL COMMANDS:
  140. ----------------
  141.  
  142. "A" -    All users:  Causes SD to display the directories of all
  143.     the user areas starting at user 0 and continuing to the
  144.     maximum available.  Most systems have 16 user areas 0-15
  145.     but CP/M+ etc., can have 32 user areas 0-31.
  146.  
  147. "C" -    Shows file sizes in records: Gives individual cile sizes
  148.     in records instead of "k".  Sizes are followed by "r"
  149.     instead of the normal "k" to indicate this option in ef-
  150.     fect.  Totals and library summary lines are still given
  151.     in "k". Very nice on larger disk systems where 16k might
  152.     be anything from 97-128 records.
  153.  
  154. "D" -    All disk option: Allows SD to search all disk drives on-
  155.     line.      It starts with the disk drive specified or im-
  156.     plied with the command line filename.    Example:
  157.  
  158.         B0>SD $D       Shows all drives starting with A:
  159.         B0>SD C:$D     SHows all drives starting with C:
  160.  
  161. "F" -    File option: The directory output will be sent to a disk
  162.     file named "DISK.DIR" on the default drive. If this name
  163.     already is present on that drive then the directory out-
  164.     put will be appended to the end of the file.  "DISK.DIR"
  165.     will otherwise start as a new file.  The append feature
  166.     allows you to build up one massive file on the default
  167.     drive that contains the directories of all of your disks
  168.     without having to concatenate a lot of individual files.
  169.  
  170. "H" -    From here option:  Displays files on all user areas from
  171.     current to highest allowed (usually area 15 unless on a
  172.     RCPM system.)  It it handy to use on systems that have
  173.     MANY files on user 0 area, to see what remains on the
  174.     other user areas.  If on B5: for example, using $H would
  175.     show files on all user aread from B5: through B15: if
  176.     permitted to go that high.  (The $A option is ignored if
  177.     included, else the $H option would not be requested.)
  178.  
  179. "L" -    LBR list option:  Allows for listing of ".LBR", ".ARC"
  180.     or ".ARK" file members which are shown followed by their
  181.     length in 'k' (or 'r', if the 'C' option is used).  The
  182.     total length of the entire library is is also shown.
  183.     These are always alphabetized horizontally and may have
  184.     a little border (assembler option) at the left, showing
  185.     it is a library listing.
  186.  
  187. "N" -    No page option:  Shows the display without stopping each
  188.     when the screen is full.  Particularly useful for remote
  189.     users on an RCPM so they can display the entire director
  190.     non-stop for disk copy, etc. by using $AND, etc.
  191.  
  192. "O" -    Shows only $SYS files: Very useful on large system where
  193.     it is harder to notice an occasional $SYS file.
  194.  
  195. "P" -    Copy output to printer:  Highlighting characters are not
  196.     sent (for files that are archived or set as $SYS files)
  197.     and the "N" option is automatically selected to prevent
  198.     [more] pauses.  To insure the file names are similar in
  199.     appearance, only upper-case characters are sent to the
  200.     printer.
  201.  
  202. "Q" -    Shows unarchived files:  Show the files that do NOT have
  203.     the archive flag in a file's directory entry, set.  This
  204.     will show new files that have been recently added to the
  205.     disk. For example, to see a list of ALL new files in ALL
  206.     user areas of ALL drives:
  207.  
  208.         B0>SD $ADQ <ret>
  209.  
  210.     To see the new files in just the area that you are cur-
  211.     rently logged into, enter:
  212.  
  213.             B0>SD $Q <ret>
  214.  
  215.     (Note: This is worthless on systems that do not use any
  216.     archive backup system.)
  217.  
  218. "R" -    Reset disk system:  A disk system reset is done before
  219.     directory information is accumulated. Useful to show the
  220.     correct free space remaining when a new disk has been
  221.     inserted, etc.  (Without a reset, it will show the re-
  222.     maining space for whatever disk was last logged in.) Not
  223.     useful and a waste of time on a hard drive.)
  224.  
  225. "S" -    Include $SYS files:  Files with the $SYS attribute set
  226.     are normally not displayed.  This option includes them.
  227.     Also see the "O" which displays ONLY the $SYS files.
  228.  
  229. "T" -    Order files by type:  Alphabetizes files by type (exten-
  230.     sion).  This groups files of the same type together such
  231.     as .ASM, COM, LBR.)
  232.  
  233. "V" -    SD Version number, suffix, and date is displayed.
  234.  
  235. "X" -    Use alternate listing format - If vertical alphabetiza-
  236.     tion is in effect normally, using this option will cause
  237.     a horizontal listing to be shown.  If horizontal is the
  238.     default, then this option produces a vertical listing.
  239. "1" -
  240. "2" -
  241. "3" -
  242. "4" -    Show only files that meet all other criteria and also have
  243.     this file attribute set. These may occur alone or with each
  244.     other, or with any other criteria. IE:
  245.         SD /1
  246.         SD /23
  247.         SD /1234
  248.         SD /SQ12
  249.     Wheel controllable as is /S.
  250.  
  251. "Z80DOS or CPM3 support"
  252.  
  253. "=" -   The date on the command line will be used for exact matches
  254.     with the date of the file.
  255. "+" -    The date on the command line will be used for matching the 
  256.     files whose date was on or after the files date.
  257. "-" -    The date on the command line will be used for matching all
  258.     files whose date was before this date.
  259. "!" -    The files creation date as known by Z80DOS [not cpm3] will be used.
  260. "%" -    The files alteration date as known by Z80DOS or CPM3 will be used.
  261. "@" -    The files last access date as know by Z80DOS or CPM3 will be used.
  262. "Z" -   Show file dates. 2 col with dates.
  263.                                   (vs 4 across display on 80 col screens)
  264.  
  265. Z80DOS or CPM3 support notes:
  266.  
  267.     1: If no date spec such as ! or % or @ is given, the files
  268.        alteration date will be used.
  269.     2: If no matching spec such as = or + or - is given, the match
  270.        will be an exact one.
  271.     3: If an input line such as SD / 7/2/88 is given, the default
  272.        will be the files alteration date will be matched exactly.
  273.     4: Date math now allows a range of dates to be specified for
  274.        matching files. Note that the options =+- become don't cares
  275.        when specifying a range.
  276.     5: Date math allows relative modifiers to a date, such that you
  277.        can specify + or - 255 days from a given date. Note that
  278.        the date, the + -, and the relative are NOT seperated by spaces.
  279.     6: When * is used as the date, it means current system time.
  280.     7: If the alteration or access date is requested, (or default alter)
  281.        and that date is null(0) for the file, the program will revert
  282.        to the creation date for a comparisons/display.
  283.