home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / zsus / z3help / z.lbr / ZFIND.HZP / ZFIND.HLP
Encoding:
Text File  |  1991-11-18  |  11.6 KB  |  250 lines

  1. ;
  2.                                                   
  3.                             ---  Z F I N D  ---          
  4.                                                   
  5.                                 Version 1.4
  6.  
  7.                         A ZCPR3 String Find Utility
  8.  
  9.  
  10.  
  11.                            I -->  Installation    
  12.                            C -->  Configuration   
  13.                            O -->  Operation       
  14.                            S -->  Syntax          
  15.                            / -->  Options         
  16.                            A -->  Applications  
  17. :I                       
  18. Installation
  19.  
  20. Thσ distributioε versioε oµ ZFIN─ i≤ supplieΣ witΦ ß Z3EN╓ addres≤ oµ ì
  21. 0000H¼ read∙ fo≥ usσ iε ZCPR33½ environments«  ZCPR3░ user≤ shoulΣ instal∞ ì
  22. ZFIN─ usinτ thei≥ regula≥ installatioε method.
  23. :C
  24. Configurationì
  25.  
  26. ZCNFG.CO═ anΣ ZFIND.CF╟ ma∙ bσ useΣ t∩ configurσ thσ operatioε oµ ZFIN─ t∩ ì
  27. sui⌠ thσ user«  Severa∞ optioε default≤ ma∙ bσ set«  Thσ commanΣ linσ hel≡ ì
  28. screeε wil∞ reflec⌠ thσ curren⌠ defaul⌠ settings«  Seσ thσ Option≤ sectioε ì
  29. fo≥ morσ information« 
  30. :O
  31. üOperatioε - 1/2
  32.  
  33. ZFIN─ i≤ ß smal∞ (4k⌐ ZCPR│ strinτ finΣ utility¼ simila≥ iε operatioε t∩ ì
  34. Ir÷ Hoff'≤ FIND.COM¼ bu⌠ MUC╚ faster«  I⌠ searche≤ ASCI╔ tex⌠ file≤ fo≥ ì
  35. specifieΣ searcΦ string≤ usinτ ß versioε oµ thσ ver∙ fas⌠ Boyer-Moorσ ì
  36. searcΦ algorithφ anΣ caε senΣ thσ outpu⌠ t∩ ß file«  
  37.  
  38. ZFIN─ i≤ primaril∙ designeΣ a≤ ß quicδ 'check' utility«  I⌠ caε bσ ver∙ ì
  39. usefu∞ wheε yo⌡ wisΦ t∩ know¼ fo≥ example¼ whicΦ oµ severa∞ sourcσ codσ ì
  40. module≤ contain≤ ß specifiπ routine«  I⌠ i≤ als∩ ver∙ usefu∞ for quicδ ì
  41. searche≤ oµ MAST.CA╘ file≤ o≥ tex⌠ articlσ inde° files«  
  42.  
  43. SearcΦ string≤ entereΣ oε thσ commanΣ linσ wil∞ bσ matcheΣ ignorinτ thσ ì
  44. difference≤ betweeε uppe≥ anΣ lowe≥ casσ characters«  Iµ n∩ strinτ i≤ ì
  45. entereΣ oε thσ commanΣ line¼ yo⌡ wil∞ bσ prompteΣ fo≥ ß string«  String≤ ì
  46. entereΣ a⌠ thσ promp⌠ wil∞ bσ matcheΣ onl∙ iµ the∙ arσ founΣ t∩ bσ exactl∙ ì
  47. a≤ entered.  Searches may be aborted by entering ^C.
  48. Operation - 2/2 
  49.  
  50. ZFIN─ read≤ thσ specifieΣ files¼ onσ a⌠ ß time¼ int∩ ß 16δ buffe≥ anΣ ì
  51. attempt≤ t∩ matcΦ al∞ requesteΣ string≤ witΦ thσ tex⌠ iε thσ buffer«  
  52.  
  53. Wheε searchinτ fo≥ morσ thaε onσ string, ZFIN─ searche≤ thσ entirσ buffe≥ ì
  54. fo≥ eacΦ string iε turn¼ displayinτ eacΦ match«  A≤ ß result¼ iµ therσ i≤ ì
  55. ß linσ o≥ delimiteΣ blocδ iε thσ tex⌠ tha⌠ include≤ morσ thaε onσ string¼ ì
  56. ZFIN─ wil∞ displa∙ thσ samσ linσ o≥ delimiteΣ blocδ eacΦ timσ i⌠ matche≤ ì
  57. onσ oµ thσ strings«  
  58.  
  59. Wheε file≤ arσ large≥ thaε 16k¼ thσ entirσ searcΦ proces≤ i≤ repeateΣ froφ ì
  60. scratcΦ eacΦ timσ thσ 16δ buffe≥ i≤ refilled«  Onl∙ afte≥ searchinτ thσ ì
  61. curren⌠ buffe≥ fo≥ al∞ oµ thσ string≤ wil∞ ZFIN─ refil∞ thσ buffe≥ anΣ ì
  62. searcΦ thσ ne≈ buffe≥ fo≥ al∞ thσ strings.
  63.  
  64. T∩ avoiΣ thσ problem≤ tha⌠ caε bσ createΣ wheε contro∞ characters¼ sucΦ a≤ ì
  65. printe≥ contro∞ code≤ embeddeΣ iε tex⌠ files¼ arσ sen⌠ t∩ terminals¼ ZFIN─ ì
  66. doe≤ no⌠ displa∙ filσ character≤ les≤ thaε 20Φ (º '⌐ excep⌠ fo≥ thσ bel∞ ì
  67. (07h)¼ backspacσ (08h)¼ tab(09h)¼ linσ feeΣ (0ah⌐ anΣ carriagσ returε (0dh⌐ ì
  68. characters«  Tab≤ arσ expanded.
  69. Special Search String Characters
  70.  
  71. Thσ followinτ specia∞ character≤ ma∙ bσ includeΣ iε thσ searcΦ string«  A≤ ì
  72. ß sidσ effect¼ i⌠ i≤ impossiblσ t∩ directl∙ searcΦ fo≥ an∙ oµ thesσ ì
  73. characters¼ a≤ the∙ wil∞ bσ interpreteΣ a≤ commanΣ character≤ a≤ describeΣ ì
  74. below«  
  75.  
  76.     '|'  provide≤ aε 'ORº function¼ anΣ i≤ useΣ t∩ separatσ multiplσ searcΦ ì
  77. áááááááááástrings«  ZFIN─ wil∞ searcΦ thσ tex⌠ file≤ fo≥ eacΦ specifieΣ ì
  78. áááááááááásearcΦ string«  ┴ '|º ma∙ als∩ bσ useΣ a≤ ß leadinτ characte≥ iε ì
  79. ááááááááááthσ commanΣ linσ modσ t∩ specif∙ significan⌠ leadinτ spaces«  Fo≥ ì
  80. ááááááááááexample¼ 'ⁿ  fordº wil∞ matcΦ º  fordº bu⌠ no⌠ 'fordº o≥ ì
  81. áááááááááá'afford'«  
  82.  
  83.     '?'  i≤ ß wildcarΣ characte≥ tha⌠ wil∞ matcΦ an∙ singlσ tex⌠ character«  ì
  84. ááááááááááIµ '?º i≤ useΣ a≤ thσ searcΦ string¼ ZFIN─ wil∞ als∩ servσ a≤ ß ì
  85. áááááááááásimplσ pageΣ filσ viewinτ utility.
  86.  
  87.     '-'  matches a TAB character.
  88.  
  89.     '\'  matche≤ ß linσ feed¼ allowinτ yo⌡ t∩ matcΦ onl∙ string≤ startinτ ì
  90. ááááááááááa⌠ thσ beginninτ oµ ß line.
  91. Searching for Special Characters
  92.  
  93. Severa∞ specia∞ commanΣ linσ optioε prefi° character≤ arσ als∩ treateΣ a≤ ì
  94. command≤ durinτ searcΦ strinτ parsinτ anΣ consequentl∙ can'⌠ bσ searcheΣ ì
  95. for«  Thσ specia∞ character≤ are:
  96.  
  97.           ?    Wildcard character
  98.           _    Tab
  99.           \    Line start
  100.           |    OR
  101.           /    Option prefix
  102.  
  103. Iµ yo⌡ wisΦ t∩ includσ specia∞ character≤ iε ß searcΦ string¼ substitutσ ì
  104. '?º wildcarΣ character≤ fo≥ thσ specia∞ characters.
  105.  
  106. Whilσ thσ specia∞ filσ outpu⌠ prefi° characte≥ '>º can'⌠ bσ includeΣ iε ß ì
  107. searcΦ strinτ entereΣ oε thσ commanΣ line¼ i⌠ ma∙ bσ includeΣ iε ß searcΦ ì
  108. strinτ entereΣ a⌠ thσ prompt¼ wherσ it≤ specia∞ meaninτ wil∞ bσ ignored«  
  109. :S
  110. Syntaxì
  111.  
  112. The command line synta° is:
  113.  
  114.    ZFIN─ [dir:]afε [string(s)▌ [>outfile] [/options]
  115.    If no string is included, one will be requested,
  116.      permitting a search for lower-case characters.
  117.    Special string characters:
  118.        "|" separates multiple search strings
  119.        "?" matches any character
  120.        "_" matches tab
  121.        "\" matches beginning of line
  122.  
  123. I⌠ i≤ assumeΣ tha⌠ therσ wil∞ bσ onσ spacσ betweeε thσ las⌠ search string ì
  124. characte≥ anΣ thσ firs⌠ optioε selection«  An∙ additiona∞ space≤ wil∞ bσ ì
  125. assumeΣ t∩ bσ ß par⌠ oµ thσ search string«  
  126. :/
  127. Options
  128.  
  129. Option≤ mus⌠ bσ entereΣ afte≥ thσ search string«  The∙ mus⌠ bσ prefixeΣ ì
  130. witΦ ß '/º character¼ bu⌠ ma∙ bσ entereΣ iε an∙ order«  Yo⌡ ma∙ usσ ZCNF╟ ì
  131. t∩ configurσ thσ defaul⌠ optioε settings«  Usσ oµ thσ commanΣ linσ option≤ ì
  132. wil∞ togglσ thesσ defaul⌠ setting≤ anΣ thσ hel≡ screeε wil∞ displa∙ thσ ì
  133. curren⌠ useages:
  134.  
  135.  
  136.      U - Al∞ use≥ areas«  Allow≤ yo⌡ t∩ searcΦ fo≥ file≤ iε al∞ use≥ ì
  137. ááááááááááarea≤ oε thσ specifieΣ drivσ n∩ matte≥ whicΦ use≥ wa≤ specifieΣ ì
  138. ááááááááááoε thσ commanΣ line«  Thσ defaul⌠ i≤ t∩ searcΦ onl∙ thσ specifieΣ ì
  139. ááááááááááo≥ defaul⌠ use≥ areß oε thσ specifieΣ drive.
  140.  
  141.      A - Displa∙ al∞ filename≤ searched«  Thσ defaul⌠ i≤ t∩ displa∙ onl∙ ì
  142. ááááááááááthσ filename≤ containinτ matches.
  143.  
  144.      C - Displa∙ founΣ strinτ linσ iε context«  Thi≤ option¼ activσ onl∙ iε ì
  145. áááááááááálinσ displa∙ mode¼ display≤ thσ founΣ strinτ linσ iε ß '-----º ìèáááááááááádelimiteΣ block¼ alonτ witΦ thσ previou≤ anΣ nex⌠ lines. ì
  146.  
  147.      B - Displa∙ thσ delimiteΣ blocδ iε whicΦ thσ strinτ wa≤ founΣ  
  148.           (when the default is line display).
  149.                                   - OR -
  150.      L - Displa∙ thσ founΣ strinτ iε thσ linσ iε whicΦ i⌠ wa≤ found
  151.           (when the default is delimited block display).
  152.  
  153.      D - Screeε displa∙ paging«  Thσ defaul⌠ i≤ t∩ pagσ thσ screeε display«  ì
  154. ááááááááááI⌠ ma∙ bσ usefu∞ t∩ turε thσ displa∙ paginτ ofµ wheε sendinτ thσ ì
  155. áááááááááámatcheΣ string≤ t∩ ß filσ iε orde≥ t∩ speeΣ u≡ thσ process«  
  156.  
  157.      O - Overwritσ an∙ existinτ outpu⌠ filσ withou⌠ asking«  Thσ defaul⌠ i≤ ì
  158. áááááááááát∩ asδ first«  Thi≤ optioε i≤ activσ iε filσ outpu⌠ modσ only¼ ì
  159. ááááááááááanΣ i≤ ignoreΣ iε filσ appenΣ mode.
  160. Display Options
  161.  
  162. ZFIN─ ha≤ threσ option≤ fo≥ matcheΣ strinτ displays«  Yo⌡ ma∙ usσ ZCNF╟ t∩ ì
  163. se⌠ thσ defaults«  Thσ selection≤ may als∩ bσ toggleΣ froφ thσ commanΣ ì
  164. line«  Thσ hel≡ screeε wil∞ sho≈ thσ curren⌠ defaults«  Thσ distributioε ì
  165. defaul⌠ i≤ t∩ displa∙ eacΦ linσ iε whicΦ thσ matcheΣ string≤ werσ found«  
  166.  
  167. Wheε operatinτ iε thσ linσ displa∙ mode¼ yo⌡ ma∙ usσ thσ 'Cº optioε t∩ ì
  168. displa∙ thσ matcheΣ strinτ iε 'context'¼ tha⌠ i≤ t∩ displa∙ i⌠ a≤ ß ì
  169. delimiteΣ ('-----'⌐ contex⌠ blocδ alonτ witΦ thσ previou≤ anΣ nex⌠ lines«  
  170.  
  171. Iε aε attemp⌠ t∩ avoiΣ to∩ mucΦ duplication¼ ZFIN─ doesn'⌠ re-searcΦ thσ ì
  172. las⌠ linσ displayeΣ (thσ 'nextº line⌐ fo≥ thσ searcΦ string«  S∩ iµ tw∩ ì
  173. consecutivσ line≤ contaiε thσ matcheΣ string¼ the∙ wil∞ bσ displayeΣ a≤ thσ ì
  174. seconΣ anΣ thirΣ line≤ oµ thσ contex⌠ blocδ anΣ thσ thirΣ linσ won'⌠ bσ ì
  175. redisplayeΣ a≤ par⌠ oµ thσ nex⌠ contex⌠ blocδ unles≤ therσ i≤ anothe≥ ì
  176. consecutivσ linσ containinτ thσ matcheΣ string.
  177.  
  178. Thσ contex⌠ optioε i≤ overriddeε wheε operatinτ iε thσ delimiteΣ blocδ ì
  179. displa∙ mode«  
  180.  
  181. Yo⌡ ma∙ als∩ choosσ t∩ displa∙ thσ blocδ oµ text¼ delimiteΣ b∙ ß ì
  182. configurablσ delimite≥ string¼ iε whicΦ thσ matcheΣ strinτ wa≤ found«  Thσ ì
  183. firs⌠ characte≥ iε thσ blocδ delimite≥ strinτ i≤ alway≤ ß linσ feed¼ a≤ thσ ì
  184. seconΣ delimite≥ characte≥ mus⌠ alway≤ begiε iε thσ firs⌠ column«  Yo⌡ ma∙ ì
  185. usσ ZCNF╟ t∩ configurσ thσ seconΣ delimite≥ characte≥ (entereΣ a≤ ß HE╪ ì
  186. character)«  Thσ defaul⌠ delimite≥ i≤ '-º (2dh)¼ whicΦ matche≤ thσ ì
  187. LF,'-----º delimite≥ strinτ useΣ t∩ separatσ entrie≤ iε FO╥ file≤ anΣ thσ ì
  188. delimite≥ strinτ useΣ b∙ XFOR.COM«  Thσ screeε displa∙ i≤ pauseΣ betweeε ì
  189. block≤ iµ paginτ i≤ enabled.
  190.  
  191. Iµ yo⌡ configurσ RETUR╬ (0dh⌐ a≤ you≥ delimiter¼ yo⌡ caε matcΦ doublσ-ì
  192. spaceΣ line≤ (cr,LF,CR,lf,'text')«  Thi≤ wil∞ allo≈ yo⌡ t∩ displa∙ singlσ-ì
  193. spaced delimiteΣ block≤ (paragraphs) separated by double-spaced lines.
  194. File Output
  195.  
  196.      >[dir:]outfilσ - SenΣ outpu⌠ t∩ thσ specifieΣ file«  N∩ wildcard≤ arσ ì
  197. ááááááááááaccepteΣ iε thσ filename«  Thσ defaul⌠ i≤ t∩ asδ beforσ ì
  198. ááááááááááoverwritinτ an∙ existinτ filσ oµ thσ samσ name¼ bu⌠ thσ 'Oº ì
  199. ááááááááááoptioε ma∙ bσ useΣ t∩ overwritσ withou⌠ asking.
  200.  
  201.      >>[dir:]outfilσ - AppenΣ outpu⌠ t∩ thσ specifieΣ file«  N∩ wildcard≤ ì
  202. ááááááááááarσ accepteΣ iε thσ filename«  Iµ thσ filσ doesn'⌠ exist¼ i⌠ wil∞ ì
  203. áááááááááábσ created.
  204. :A
  205. Line Display Applications
  206.  
  207. ZFIN─ i≤ usefu∞ fo≥ man∙ tex⌠ searchinτ applications«  Wheε yo⌡ wan⌠ t∩ d∩ ì
  208. fast filename lookups in MAST.CAT files, try the alias:
  209.  
  210.      LOOKUP zfind dir:mast.cat $*ì
  211.  
  212. Iµ yo⌡ subscribσ anΣ savσ interestinτ anΣ usefu∞ magazine≤ sucΦ a≤ Thσ ì
  213. Compute≥ Journal¼ yo⌡ ma∙ wisΦ t∩ creatσ anΣ maintaiε ß magazinσ inde° filσ ì
  214. fo≥ eacΦ oµ theφ iε orde≥ t∩ hel≡ yo⌡ finΣ topic≤ iε you≥ librar∙ oµ bacδ ì
  215. issues«  Onσ simplσ anΣ usefu∞ inde° filσ forma⌠ consist≤ oµ onσ o≥ morσ ì
  216. line≤ fo≥ eacΦ topiπ o≥ grou≡ oµ topic≤ iε aε issue«  EacΦ line¼ usuall∙ a≤ ì
  217. lonτ a≤ yo⌡ caε ge⌠ oε you≥ screen¼ begin≤ witΦ thσ issuσ anΣ pagσ number¼ ì
  218. followeΣ b∙ topiπ ke∙ words¼ notes¼ author¼ etc¼ dependinτ oε you≥ owε ì
  219. needs«  Fo≥ example¼ ß searcΦ oµ dir:TCJ.MA╟ fo≥ thσ ke∙ worΣ 'IOPº woulΣ ì
  220. turε up:
  221.  
  222.      ->dir:TCJ.MAG
  223.      29/22 ZCPR3 - ZCPR33, Z-COM Mods, IOP - Sage
  224.      30/13 IOP Support for AMPRO LB - NuKey - Swenton
  225.      40/36 ZCPR3 - Z-Nodes, BDS C, RAS, BYE, IOPs - Sage
  226.      50/37 Add Function Keys to a Kaypro - IOP - Laisley 
  227. Block Display Applications
  228.  
  229. Usσ ZFIN─ t∩ looδ u≡ ke∙ word≤ iε *.FO╥ files¼ displayinτ thσ entirσ FO╥ ì
  230. message≤ fo≥ thσ specifieΣ filename≤ usinτ thσ 'Dº option«  
  231.  
  232. Wheε settinτ u≡ ß magazinσ articlσ index¼ anΣ yo⌡ neeΣ t∩ pu⌠ morσ ì
  233. informatioε int∩ eacΦ 'recordº thaε fit≤ easil∙ int∩ ß singlσ line¼ yo⌡ caε ì
  234. creatσ ß 'cardº filσ oµ singlσ-spaceΣ topiπ o≥ articlσ paragraphs¼ ì
  235. separateΣ b∙ double-spaceΣ lines¼ wherσ eacΦ paragrapΦ contain≤ ke∙ word≤ ì
  236. anΣ topiπ summaries¼ descriptions¼ etc«  Configurσ ß cop∙ oµ ZFIN─ t∩ usσ ì
  237. 0DΦ (CR⌐ a≤ ß delimite≥ anΣ ZFIN─ wil∞ displa∙ thσ matcheΣ string≤ iε thσ ì
  238. paragraph≤ iε whicΦ the∙ werσ found«  ┴ searcΦ oµ FSM.MA╟ (FineScalσ ì
  239. Modeler⌐ fo≥ 'finishº migh⌠ turε u≡ thσ followinτ articles:
  240.  
  241.      ->dir:FSM.MAG
  242.      Nov90/4▓ - PAIN╘ FINIS╚ AIRBRUS╚ TECHNIQU┼ - Pau∞ Boye≥ - Basiπ ì
  243. áááááairbrushing«  AirbrusΦ workings¼ use¼ cleaning¼ troubleshooting«  ì
  244. áááááHomeworδ suggestions.
  245.  
  246.      July91/2┤ - PAIN╘ FINIS╚ TECHNIQU┼ AIRCRAF╘ GLOS╙ - Rodne∙ William≤ ì
  247. áááááSupe≥ higΦ glos≤ finisΦ - 1/3▓ Hasegawß P-51─ race≥ HΘ Timσ II«  Use≤ ì
  248. áááááFuturσ acryliπ floo≥ polish¼ N⌡ FinisΦ aut∩ polish¼ Bluσ Magiπ meta∞ ì
  249. ááááápolisΦ anΣ clea≥ acryliπ laque≥ ove≥ multiplσ coat≤ oµ enamel.
  250.