CP/M

home *** CD-ROM | disk | FTP | other *** search

/ CP/M / CPM_CDROM.iso / zsys / znode-12 / s / z3help04.lbr / SCAN.HZP / SCAN.HLP

Wrap

Text File | 1993-06-12 | 12.4 KB | 303 lines

; ü --- ╙ ├ ┴ ╬ --- Version 2.0A A ZCPR3-Compatible Buffered Bi-directional Video Oriented Text File Display Utility For Normal and Library Member Files I --> Installation O --> Overview S --> Syntax V --> Video Modes D --> Display Commands F --> Find Commands E --> Exit Commands M --> Modifications :I Installation for ZCPR3 environments ZCPR3.░ user≤ shoulΣ instal∞ thei≥ Z3EN╓ addres≤ int∩ SCA╬ iε thσ norma∞ ì manner« N∩ Z3EN╓ installatioε i≤ requireΣ fo≥ operatioε iε ZCPR3.3½ ì environments« T∩ hel≡ speeΣ u≡ thσ screeε displa∙ wheε scrollinτ thσ displa∙ bacδ onσ ì line¼ SCA╬ accept≤ aε optiona∞ Inser⌠ Linσ termina∞ contro∞ sequencσ ì extensioε t∩ thσ standarΣ ZCPR│ Z3TCA╨ iε thσ forma⌠ suggesteΣ b∙ Joσ ì Wright« T∩ makσ i⌠ easie≥ t∩ usσ witΦ standarΣ Z3TCAPS¼ however¼ SCA╬ ì firs⌠ look≤ fo≥ thσ Inser⌠ Linσ sequencσ a⌠ ß user-patchablσ interna∞ ì location« Iµ i⌠ isn'⌠ founΣ there¼ SCA╬ wil∞ looδ fo≥ i⌠ iε thσ Z3TCA╨ iε ì thσ ZCPR│ environment« Iµ n∩ Inser⌠ Linσ sequencσ i≤ founΣ iε thσ Z3TCAP¼ ì SCA╬ wil∞ inser⌠ ß linσ b∙ refreshinτ thσ wholσ screen¼ whicΦ take≤ ì slightl∙ longer« ì SCA╬ provide≤ patcΦ spacσ fo≥ ß bytσ printe≥ initializatioε string« Iµ ß ì strinτ i≤ present¼ i⌠ i≤ sen⌠ eacΦ timσ thσ prin⌠ functioε i≤ selected« Installation for non-ZCPR3 environments Fo≥ usσ iε non-ZCPR│ environments¼ SCA╬ contain≤ aε interna∞ 12╕ bytσ ì Z3TCAP« Yo⌡ ma∙ patcΦ you≥ termina∞ contro∞ sequence≤ directl∙ int∩ SCAN'≤ ì interna∞ Z3TCA╨ o≥ usσ DD╘ o≥ aε equivalen⌠ patchinτ utilit∙ t∩ patcΦ aε ì entirσ Z3TCA╨ (.Z3T⌐ filσ fo≥ you≥ termina∞ (sucΦ a≤ TERMNAME.Z3T⌐ int∩ ì SCAN« Seσ Z3TCAP.DO├ fo≥ morσ detaileΣ informatioε oε thσ structurσ oµ thσ ì termina∞ contro∞ sequence≤ iε thσ Z3TCA╨ anΣ instruction≤ fo≥ patchinτ thσ ì contro∞ sequence≤ fo≥ you≥ termina∞ int∩ SCAN« Yo⌡ mus⌠ als∩ patcΦ thσ desireΣ value≤ fo≥ thσ numbe≥ oµ column≤ anΣ line≤ ì fo≥ you≥ termina∞ anΣ thσ maximuφ allowablσ drivσ anΣ use≥ number≤ int∩ ì SCAN« Iµ yo⌡ decidσ t∩ renamσ SCAN¼ thσ prograφ namσ useΣ iε thσ commanΣ ì linσ HEL╨ screeε caε als∩ bσ patched. SCA╬ provide≤ patcΦ spacσ fo≥ ß bytσ printe≥ initializatioε string« Iµ ß ì strinτ i≤ present¼ i⌠ i≤ sen⌠ eacΦ timσ thσ prin⌠ functioε i≤ selected« :O Overview ì SCA╬ i≤ ß WordStar-likσ vide∩ orienteΣ bi-directiona∞ tex⌠ filσ viewinτ ì utilit∙ usinτ thσ WordSta≥ commanΣ se⌠ t∩ vie≈ tex⌠ file≤ anΣ librar∙ ì membe≥ files¼ eveε iµ squeezeΣ o≥ crunched¼ iε botΦ ZCPR│ anΣ CP/═ ì environments« Thσ sizσ oµ thσ filσ beinτ vieweΣ i≤ no⌠ limiteΣ b∙ ì availablσ memor∙ space« SCA╬ use≤ threσ 4δ tex⌠ buffer≤ anΣ ß dynamiπ buffe≥ allocatioε proces≤ t∩ ì allo≈ ful∞ bi-directiona∞ browsinτ througΦ norma∞ tex⌠ files« Ful∞ bi-ì directiona∞ scrollinτ througΦ squeezeΣ o≥ cruncheΣ files¼ however¼ i≤ ì limiteΣ t∩ thσ curren⌠ content≤ oµ thσ 12δ oµ alread∙ unsqueezeΣ o≥ ì uncruncheΣ tex⌠ buffers« SCA╬ i≤ designeΣ fo≥ persona∞ rathe≥ thaε RBB╙ use¼ anΣ ha≤ n∩ built-iε ì securit∙ features« Fo≥ thσ samσ reason¼ n∩ filσ type≤ arσ automaticall∙ ì excludeΣ froφ viewing« Overview ì File≤ ma∙ bσ vieweΣ a≤ straigh⌠ tex⌠ file≤ o≥ yo⌡ ma∙ selec⌠ eithe≥ thσ ì WordSta≥ o≥ ZCPR│ vide∩ displa∙ mode« Thσ feature≤ oµ thesσ vide∩ displa∙ ì mode≤ arσ describeΣ iε thσ sectioε oε Vide∩ Displa∙ Modσ Commands« Thσ ì WordSta≥ modσ i≤ thσ distributioε defaul⌠ vide∩ displa∙ modσ althougΦ SCA╬ ì ma∙ bσ patcheΣ t∩ makσ an∙ onσ oµ thσ threσ mode≤ thσ default« Likσ Q╠ anΣ VTYPE¼ SCA╬ allow≤ yo⌡ t∩ quickl∙ jum≡ t∩ thσ enΣ oµ thσ filσ ì beinτ viewed¼ ß ver∙ usefu∞ featurσ wheε viewinτ sourcσ codσ files« T∩ hel≡ extrac⌠ informatioε froφ thσ filσ beinτ viewed¼ SCA╬ allow≤ yo⌡ t∩ ì senΣ tex⌠ t∩ you≥ printer« Iµ present¼ ß user-patchablσ printe≥ ì initializatioε strinτ wil∞ als∩ bσ sen⌠ eacΦ timσ thσ printe≥ i≤ toggleΣ ì on« :S Syntax ì SCAN's command line syntax is: SCAN [dir:]afn - Display file SCA╬ [dir:]LBRname.LB╥ - Displa∙ librar∙ directory SCAN [dir:]LBRname LBRmember - Display library member SCA╬ i≤ full∙ ZCPR│ compatiblσ wheε operatinτ iε ß ZCPR│ environment¼ ì acceptinτ botΦ thσ DIR║ anΣ thσ DU║ forms« SCA╬ wil∞ no⌠ accep⌠ thσ DIR║ ì forφ wheε operatinτ iε ß non-ZCPR│ environment. SCA╬ caε bσ ruε usinτ thσ ZCPR│ G╧ commanΣ wheneve≥ ß serie≤ oµ file≤ arσ ì beinτ viewed¼ eliminatinτ thσ timσ i⌠ take≤ t∩ reloaΣ SCA╬ froφ disk« Syntax ì Fo≥ easie≥ filenamσ entry¼ SCA╬ allow≤ yo⌡ t∩ usσ wildcard≤ t∩ specif∙ ß ì filename¼ librar∙ namσ o≥ librar∙ membe≥ name« SCA╬ wil∞ theε displa∙ thσ ì firs⌠ filσ i⌠ find≤ iε thσ director∙ o≥ librar∙ director∙ matchinτ thσ ì ambiguou≤ specification« Fo≥ easie≥ librar∙ namσ entry¼ yo⌡ caε eithe≥ specif∙ jus⌠ ß librar∙ namσ ì withou⌠ librar∙ extensioε (.LBR⌐ o≥ yo⌡ caε specif∙ ß librar∙ namσ ì includinτ thσ librar∙ extension« Iµ n∩ extensioε i≤ specifieΣ anΣ n∩ filσ ì witΦ tha⌠ namσ i≤ found¼ SCA╬ wil∞ looδ fo≥ ß librar∙ witΦ thσ samσ name« ì SCA╬ wil∞ theε displa∙ thσ librar∙ director∙ anΣ aε invitatioε t∩ ente≥ thσ ì namσ oµ ß librar∙ membe≥ fo≥ viewing« Yo⌡ don'⌠ neeΣ t∩ usσ thσ librar∙ extensioε wheε yo⌡ specif∙ ß librar∙ namσ ì anΣ als∩ specif∙ thσ desireΣ librar∙ membe≥ directl∙ froφ thσ commanΣ line« :V Video Display Mode Commands SCA╬ ha≤ threσ vide∩ displa∙ modes« Onl∙ onσ modσ ma∙ bσ selecteΣ a⌠ ß ì time« Turninτ ofµ botΦ displa∙ mode≤ result≤ iε ß vanillß TYPE-likσ ì displa∙ modσ tha⌠ doesn'⌠ displa∙ an∙ contro∞ character≤ o≥ usσ an∙ vide∩ ì effects« ^OD ............... WordSta≥ vide∩ modσ togglσ - display≤ ì ááááááááááááááááááááááááácontro∞ character≤ iε highlighteΣ vide∩, ì ááááááááááááááááááááááááádisplay≤ harΣ carriagσ return≤ anΣ ì áááááááááááááááááááááááááindicate≤ line≤ longe≥ thaε thσ screeε ì áááááááááááááááááááááááááwidtΦ a⌠ thσ righ⌠ margin« Pagσ break≤ ì áááááááááááááááááááááááááresultinτ froφ line feeΣ character≤ arσ ì áááááááááááááááááááááááááals∩ displayed. ^OV ............... ZCPR│ vide∩ modσ togglσ - display≤ ì ááááááááááááááááááááááááácharacter≤ appearinτ betweeε ^┴ (01H⌐ ì áááááááááááááááááááááááááanΣ ^┬ (02H⌐ iε highlighteΣ video. :D Screen Display Commands SCA╬ use≤ thσ basiπ WordSta≥ commanΣ se⌠ fo≥ it≤ screeε displa∙ commands¼ ì witΦ certaiε extension≤ t∩ makσ lifσ ß littlσ easie≥ anΣ morσ forgiving« ì Fo≥ example¼ thσ usσ oµ thσ contro∞ ke∙ i≤ optional« EntereΣ command≤ arσ ì automaticall∙ translateΣ int∩ contro∞ character≤ beforσ beinτ executed¼ s∩ ì tha⌠ enterinτ ^Q├ i≤ thσ samσ a≤ enterinτ Q├ o≥ ^Q^C« Therσ arσ als∩ alternatσ command≤ availablσ fo≥ severa∞ oµ thσ commands« ì Thesσ alternatσ command≤ arσ no⌠ showε iε thσ HEL╨ screen¼ bu⌠ arσ ì indicated belo≈ iε parentheses║ Screen Display Commands ^QR (T) ........... Display the beginning of the file ^R ................ Scroll up (back) one screen ^W (^E) ........... Scroll up (back) one line ^S (BACKSPACE) .... Scroll screen left one TAB (8 spaces) ^QS ............... Return display to normal left margin ^D (TAB) .......... Scroll screen right one TAB (8 spaces) ^Z (^X, RETURN) ... Scroll down (forward) one line ^C (SPACE) ........ Scroll down (forward) one screen ^QC (B) ........... Display the end of the file Other Commands ^P ................ Printe≥ togglσ - thσ printe≥ ma∙ bσ ì ááááááááááááááááááááááááátoggleΣ O╬ anΣ OF╞ t∩ prin⌠ thσ screeε ì ááááááááááááááááááááááááábeing displayeΣ. Thσ printe≥ wil∞ bσ ì áááááááááááááááááááááááááautomaticall∙ toggleΣ OF╞ wheε backinτ ì áááááááááááááááááááááááááu≡ iε thσ tex⌠ o≥ wheε thσ HEL╨ screeε ì áááááááááááááááááááááááááo≥ thσ FinΣ Strinτ commanΣ i≤ selected« ì áááááááááááááááááááááááááThσ screeε wil∞ bσ printeΣ witΦ n∩ lef⌠ ì ááááááááááááááááááááááááámargin« N∩ overla≡ line≤ wil∞ bσ ì ááááááááááááááááááááááááádisplayeΣ o≥ printed« Aε optiona∞ printe≥ initializatioε ì ááááááááááááááááááááááááástrinτ ma∙ bσ patcheΣ int∩ SCAN« Iµ i⌠ ì áááááááááááááááááááááááááexists¼ i⌠ wil∞ bσ senΣ eacΦ timσ thσ ì áááááááááááááááááááááááááprinte≥ i≤ selected« ì / (?) ............. HEL╨ screeε togglσ - display≤ ß HEL╨ ì áááááááááááááááááááááááááscreeε containinτ ß summar∙ oµ screeε ì ááááááááááááááááááááááááádispla∙ commands« Als∩ usefu∞ fo≥ ì ááááááááááááááááááááááááárefreshinτ thσ display. :F String Find Commands Likσ WordStar¼ SCA╬ allow≤ yo⌡ t∩ searcΦ thσ filσ tex⌠ fo≥ ß specifieΣ ì characte≥ string« Wheε examininτ file≤ iε ß library¼ o≥ wheε re-runninτ ì SCA╬ usinτ thσ ZCPR│ G╧ command¼ thσ curren⌠ finΣ strinτ wil∞ remaiε activσ ì froφ filσ t∩ file. Als∩ likσ WordStar¼ SCA╬ recognize≤ ^┴ a≤ ß wildcarΣ characte≥ iε thσ finΣ ì string¼ matchinτ an∙ singlσ characte≥ iε thσ text« I⌠ i≤ entereΣ a≤ ^P^A¼ ì a≤ discusseΣ below. FinΣ searche≤ begiε witΦ thσ firs⌠ characte≥ displayeΣ oε thσ screen« FinΣ ì Agaiε begin≤ righ⌠ afte≥ thσ previou≤ find« Iµ anothe≥ commanΣ ha≤ beeε ì executeΣ betweeε thσ FinΣ anΣ FinΣ Agaiε commands¼ FinΣ Agaiε wil∞ als∩ ì star⌠ searchinτ beginning witΦ thσ firs⌠ characte≥ displayeΣ oε thσ screen« Afte≥ thσ searcΦ strinτ ha≤ beeε locateΣ iε thσ text¼ SCA╬ display≤ thσ ì tex⌠ witΦ thσ linσ iε whicΦ thσ strinτ ha≤ beeε locateΣ displayeΣ a≤ thσ ì thirΣ linσ oε thσ screen¼ witΦ thσ searcΦ strinτ displayeΣ iε highlighteΣ ì video« Iµ n∩ matcΦ ha≤ beeε found¼ SCA╬ wil∞ displa∙ thσ las⌠ screeε oµ ì thσ filσ witΦ thσ messagσ 'Strinτ no⌠ found...º iε highlighteΣ vide∩ iε thσ ì STATU╙ line. String Find Commands ^QF (F) ........... Find a character string. ^L ................ Find the character string again. ^U ................ Cancel the find command. è Contro∞ characters¼ excep⌠ fo≥ ^█ (ESCAPE)¼ ^═ (RETURN)¼ anΣ thσ editinτ ì contro∞ character≤ describeΣ below¼ ma∙ bσ directl∙ entereΣ a≤ par⌠ oµ thσ ì searcΦ string« A≤ iε WordStar¼ othe≥ contro∞ character≤ ma∙ bσ entereΣ b∙ ì firs⌠ enterinτ ^P« ì String Editing Commands Likσ WordStar¼ SCA╬ recognize≤ severa∞ editinτ command≤ whilσ enterinτ thσ ì searcΦ string« Thesσ command≤ als∩ appl∙ whilσ enterinτ librar∙ membe≥ ì names: ^╪ ................ Cancel thσ linσ as entered so far. ^╥ ................ Restore the line as entered so far. ì ^S (BACKSPACE) .... Movσ onσ characte≥ bacδ iε thσ linσ ì ááááááááááááááááááááááááábeinτ entered. ááááá^D ................ Move onσ characte≥ forwarΣ iε thσ line¼ ì áááááááááááááááááááááááááredisplayinτ previousl∙ canceleΣ ì ááááááááááááááááááááááááácharacter≤. ^P ................ Prefi° allowinτ yo⌡ t∩ ente≥ contro∞ ì ááááááááááááááááááááááááácharacter≤ sucΦ a≤ RETUR╬ int∩ thσ finΣ ì ááááááááááááááááááááááááástrinτ withou⌠ executinτ them. ^U ................ Cancel the search string entry process. String Editing Commands RETURN ............ End≤ thσ strinτ entr∙ proces≤ anΣ allow≤ ì áááááááááááááááááááááááááyo⌡ t∩ selec⌠ thσ optioε t∩ ignorσ thσ ì ááááááááááááááááááááááááádistinctioε betweeε uppe≥ anΣ lowe≥ casσ ì ááááááááááááááááááááááááácharacter≤ wheε searchinτ fo≥ thσ ì áááááááááááááááááááááááááspecifieΣ string« ESCAPE ............ End≤ thσ strinτ entr∙ proces≤ anΣ ì ááááááááááááááááááááááááádefault≤ t∩ matchinτ thσ strinτ exactl∙ ì áááááááááááááááááááááááááa≤ entered« :E Exit Commands ^KX (ESCAPE) ...... Exit to the command line. ^KQ, ^KD .......... Wheε viewinτ ß librar∙ member¼ thesσ ì ááááááááááááááááááááááááácommand≤ wil∞ causσ aε exi⌠ t∩ thσ ì ááááááááááááááááááááááááálibrar∙ directory« Wheε viewinτ ß file¼ ì áááááááááááááááááááááááááthe∙ wil∞ causσ aε exi⌠ t∩ thσ commanΣ ì áááááááááááááááááááááááááline« Thσ HEL╨ screeε wil∞ reflec⌠ ì áááááááááááááááááááááááááprope≥ curren⌠ usage. :M Modifications Seσ thσ filσ SCAN.PA╘ fo≥ informatioε oε modifyinτ anΣ patchinτ SCA╬ anΣ oε ì installinτ thσ Inser⌠ Linσ termina∞ contro∞ sequencσ anΣ othe≥ terminal-ìèspecifiπ values« Z3TCAP.DO├ ha≤ morσ informatioε oε thσ structurσ oµ thσ ì termina∞ contro∞ sequence≤ iε thσ Z3TCAP.