home *** CD-ROM | disk | FTP | other *** search
/ Oakland CPM Archive / oakcpm.iso / cpm / sysutl / egutil53.lbr / DR.DZC / DR.DOC
Encoding:
Text File  |  1988-07-12  |  6.5 KB  |  167 lines
  1. ;;12-22-87
  2.  
  3.                            DR.DOC v2.4
  4.                             12/28/87
  5.  
  6. Eric Gans
  7. French Dep't UCLA
  8. Los Angeles, CA 90024
  9.  
  10.  
  11.      The  distinctive  feature  of  this  alphabetical  directory 
  12. program  is that it gives the number of 128-byte  records/sectors 
  13. in each file as well as the number of K in its allocation blocks. 
  14. This information is useful when composing file libraries, sending 
  15. files via modem, or checking for different versions of a file.
  16.  
  17. Version 2.4
  18.  
  19. Added  DOS DIR syntax (fn.  = fn.* etc.)  Interprets switch alone 
  20. entries (e.g.,   dr /d) correctly.   Added /E   option  for  sort  
  21. by  file  extension.    (Also  see   FILX documentation below.)
  22.  
  23. Version 2.3
  24.  
  25. Fixed  a bug in line count.   Added separate 5-byte inverse video 
  26. on/off codes for easier patching. 
  27.  
  28. DR 2+ allows: 
  29.  
  30.      - "Paging" (backwards & forwards) through the directory
  31.      - Writing its output to a disk file and/or the printer
  32.      - Multi-drive and multi-user directory search
  33.  
  34. Format: dr [[d][u]:][filemask] [/switches]
  35.  
  36. The  colon  is only necessary if a user and/or drive is  entered.  
  37. Current will be assumed, and if no filemask is given, *.* will be 
  38. assumed.  A space is necessary before the switches.
  39.  
  40.                    User-Friendly Syntax (v2.4)
  41.  
  42. The  following convenient alternatives (mostly familiar to  users 
  43. of the MS-DOS 'DIR' command) are now supported:
  44.  
  45.      filename.      = filename.???
  46.      .typ or *typ   = ????????.typ
  47.      *              = ????????.
  48.      *.   or **     = ????????.???
  49.      filenametyp    = filename.typ (if 'filename' has 8 letters!)
  50.  
  51. The switches are as follows:
  52.  
  53. W   =  Write  output  to  file.   You  will  be  prompted  for  a 
  54. drive/filename; default is -DIRFL.DRF on the current drive.
  55.  
  56. D = Multi-drive directory.   You may enter a (1 hex digit) number 
  57. after  the  "D"  to indicate the maximum drive  to  be  searched; 
  58. otherwise the number at 102H (default = 3) will be used.
  59.  
  60. U  = Multi-user directory.   As opposed to the output of the  "*" 
  61. user  command,  which  puts all files into a single  alphabetized 
  62. list,  the "U" switch creates separate lists for each user  area.  
  63. The  maximum  user  to be searched (default=15) can be  set  from
  64. within  the program by adding a hex digit (0-F).   The "U" switch 
  65. is automatically disabled if you indicate a user area  (including 
  66. # or *) when calling the program.
  67.  
  68. P = Send output to printer.  If you use this switch the directory 
  69. will not appear on the screen.   Multi-page directories will each 
  70. start  on a new page;  if you don't like this  feature,  see  the 
  71. customization section below.
  72.  
  73. E  =  Sort  files  by extension (the last  3  characters  in  the 
  74. filename).  This allows you to find related groups of files.
  75.  
  76. Examples: dr 3: /d  will list all drives user 3;  dr /d3uf  lists    
  77. all  user areas in 15 drives (45 lists);  dr *:  /d3 will  output 
  78. three  lists including all files on each drive;   dr *.com  /dupw 
  79. will  print  and make a file of all *.com files on 3 drives *  15 
  80. users  (this  will use 45 sheets of paper if you don't  kill  the 
  81. form-feed feature!)
  82.  
  83. A  maximum  of  64  "pages" (screens and/or  separate  lists)  is 
  84. permitted; this should be more than enough for 3 drives/15 users, 
  85. perhaps even for 4 drives. 
  86.  
  87. NB:  If you use both "U" and "D" or "E" switches, DON'T put the U 
  88. switch first;  DR will interpret /ud as user 0-13, since D is the 
  89. hex digit 13. 
  90.  
  91.                            Customizing
  92.  
  93. This has been simplified in versions 2.1 & 2.3
  94.  
  95. The  following addresses may be patched with SRW,  PATCH or  even 
  96. good old DDT:
  97.  
  98.             Hex Address(es)  Original setting(s)
  99.  
  100. MAXDSK         102                 3
  101. MAXUS          103                 15 (0Fh)
  102. NO_FF          104                 0 (inactive)
  103. NO_VID         105                 0 (inactive)
  104.  
  105. INV VID ON     106-10B        ESC B0 (1B,42,30) + 0,0,0
  106. INV VID OFF    10C-111        ESC C0 (1B,43,30) + 0,0,0
  107.  
  108. 1.  MAXDSK  gives  the  (default) number of drives  for  the  "D" 
  109. switch.   Whatever its setting, it can be overridden if you enter 
  110. a number after the "D".
  111.  
  112. 2.  MAXUS is the default maximum user for the "U" switch;  it can 
  113. likewise be overridden.
  114.  
  115. 3.  If  NO_FF is set to a non-zero value,  a form feed (0CH) will 
  116. not be sent to the printer after each page when the "P" switch is 
  117. used.
  118.  
  119. 4.  If NO_VID is non-zero,  the video routine that displays  high 
  120. bits will be turned off.   If your system supports such a routine 
  121. but uses different codes,  you should keep NO_VID as is and patch 
  122. 106-10B  and 10C-111.  This now (v2.3) allows up to 5  bytes  for 
  123. both on and off routines.  The sixth byte in each must remain 0.
  124.  
  125. NB:  If  you use the "P" switch the video routine will be  killed 
  126. regardless of the NO_VID setting;  thus if you make a file at the 
  127. same time, the video bytes will not be included.
  128.  
  129.                          Other features
  130.  
  131.      - backward & forward paging through long directories without 
  132. rerunning  program (this suggestion is due to Merlin  Null).  The 
  133. pages will "wrap around"; you may exit at any time. 
  134.  
  135.      - files alphabetized in vertical columns (63 files/screen).
  136.  
  137.      - ZCPR drive/user syntax:  either drive,  user,  or both can 
  138. precede the colon (a3: 5: d:). 
  139.  
  140.      - [d]*:  will  make  a single list of all files on drive  d: 
  141. specifying  the user for each.  dr *:  /d gives all files on  all 
  142. drives  (one list per drive);  dr /du makes a separate  list  for 
  143. each drive/user.
  144.  
  145.      - [d]#: will list all erased files in the directory on drive 
  146. d:  (useful  before running unerase programs which usually  allow 
  147. only  unambiguous  file names).  
  148.  
  149.      - gives  number of files,  KBytes in files & on  drive,  and 
  150. remaining free space.
  151.  
  152.      - inverse video indicates high bits set.
  153.  
  154.      - DR  2.4 still occupies only 4 K (26 sectors  as opposed to 
  155. 32 for SD.COM).  Even in this more memory-intensive version it is 
  156. still the fastest around.   On a 64K system it allows up to about 
  157. 1300  files in a single search.   (If it overwrites the  CCP,  DR 
  158. will do a Warm Boot.)
  159.  
  160.                           FILX.COM v1.0
  161.  
  162. FILX  is  a special version of DR that lists files  by  extension 
  163. without  other information like length or user area so as to  get 
  164. more files per screen.    All the  DR switches  and syntax may be 
  165. used,  except that no filemask can be  given.  After using an MS-
  166. DOS  PD program called FILEX,   I found this kind of listing very 
  167. useful for cleaning up directories.