home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / fog / starter / sd.doc < prev    next >
Encoding:
Text File  |  1993-05-06  |  7.6 KB  |  190 lines
  1.  
  2. SD130.DOC         Documentary help guide            09 Jan 88
  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 very beneficial when using your computer.
  23.  
  24.     To get a HELP Summary of Options:
  25.  
  26.             B0>SD ?
  27.  
  28.     Example of Option Usage:
  29.  
  30.             B0>SD $ANDLV (...etc.)
  31.  
  32. (The "$"  denotes start of commands but "/" or "[" may also be used.)
  33.  
  34.  
  35. QUICK SUMMARY OF OPTIONS:
  36. -------------------------
  37.  
  38.      A -  all user areas allowed, (0-15), some systems (0-31)
  39.      C -  shows file sizes in records, rather than 'k'
  40.      D -  all  drives starting with first available (usually A:)
  41.      F -  file "DISK.DIR" created/appended with contents of output
  42.      H -  shows all user areas from here to highest
  43.      L -  LBR/ARC/ARK list option (shows names of member files)
  44.      N -  defeats the page pause, permits non-stop display
  45.      O -  shows only $SYS files in directory
  46.      P -  copies output to printer
  47.      Q -  shows files that have NOT yet been archived
  48.      R -  resets  disk, if not already logged in
  49.      S -  include any $SYS files
  50.      T -  sorts files by type (extent)
  51.      V -  shows version number and date
  52.      X -  uses alternate listing format (horizontal/vertical)
  53.  
  54.  
  55. COMMENTS:
  56. ---------
  57. Using the $D option automatically starts on the first available drive
  58. (usually A:) drive regardless of what drive you were on when you started.
  59. It then checks all available drives.  Similarly, using the $A option
  60. will always start with User 0 and individually display each available
  61. user area.  If desired you can include a specified drive/user area on
  62. the command line.  Any of the following can be used:
  63.  
  64.  
  65. EXAMPLES OF USE:
  66. ---------------
  67.  
  68.         1)  B0>SD
  69.         2)  B0>SD *.*
  70.         3)  B0>SD *.COM
  71.         4)  B0>SD C4:
  72.         5)  B0>SD C4: *.COM
  73.         6)  B0>SD $AND
  74.         7)  B0>SD *.COM $AND
  75.         8)  B0>SD *.COM /AND
  76.         9)  B0>SD *.COM[AND
  77.  
  78.     1)    Normal use to show all files on the current drive/user area
  79.     2)    Same as 1), shows all files on the current drive/user area
  80.     3)    All files with .COM extent on current drive/user area
  81.     4)    All files on C4: drive/user area, seldom used but possible
  82.     5)    All .COM files on C4:  (normally you would go to C4: first)
  83.     6)    Shows all files on all drives and all user areas, no pauses
  84.        (very useful for making a remote listing of all files)
  85.     7)    All .COM files on all drives and all user areas, no pauses
  86.     8)    Can use '/' UNIX-type command rather than '$' if you prefer
  87.     9)    Can use CP/M+ type command, note no space is permitted here
  88.  
  89.  
  90. OPTIONAL COMMANDS:
  91. ----------------
  92.  
  93. "A" -    All users:  Causes SD to display the directories of all the user
  94.     areas starting at user 0 and continuing to the maximum
  95.     available.  Most systems have 16 user areas, 0-15 but CP/M+ etc.
  96.     can have 32 user areas 0-31.
  97.  
  98. "C" -    Shows file sizes in records:  Gives individual cile sizes in
  99.     records instead of "k".  Sizes are followed by "r" instead of
  100.     the normal "k" to indicate this option in effect.  Totals and
  101.     library summary lines are still reported in "k".  Very nice on
  102.     larger disk systems where 16k might be anything from 97-128
  103.     records.
  104.  
  105. "D" -    All disk option:  Allows SD to search all disk drives on-line.
  106.     It starts with the disk drive specified or implied with the
  107.     command line filename.    Example:
  108.  
  109.         B0>SD $D    Shows all drives starting with A:
  110.         B0>SD C:$D    SHows all drives starting with C:
  111.  
  112. "F" -    File option:  The directory output will be sent to a disk file
  113.     named "DISK.DIR" on the default drive.    If this name already is
  114.     present on that drive, then the directory output will be
  115.     appended to the end of the file.  "DISK.DIR" will otherwise
  116.     start as a new file.  The append feature allows you to build up
  117.     one massive file on the default drive that contains the
  118.     directories of all of your disks, without having to concatenate
  119.     a swarm of individual files.
  120.  
  121. "H" -    From here option:  Displays files on all user areas from current
  122.     to highest allowed (usually area 15 unless on a RCPM system.)
  123.     It it handy to use on systems that have MANY files on user 0
  124.     area, to see what remains on the other user areas.  If on B5:
  125.     for example, using $H would show all the files (if any) from B5:
  126.     through B15: if permitted to go that high.  (The $A option is
  127.     ignored, if included, otherwise the $H option would not be
  128.     requested.)
  129.  
  130. "L" -    LBR list option:  Allows for listing of ".LBR", ".ARC", or ".ARK"
  131.     file members which are shown followed by their length in 'k' (or
  132.     'r', if the 'C' option is used).  The total length of the entire
  133.     library is is also shown.  These are always alphabetized hori-
  134.     zontally and may have a little border (assembler option) at the
  135.     left, showing it is a library listing.
  136.  
  137. "N" -    No page option:  Shows the display without stopping each when
  138.     the screen is full.  Particularly useful for remote users on an
  139.     RCPM so they can display the entire director non-stop for disk
  140.     copy, etc. by using $AND, etc.
  141.  
  142. "O" -    Shows only $SYS files:    Very useful on large system where it is
  143.     harder to notice an occasional $SYS file.
  144.  
  145. "P" -    Copy output to printer:  Highlighting characters are not sent
  146.     (for files that are archived or set as $SYS files) and the "N"
  147.     option is automatically selected to prevent [more] pauses.  To
  148.     insure the file names are similar in appearance, only upper-case
  149.     characters are sent to the printer.
  150.  
  151. "Q" -    Shows unarchived files:  Show the files that do NOT have the
  152.     archive flag in a file's directory entry, set.    This will show
  153.     new files that have been recently added to the disk.  For
  154.     example, to see a list of ALL new files in ALL user areas of ALL
  155.     drives:
  156.  
  157.         B0>SD $ADQ <ret>
  158.  
  159.     To see the new files in just the area that you are currently
  160.     logged into, enter:
  161.  
  162.             B0>SD $Q <ret>
  163.  
  164.     (Note: This is worthless on systems that do not use any archive
  165.     backup system.)
  166.  
  167. "R" -    Reset disk system:  A disk system reset is done before directory
  168.     information is accumulated.  Useful to show the correct free
  169.     space remaining when a new diskette has been inserted, etc.
  170.     (Without a reset, it will show the remaining space for whatever
  171.     disk was last logged in.)  Not useful and a waste of time on a
  172.     hard drive.
  173.  
  174. "S" -    Include $SYS files:  Files with  the $SYS attribute set are
  175.     normally not displayed.  This option includes them.  Also see
  176.     the "O" which displays ONLY the $SYS files.
  177.  
  178. "T" -    Order files by type:  Alphabetizes files by type (extension).
  179.     This groups files of the same type together.  Such as .ASM, COM,
  180.     LBR.)
  181.  
  182. "V" -    SD Version number, suffix, and date is displayed.
  183.  
  184. "X" -    Use alternate listing format - If vertical alphabetization is in
  185.     effect normally, using this option will cause a horizontal
  186.     listing to be shown.  If horizontal is the default, then this
  187.     option produces a vertical listing.
  188.  
  189.                   - Notes by Tom Ensminger and others
  190.