home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / dirutl / d-v100.lbr / D.DQC / D.DOC
Text File  |  1986-01-19  |  8KB  |  205 lines
  1.                   D -- A Z80 Directory Program
  2.  
  3.  
  4.      ─ i≤ ß director∙ prograφ writteε fo≥ CP/═ 2.° anΣ above«  I⌠ ì
  5. i≤á designeΣ t∩ givσ mos⌠ oµ thσ informatioε requireΣ b∙ ßá user¼ ì
  6. ye⌠ stil∞ bσ compact«  I⌠ wa≤ originall∙ writteε fo≥ CP/═ 3.░ bu⌠ ì
  7. ha≤ beeε revampeΣ t∩ worδ fo≥ thσ 2.° versions¼ also.
  8.  
  9.      ─á support≤á man∙ option≤ t∩ hel≡ thσ use≥ obtaiεá jus⌠á thσ ì
  10. informatioε s/hσ desires«  I⌠ wil∞ takσ ß littlσ timσ t∩ ge⌠ useΣ ì
  11. t∩á thesσ options¼á bu⌠ the∙ wil∞ becomσ easie≥ t∩ usσ anΣá their ì
  12. value and power will become more obvious as time goes on.
  13.  
  14.  
  15.      A summary of the options for D follows:
  16.  
  17.  
  18.           a -- get only archived files
  19.           b -- include system files
  20.           c -- comprehensive -- complete fcb info
  21.           f -- suppress filesize
  22.           g -- get from user # nn
  23.           n -- no form feed to printer
  24.           p -- going to the printer
  25.           r -- get only read-only files
  26.           s -- get only system files
  27.           u -- include all users
  28.           w -- get only r/w files
  29.           x -- do not sort the directory
  30.           z -- get only non-archived files
  31.  
  32. Options are specified with a left bracket:
  33.  
  34.           d b:[a    (or d b:[a] if you prefer) gets all the
  35.                     archived files from the current user #
  36.                     on drive b:.
  37.  
  38.           d e:[g4   gets all the non-system files from user 4
  39.                     on e:.
  40.  
  41.           d [sr     gets all the read-only system files from
  42.                     the current user of the default disk.
  43.  
  44.           d foo.*   gets all non-system files named 'foo' from
  45.                     the current user of the default disk.
  46.  
  47. .paè                       Option Explanations
  48.  
  49. a -- get only archived files.  This filters for files with the
  50.      Archive bit set (The Archive attribute is a CP/M 3.0
  51.      feature.)  See the z option.
  52.  
  53. b -- include system files.  Turns off the system file filter.
  54.      Allows BOTH system and non-system files to be displayed.
  55.      See the s option.
  56.  
  57. c -- comprehensive.  Display the complete directory entry.
  58.      All matching directory entries are shown in their entirety.
  59.      Option≤ no⌠ compatablσ witΦ thσ π optioε are║ f,x.  The
  60.      directory is unsorted for this option.
  61.  
  62. f -- suppress filesize.  Suppress the file size information.
  63.      Results in a more compact display.  Usually not used.
  64.  
  65. g -- get from user # nn.  Specifies which user area to
  66.      interrogate.  Will not interrogate user 32.  Format is
  67.      gn or gnn: g2, g15, etc.  Incompatable with the u option.
  68.      A valuable option if you use user areas.
  69.  
  70. n -- no form feed to printer.  If the p option is specified,
  71.      the leading form feed is suppressed.
  72.  
  73. p -- going to the printer.  Sends the directory to the printer.
  74.      See the n option.
  75.  
  76. r -- get only read-only files.  This filters for files that have
  77.      the RO attribute set.  See the w option.
  78.  
  79. ≤ -- ge⌠ onl∙ systeφ files«  Thi≤ filter≤ ou⌠ thσ non-system
  80.      files and allows only system files to be displayed.  See
  81.      the b option.
  82.  
  83. u -- include all users.  Searches all user areas for files.
  84.      Overrides the g option.
  85.  
  86. w -- get only r/w files.  This filters for files that are not
  87.      read-only.  See the r option.
  88.  
  89. x -- do not sort the directory.  The file display is not sorted.
  90.  
  91. z -- get only non-archived files.  This filters for files that
  92.      do not have the Archive bit set.  See option a.
  93.  
  94.  
  95. .paè                            Features
  96.  
  97.      Thσá director∙ displa∙ i≤ fairl∙ obvious¼á bu⌠ ßá fe≈á item≤ ì
  98. need explanation:
  99.  
  100.           The default filter is "no system files".
  101.  
  102.           Sort file entries is also a default.  Files, whether
  103.           sorted or unsorted are displayed in a columnar format.
  104.  
  105.           Director∙ entrie≤ displayeΣ iε aε alternatσ (dim)
  106.           format are system entries.
  107.  
  108.           The letter designating the file size can be 'k'
  109.           or 'r'.  The units are k (1024 bytes), but the
  110.           'r' is used to signify that the file is read-only.
  111.           The 'k' and the 'r' can also be displayed as a
  112.           'K' and an 'R'.  A capital 'K' or 'R' means that
  113.           the file has the Archive bit set.
  114.  
  115.           Alphabetic characters in a directory name are
  116.           reverse-cased -- All caps become lower-case and
  117.           all lower-case become caps.
  118.  
  119.           If a directory entry has a non-printable character
  120.           in it, that character is replaced by a '?'.
  121.  
  122.           If the c option is invoked, any space characters
  123.           with the high-bit set (i.e. an attribute bit) are
  124.           replaced with an alternate format (dim) '*'.
  125.  
  126.  
  127.                      Special Considerations
  128.  
  129.      Iµ yo⌡ owε CP/═ 3.0¼ yo⌡ ma∙ havσ noticeΣ tha⌠ single-lette≥ ì
  130. prograφá name≤á followeΣ b∙ thσ namσ oµ ß filσá oεá anothe≥á disδ ì
  131. confuse≤ thσ CCP«  S∩ iµ yo⌡ typσ (froφ thσ prompt⌐ A:>Σ b:*.bar¼ ì
  132. thσ CC╨ can'⌠ finΣ D«á  Thi≤ i≤ ß buτ iε thσ CCP«á  ╔ fixeΣ i⌠ iε ì
  133. mine¼á bu⌠á thσ solutioε i≤ to∩ comple° fo≥ ß simplσ fix¼á anΣá ╔ ì
  134. woulΣ havσ troublσ gettinτ arounΣ DR╔ iε providinτ ß lega∞ fi° t∩ ì
  135. it¼á s∩ ╔ recommenΣ renaminτ single-lette≥ program≤ runninτ unde≥ ì
  136. CP/M 3.0 to something else -- like DD.COM for D.COM.
  137.  
  138.      Bσá cautiou≤ wheε thσ disδ iε questioε i≤ se⌠ t∩á read-only«  ì
  139. Incredibl∙ spuriou≤ result≤ caε occur¼ especiall∙ unde≥ CP/═ 3.0«  ì
  140. ╔ coulΣ havσ rese⌠ thσ disδ iµ i⌠ wa≤ read-only¼á bu⌠ fo≥ variou≤ ì
  141. reason≤á ╔ diΣ not«á  S∩ wheε yo⌡ seσ thσ -- Disδ i≤ ReaΣ Onl∙ -- ì
  142. message, treat the D results with a grain of salt.
  143. .paè     CP/═á 3.░á support≤á disδá labels«á  Thesσá arσá actuall∙á ß ì
  144. director∙ entr∙ unde≥ use≥ 32«á  ─ look≤ fo≥ ß use≥ 3▓ entry¼ anΣ ì
  145. iµá i⌠ find≤ one¼á i⌠ i≤ listeΣ a≤ thσ disδ namσ jus⌠á afte≥á thσ ì
  146. user/drivσ callout«á  Otherwise¼ use≥ 3▓ i≤ no⌠ availablσ unde≥ ─ ì
  147. iε an∙ othe≥ circumstatnces«á  Iµ user≤ oµ CP/═ 2.° desirσ label≤ ì
  148. oε thei≥ disks¼ the∙ mus⌠ finΣ ß wa∙ t∩ instal∞ ß director∙ labe∞ ì
  149. entr∙á iεá use≥ 32«á  An∙ disδ utility¼á sucΦ a≤ DU╒ o≥á POWER(r⌐ ì
  150. coulΣá bσá useΣ t∩ d∩ thi≤ b∙ modifyinτ ß 0δ director∙á entr∙á t∩ ì
  151. user 32.  Please!! Experienced users only should try this!
  152.  
  153.  
  154.                           Installation
  155.  
  156.      ─á use≤ aε alternatσ forma⌠ fo≥ somσ displays«á  Usuall∙ thσ ì
  157. alternatσ forma⌠ i≤ diφ video«á  Oµ course¼á somσ terminal≤ don'⌠ ì
  158. suppor⌠ diφ video¼á bu⌠ d∩ suppor⌠ reversσ video¼á fo≥á instance«  ì
  159. Iεá thi≤ case¼á thσ alternatσ forma⌠ woulΣ bσ reversσá video«á  ─ ì
  160. come≤ witΦ diφ vide∩ se⌠ fo≥ thσ TeleVide∩ 925/950¼á o≥ an∙ othe≥ ì
  161. termina∞ tha⌠ use≤ thσ samσ codes¼ oµ course«  T∩ instal∞ anothe≥ ì
  162. codσá strinτ se⌠ fo≥ aε alternatσ forma⌠ fo≥ you≥ system¼á i⌠á i≤ ì
  163. necessar∙á t∩ alte≥ D.CO═ witΦ ß debugge≥ sucΦ a≤ DD╘ o≥á SI─á o≥ ì
  164. ZSID«
  165.  
  166. Load D.COM under your debugger:  DDT D.COM
  167.  
  168. The string to change TO the alternate format is located at 118.
  169.  
  170. Thσ strinτ t∩ changσ FRO═ thσ alternatσ forma⌠ bacδ t∩ thσ norma∞ ì
  171. format is located at 128.
  172.  
  173. Do a D100 and the setup will be obvious.
  174.  
  175. Changσá thσ string≤ a≤ requireΣ t∩ suppor⌠ aε alternatσ forma⌠ oε ì
  176. you≥ terminal«á  Terminatσ thσ string≤ witΦ ß NUL╠ (00)«  Iµ you≥ ì
  177. termina∞á doesn'⌠ suppor⌠ aε alternatσ format¼á NUL╠ thσá string≤ ì
  178. out entirely (not the alpha locator strings, though).
  179.  
  180. After changing the strings, SAVE the new file to your disk:
  181.  
  182.     CP/M 2.x is SAVE 14 D.COM
  183.  
  184.     CP/M 3.x users will save from 100 to e7f to DD.COM
  185.  
  186. The actual method of saving is system/debugger dependant.
  187.  
  188. .paè                        Legal Mumbo-Jumbo
  189.  
  190.     D.CO═ i≤ Copyrigh⌠ (c⌐ 198┤ Sourcσ Maverick«  Yo⌡ ma∙ usσ ì
  191. D.CO═á fo≥á you≥á owε purpose≤ othe≥ thaε sellinτá it«á  Yo⌡á ma∙ ì
  192. distributσ i⌠ a≤ yo⌡ wish¼á a≤ lonτ a≤ yo⌡ d∩ no⌠ chargσ fo≥á thσ ì
  193. program«  D.CO═ ma∙ bσ distributeΣ oε ß disδ witΦ othe≥ programs¼ ì
  194. fo≥á whicΦ therσ i≤ ß cop∙ chargσ ONL┘ associateΣ witΦ thσá disk«  ì
  195. Thσ cop∙ chargσ ma∙ no⌠ exceeΣ U╙ $2.0░ iε 198┤ dollars¼ however«  ì
  196. Thσá autho≥á assume≤á n∩á liabilit∙ whatsoeve≥á witΦá respec⌠á t∩ ì
  197. anothe≥ party'≤ usagσ oµ D.COM¼ you≥ acceptancσ oµ thi≤ statemen⌠ ì
  198. beinτ ß prerequisitσ t∩ saiΣ party'≤ usσ oµ thσ program«á  (Afte≥ ì
  199. all¼ yo⌡ go⌠ i⌠ fo≥ free.)
  200.  
  201.  
  202.                                    Hank Blake
  203.                                    Source Maverick
  204.                                    San Diego, Ca.
  205.