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