ftp.barnyard.co.uk/2015.02.ftp.barnyard.co.uk.tar/ftp.barnyard.co.uk/cpm/walnut-creek-CDROM/ZSYS/ZSYSARK/Z3HLP02.ARK/S.LBR/SCAN.HZP/SCAN.HLP

Text File | 1990-03-23 | 13KB | 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.