forked from MirrorRepos/RomWBW
96 changed files with 3157 additions and 34 deletions
@ -0,0 +1,9 @@ |
|||
; global assembler options for BANKED BIOS |
|||
; with Boot Drive swapped into Drive A |
|||
|
|||
true equ -1 |
|||
false equ not true |
|||
|
|||
banked equ true |
|||
|
|||
drvswap equ true |
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -1,16 +1,20 @@ |
|||
With the following exceptions, the files in this directory |
|||
came from the CP/M 3 binary distribution on "The Unofficial |
|||
CP/M Web site" at http://www.cpm.z80.de/binary.html. |
|||
This an experimental adaptation of ZPM3 for RomWBW. |
|||
|
|||
As documented in the "README.1ST" file, the included |
|||
files have been patched with all applicable DRI patches |
|||
per CPM3FIX.PAT. |
|||
Launch ZPM3 using CPMLDR. ZPMLDR is not working reliably |
|||
at this time. |
|||
|
|||
In addition, the following have been added: |
|||
I have not found a way to make ZPM3 start up with any drive |
|||
other than A: as the system drive. So, during the load |
|||
process, the boot drive and drive A: are "swapped" so that |
|||
the boot drive is always drive A:. Use the ASSIGN |
|||
command after starting ZPM3 to see how the drives get |
|||
mapped. |
|||
|
|||
- INITDIR.COM was not included. The copy included is the |
|||
original DRI distribution, with both patches installed. |
|||
Per ZPM3 standard, files are distributed across different |
|||
user areas depending on their usage. Normal applications |
|||
are in user 15. Help files in user 10. Configuration |
|||
files in user 14. |
|||
|
|||
- ZSID6.COM is the original DRI ZSID distribution, but |
|||
patched to use RST 6 instead of RST 7 to avoid conflicting |
|||
with mode 1 interrupts. |
|||
ZSID6.COM is the original DRI ZSID distribution, but |
|||
patched to use RST 6 instead of RST 7 to avoid conflicting |
|||
with mode 1 interrupts. |
|||
|
|||
@ -0,0 +1,167 @@ |
|||
; |
|||
|
|||
ALIAÓ 1.5 |
|||
|
|||
The ZCPR3 ALIAS Facility |
|||
|
|||
A - The ALIAS Command |
|||
|
|||
E - ALIAS Examples |
|||
|
|||
S - Summary of ALIAS Variables |
|||
|
|||
:A |
|||
|
|||
Command: ALIAS |
|||
|
|||
Syntax:‚ ALIAÓ [[dir:]cmndname] |
|||
|
|||
Function: |
|||
|
|||
Thå ALIAÓ facilitù ió thå scripô expansioî utilitù oæ ZCPR3® � |
|||
Aî Aliaó ió á COÍ filå createä bù thå ALIAÓ prograí whicè � |
|||
containó onå oò morå commandó (separateä bù semicolons© tï bå � |
|||
placeä iî thå Commanä Linå Buffer® Wheî thå Aliaó ió invoked¬ � |
|||
parameteró froí thå commanä linå arå implanteä intï thå scripô � |
|||
containeä withiî thå Alias¬ anä thå resultinç ne÷ commanä linå ió � |
|||
placeä intï thå Commanä Linå Buffeò anä executed. |
|||
|
|||
|
|||
Options: |
|||
None |
|||
|
|||
Comments: |
|||
|
|||
ZCPR³ MUSÔ bå implementeä witè aî Externaì Commanä Linå � |
|||
Buffeò iî ordeò foò ALIAÓ tï work. |
|||
|
|||
Thå scripô oæ thå internaì commanä linå supportó parameteò � |
|||
passinç iî á manneò similaò tï ZEØ anä SUB® Thå variableó $n¬ � |
|||
wherå ° <½ î <½ 9¬ maù bå placeä intï thå script¬ anä thå � |
|||
correspondinç parameteró wilì bå substituteä foò thå indicateä � |
|||
variables® Thå variablå $° ió thå namå oæ thå Aliaó itself® Thå � |
|||
variablå $ª ió thå entirå taiì oæ thå commanä line. |
|||
|
|||
|
|||
Ne÷ variables¬ $Ä anä $U¬ arå available® $Ä expandó intï � |
|||
thå letteò oæ thå disë whicè waó loggeä iî aô thå timå thå Aliaó � |
|||
waó expandeä (thå homå disk)¬ anä $Õ expandó intï á numbeò (iî � |
|||
ASCIÉ chars© representinç thå useò areá whicè waó loggeä iî aô � |
|||
thå timå thå Aliaó waó expandeä (thå homå user). |
|||
|
|||
Thå ZCPR³ Systeí filå nameó arå availablå tï thå Aliaó aó � |
|||
thå variableó $Fî foò NAME.TYP¬ $Nî foò NAMÅ anä $Tî foò TYP¬ � |
|||
wherå ° <½ î <½ 4® $F° referó tï thå prototypå SH.VAÒ filenamå � |
|||
whilå $F± referó tï NAME.TYÐ oæ Systeí Filå 1¬ $N± referó tï NAMÅ � |
|||
oæ Systeí Filå 1¬ etc® Notå thaô thå SETFILÅ commanä ió useä tï � |
|||
definå thå contentó oæ thå Systeí filå names. |
|||
|
|||
'$$§ expandó intï á singlå '$'® Iî fact¬ anù unrecognizeä � |
|||
variablå afteò á '$§ wilì expanä tï itself® |
|||
|
|||
|
|||
Á ne÷ ALIAÓ variablå ió introduceä aô Versioî 1.5¬ thå � |
|||
Pointer® Iô wilì returî thå contentó oæ anù knowî memorù � |
|||
locatioî (pluó aî optionaì offset)® Iô takeó thå forí.. |
|||
$.ADDR[+OFF][[.OFF[+OFF]][.OFF[+OFF]] |
|||
|
|||
Foò example¬ oî mù NZCOÍ system.. |
|||
|
|||
$.± (0001H© D50³ Bioó Warí booô entry |
|||
$.1-³ (0001H© D50° Beginninç oæ Bios |
|||
$.¶ (0006H© C70¶ BDOÓ entry |
|||
|
|||
$.10¹ (0109H© E78° Z3ENÖ address |
|||
$.109.2² (Z3ENV+22H© E88° Z3MSÇ buffeò address |
|||
$.109.22+¶ Z3MSG+¶ E88¶ Prograí Erroò Flag |
|||
$.109.1¸ (Z3ENV+18H© E90° Z3CÌ address |
|||
$.109.18.° (Z3CL© E9xø NXTCHÒ pointer |
|||
|
|||
|
|||
Summary of Alias Variables |
|||
|
|||
$0 - Name of Alias |
|||
$n - Parameter from Command Line (1 <= n <= 9) |
|||
|
|||
$* - Tail of Command Line (everything after the verb) |
|||
|
|||
$D - Currenô Drivå Letter |
|||
$U - Currenô Useò Number |
|||
|
|||
$F° Prototypå SH.VAÒ Shelì Variablå File |
|||
$Fn - FILENAME.TYP of System File n (1 <= n <= 4) |
|||
$Nn - FILENAME of System File n |
|||
$Tî TYÐ oæ Systeí Filå n |
|||
|
|||
$.addò Ne÷ Pointeò variable |
|||
|
|||
$$ - The character '$' |
|||
|
|||
|
|||
|
|||
|
|||
Error Messages:‚ (onlù one) |
|||
|
|||
"Ovfl¢ meanó thaô eitheò á particulaò commanä taiì haó � |
|||
expandeä beyonä 12¶ characteró anä woulä overflo÷ TBUFÆ iæ iô � |
|||
werå ruî oò thå expandeä commanä lines¬ combineä witè thå � |
|||
remaindeò oæ thå contentó oæ thå commanä linå buffer¬ ió toï lonç � |
|||
tï fiô iî thå commanä linå buffer. |
|||
|
|||
:S |
|||
|
|||
Summary of Alias Variables |
|||
|
|||
$0 - Name of Alias |
|||
$n - Parameter from Command Line (1 <= n <= 9) |
|||
|
|||
$* - Tail of Command Line (everything after the verb) |
|||
|
|||
$D - Home Disk |
|||
$U - Home User |
|||
|
|||
$F° SH.VAÒ prototypå Shelì Variablå filename |
|||
$Fn - FILENAME.TYP of System File n (1 <= n <= 4) |
|||
$Nn - FILENAME of System File n |
|||
$Tî TYÐ oæ Systeí Filå n |
|||
|
|||
$.addò Ne÷ Pointeò variable |
|||
|
|||
$$ - The character '$' |
|||
|
|||
:E |
|||
|
|||
Examples of Aliases |
|||
|
|||
Case 1: |
|||
|
|||
Thå useò ió constantlù issuinç thå followinç commandó iî thå � |
|||
ordeò indicated: |
|||
|
|||
ASM myfile.BBZ |
|||
LOAD myfile |
|||
|
|||
He can generalize it with the following Alias script: |
|||
|
|||
ASM $1.BBZ;LOAD $1 |
|||
|
|||
If this Alias is named MYASM.COM, then typing |
|||
|
|||
"MYASM test" will be equivalent to "ASM test.BBZ;LOAD test" |
|||
|
|||
Case 2: |
|||
|
|||
Samå aó Caså ± excepô tï thå Currenô Drive¬ noô necessarilù � |
|||
drivå B: |
|||
|
|||
ASÍ $1.$D$DZ;LOAÄ $1 |
|||
|
|||
Caså 3: |
|||
|
|||
Imaginå yoõ havå changeä diskó iî thå drivå Ã anä yoõ wanô � |
|||
tï displaù itó directorù anä spacå available® Yoõ woulä normallù � |
|||
executå ^Ã tï warí boot¬ theî maybå XDIÒ Cº foò thå display® Aî � |
|||
aliaó caî reducå thió tï á singlå characteò command¬ X. |
|||
|
|||
JUMÐ 0;XDIÒ C: |
|||
|
|||
Binary file not shown.
@ -0,0 +1,202 @@ |
|||
; |
|||
� ‚ |
|||
--- H P - R P N --- |
|||
|
|||
|
|||
RPN Notation for the HP Calculator |
|||
|
|||
|
|||
R --> RPN Notation |
|||
S --> Stack Operations |
|||
F --> Stack Functions |
|||
N --> Numeric Functions |
|||
H --> HP Calculator |
|||
Z --> ZP |
|||
:R |
|||
RPÎ Notatioî� |
|||
|
|||
Reverså Polisè Notatioî (RPN)¬ alsï calleä postfiø notation¬ ió á simplå � |
|||
buô powerfuì stacë orienteä notatioî commonlù useä iî Hewlett-Packarä � |
|||
calculators® Yoõ firsô enteò thå twï numberó yoõ wisè tï operatå on¬ usinç � |
|||
thå <RETURN¾ keù tï separatå thå twï numberó yoõ arå enterinç anä theî yoõ � |
|||
enteò thå functioî yoõ wisè tï perform® Thå numberó yoõ enteò arå pusheä � |
|||
ontï á stacë anä thå functioî performeä oî thå numberó iî thå stack® Thå � |
|||
resulô ió displayeä immediatelù afteò thå functioî ió entered. |
|||
|
|||
Withiî it'ó limits¬ HÐ followó thå RPÎ conventionó useä bù Hewlett-Packarä � |
|||
iî theiò linå oæ RPÎ calculators. |
|||
|
|||
Foò examplå (assuminç thå decimaì displaù mode)º |
|||
|
|||
Tï Solvå Functioî Keystrokeó Displaù� |
|||
------- ---------------- --------- ------� |
|||
9+3=1² ¹ pluó ³ 9<RET>3« 1²� |
|||
9-3=¶ ¹ minuó ³ 9<RET>3 ¶� |
|||
9*3=2· ¹ timeó ³ 9<RET>3ª 2·� |
|||
9/3=³ ¹ divideä bù ³ 9<RET>3¯ ³� |
|||
9^3=72¹ ¹ tï thå 3rä poweò 9<RET>3Þ 72¹ |
|||
:S |
|||
Stacë� |
|||
|
|||
RPÎ ió baseä oî thå stack® Á numbeò ió entereä ontï thå stacë bù keyinç iî � |
|||
thå digits¬ endinç witè <RET>® Eacè subsequenô numbeò keyeä iî wilì pusè � |
|||
thå existinç contentó oæ thå stacë onå leveì higher. |
|||
|
|||
Thå structurå oæ HP'ó ´ leveì stacë ió showî belowº |
|||
|
|||
Ô -¾ 000° Stacë registeò ´� |
|||
Ú -¾ 000° Stacë registeò ³� |
|||
Ù -¾ 000° Stacë registeò ²� |
|||
-------------------------------------------� |
|||
Ø -¾ 000° Stacë registeò ± < Displayeä |
|||
|
|||
HÐ alwayó displayó thå contentó oæ thå Ø register® Wheî thå stacë ió � |
|||
lifted¬ thå contentó oæ eacè stacë registeò arå moveä uð onå level¬ thå � |
|||
contentó oæ registeò Ø arå copieä intï Ù anä thå contentó oæ registeò T¬ �Šthå topmosô register¬ arå lost. |
|||
|
|||
Wheî thå stacë ió dropped¬ thå contentó oæ eacè stacë registeò arå moveä � |
|||
dowî onå leveì anä thå contentó oæ thå Ô registeò arå copieä intï registeò � |
|||
Z® Thå resulô oæ thå calculatoò operatioî ió placeä iî registeò X. |
|||
|
|||
Bù enterinç á numbeò ´ timeó tï copù iô intï eacè stacë register¬ thaô � |
|||
numbeò becomeó á 'constant§ iî thå Ù registeò foò subsequenô chaiî � |
|||
operations® Eacè subsequenô operatioî wilì droð thå stack¬ restorinç thå � |
|||
samå 'constant§ valuå tï thå Ù registeò foò thå nexô operation. |
|||
:F |
|||
Stacë Functionó� |
|||
|
|||
HÐ haó severaì functionó thaô affecô onlù thå stack® Iî eacè oæ theså � |
|||
examples¬ eacè stacë registeò startó ouô loadeä witè thå numbeò oæ thaô � |
|||
register. |
|||
|
|||
Clearinç thå Stacë (^X) |
|||
� |
|||
Control-Ø clearó thå entirå stack® Thå valueó containeä iî thå LAST-Ø anä � |
|||
memorù registeró arå noô affected® HÐ startó witè á cleaò stacë wheî � |
|||
loadeä froí disk. |
|||
|
|||
Ô -¾ ´ Ô -¾ °� |
|||
Ú -¾ ³ Ú -¾ °� |
|||
Ù -¾ ² Ù -¾ °� |
|||
------------------------------------� |
|||
Ø -¾ ± Ø -¾ ° < Displayeä� |
|||
Keyº ^Ø (Cleaò stack© |
|||
Enterinç á numbeò (<RET>) |
|||
� |
|||
<RET>¬ useä aó thå ENTEÒ key¬ terminateó entrù oæ á numbeò anä placeó iô oî � |
|||
thå stack® Iô alsï separateó twï numberó entereä onå afteò thå other® <RET¾ � |
|||
liftó thå stacë anä copyó thå numbeò iî thå Ø registeò tï thå Ù register¬ � |
|||
replacinç iô witè thå numbeò thaô haó jusô beeî keyeä in® Thå valuå iî thå � |
|||
toð stacë register¬ registeò T¬ ió lost. |
|||
|
|||
Ô -¾ ´ Ô -¾ ³ Previouó Ô (4© losô� |
|||
Ú -¾ ³ Ú -¾ ²� |
|||
Ù -¾ ² Ù -¾ ±� |
|||
------------------------------------� |
|||
Ø -¾ ± Ø -¾ 78¹ < Displayeä� |
|||
Keyº 789<RET¾ (Enteò 789© |
|||
Stacë drop |
|||
� |
|||
Á numeriã functioî wilì droð thå stacë onå leveì anä replacå thå valuå iî Ø � |
|||
witè thå numeriã result® Thå valuå iî registeò Ô ió copieä dowî tï registeò � |
|||
Ú wheneveò thå stacë ió dropped. |
|||
|
|||
Ô -¾ ´ Ô -¾ ´ Valuå iî Ô copieä tï Ú� |
|||
Ú -¾ ³ Ú -¾ ´� |
|||
Ù -¾ ² Ù -¾ ³� |
|||
------------------------------------� |
|||
Ø -¾ ± Ø -¾ ³ < Displayeä� |
|||
Keyº « (X+Y©� |
|||
(2+1=3© |
|||
Rolì stacë uð (>© oò dowî (<) |
|||
� |
|||
Wheî thå stacë ió rolleä up¬ thå stacë ió lifteä onå leveì anä thå previouó � |
|||
valuå oæ Ô ió moveä dowî tï X® Wheî thå stacë ió rolleä down¬ thå stacë ió � |
|||
droppeä onå leveì anä thå previouó valuå oæ Ø ió moveä uð tï T® Nï valueó � |
|||
arå lost. |
|||
|
|||
Ô -¾ ´ Ô -¾ ³ Valuå froí Ô moveä� |
|||
Ú -¾ ³ Ú -¾ ² dowî tï Ø� |
|||
Ù -¾ ² Ù -¾ ±� |
|||
------------------------------------� |
|||
Ø -¾ ± Ø -¾ ´ < Displayeä� |
|||
Keyº ¾ (Rolì Up© |
|||
|
|||
Ô -¾ ´ Ô -¾ ± Valuå froí Ø moveä� |
|||
Ú -¾ ³ Ú -¾ ´ uð tï Ô� |
|||
Ù -¾ ² Ù -¾ ³� |
|||
------------------------------------� |
|||
Ø -¾ ± Ø -¾ ² < Displayeä� |
|||
Keyº ¼ (Rolì Down© |
|||
Exchangå contentó oæ Ø anä Ù (=) |
|||
� |
|||
Thå contentó oæ registeró Ø anä Ù arå exchanged® Nï otheò registeró arå � |
|||
affected® Thió functioî ió usefuì wheî yoõ neeä tï reverså thå ordeò oæ thå � |
|||
operandó beforå yoõ perforí aî operatioî sensitivå tï thå ordeò oæ thå � |
|||
operands¬ sucè aó subtraction¬ division¬ oò exponentiation. |
|||
|
|||
Ù -¾ ² Ù -¾ ±� |
|||
------------------------------------� |
|||
Ø -¾ ± Ø -¾ ² < Displayeä� |
|||
Keyº ½ (X<>Y© |
|||
Lasô Ø (L) |
|||
� |
|||
Wheî á numeriã functioî ió executed¬ á copù oæ thå lasô valuå iî thå Ø � |
|||
registeò beforå thå functioî ió executeä ió saveä iî thå Last-Ø register® � |
|||
Thaô valuå caî bå restoreä tï thå Ø registeò usinç thå 'L§ key® Thå stacë � |
|||
ió lifted¬ movinç thå currenô contentó oæ thå Ø registeò tï thå Ù register¬ � |
|||
etc® Thå valuå iî thå Last-Ø registeò ió noô affected. |
|||
|
|||
Ô -¾ ³ Ô -¾ ³ Ô -¾ ³� |
|||
Ú -¾ ² Ú -¾ ³ Ú -¾ ²� |
|||
Ù -¾ ± Ù -¾ ² Ù -¾ ¹� |
|||
------------------------------------------------� |
|||
Last-Ø -¾ Ø -¾ ¸ Ø -¾ ¹ Ø -¾ ¸ < Displayeä� |
|||
Keyº « Keyº Ì (Last-X©� |
|||
(1+8=9© |
|||
:N |
|||
Numeriã Functionó� |
|||
|
|||
Wheî yoõ wanô tï keù iî twï numbers¬ onå afteò thå other¬ yoõ uså thå <RET¾ � |
|||
keù betweeî entrieó tï separatå thå numbers® Wheî yoõ wanô tï keù iî á � |
|||
numbeò anä executå á functioî thaô useó thå valuå alreadù iî thå Ø registeò � |
|||
aó thå otheò operand¬ yoõ don'ô neeä tï uså thå <RET¾ key® Instead¬ yoõ � |
|||
enteò thå seconä operanä directlù followeä bù thå desireä operatioî key. |
|||
|
|||
Ô -¾ ´ Ô -¾ ³ Ô -¾ ³� |
|||
Ú -¾ ³ Ú -¾ ² Ú -¾ ³� |
|||
Ù -¾ ² Ù -¾ ± Ù -¾ ²� |
|||
------------------------------------------------� |
|||
Ø -¾ ± Ø -¾ µ Ø -¾ ¶ < Displayeä� |
|||
Keyº µ Keyº « (X=X+5©� |
|||
(1+5=6© |
|||
|
|||
Thå functionó <RET¾ anä ^Ø (cleaò stack© disablå thå automatiã stacë lifô � |
|||
wheî thå nexô numbeò ió keyeä in® Wheî anù otheò functioî ió used¬ thå � |
|||
stacë lifô ió enabled¬ causinç thå stacë tï automaticallù lifô wheî thå � |
|||
nexô numbeò ió keyeä in® Thió effecô ió verù naturaì anä yoõ probablù � |
|||
won'ô havå tï thinë abouô it. |
|||
One-Numbeò Function |
|||
� |
|||
Negatioî (two'ó complement© ió HP'ó onlù onå one-numbeò function® Iô � |
|||
operateó oî thå currenô valuå iî thå Ø register¬ placinç thå resulô iî thå � |
|||
Ø register® Thå resô oæ thå stacë ió unaffected. |
|||
|
|||
Two-Numbeò Functions |
|||
� |
|||
Thå remaindeò oæ HP'ó numeriã functionó uså thå valueó iî botè thå Ø anä Ù � |
|||
registers® Iî operationó sucè aó subtractioî oò division¬ thå lasô numbeò � |
|||
keyeä iî ió thå numbeò yoõ arå subtractinç oò dividinç by® Iæ yoõ havå thå � |
|||
numberó entereä iî thå wronç order¬ uså thå '=§ keù tï exchangå thå valueó � |
|||
oæ thå Ø anä Ù registers. |
|||
|
|||
Ô -¾ ³ Ô -¾ ² Ô -¾ ²� |
|||
Ú -¾ ² Ú -¾ ± Ú -¾ ²� |
|||
Ù -¾ ± Ù -¾ ¸ Ù -¾ ±� |
|||
------------------------------------------------� |
|||
Ø -¾ ¸ Ø -¾ ´ Ø -¾ ² < Displayeä� |
|||
Keyº 8<RET¾ Keyº ´ Keyº ¯ (Y/X©� |
|||
(8/4=2© |
|||
:H:HP-ZP.HLP |
|||
:Z:ZP.HLP |
|||
|
|||
@ -0,0 +1,263 @@ |
|||
; |
|||
|
|||
--- H P --- |
|||
|
|||
Version 1.4 |
|||
|
|||
Programmer'ó Integeò RPÎ Calculator for ZP |
|||
|
|||
|
|||
O --> Overview |
|||
H --> Invoking HP |
|||
D --> Display Modes |
|||
S --> Stack |
|||
E --> Entering Numbers |
|||
F --> Math Functions |
|||
M --> Memory Registers |
|||
N --> RPN Notation |
|||
Z --> ZP |
|||
:O |
|||
Overview |
|||
|
|||
HÐ ió á simplå anä verù usefuì programmer'ó integeò calculatoò modeleä � |
|||
afteò á Hewlett-Packarä calculatoò witè RPÎ notation® � |
|||
|
|||
HÐ caî operatå iî anù oæ fouò displaù modesº hexadecimal¬ decimal¬ binary¬ � |
|||
anä character¬ makinç iô verù usefuì foò quicklù convertinç integeò numberó � |
|||
froí onå baså tï another® Iô caî dï integeò addition¬ subtraction¬ � |
|||
multiplication¬ division¬ exponentiatioî anä bitwiså logicaì ANÄ anä OÒ � |
|||
operations® Iô haó á ´ leveì stacë anä ¶ memorù storagå registers. |
|||
|
|||
Alì HÐ internaì storagå anä arithmetiã ió unsigneä 1¶ bit® Thuó 6553· � |
|||
becomeó 00001¬ -± becomeó 65535¬ anä sï on® Multiplicatioî anä � |
|||
exponentiatioî overflo÷ anä divisioî bù ° wilì generatå errors® Iî binarù � |
|||
anä characteò modes¬ thå displaù showó onlù thå lowesô ¸ bitó oæ 16¬ sï 8-� |
|||
biô overflo÷ doeó noô usuallù causå aî error. |
|||
|
|||
Iæ yoõ arå noô familiaò witè RPÎ notation¬ see the section on RPN notation,� |
|||
whicè alsï haó morå detaiì oî ho÷ HÐ useó itó stacë durinç stacë anä � |
|||
numeriã operations. |
|||
:H |
|||
Invoking HP |
|||
|
|||
Uså ^Ã tï invokå HP® Iô wilì displaù itó singlå operatinç linå anä waiô � |
|||
foò youò input: |
|||
|
|||
H¾ 0000 |
|||
|
|||
Thå 'H>§ indicateó hexadecimaì displaù modå (thå defaulô displaù mode)¬ anä � |
|||
'0000§ ió thå fouò digiô heø calculatoò displaù oæ registeò X¬ whicè ió thå � |
|||
registeò alwayó displayed® Thå HÐ stacë anä memorù arå initializeä tï zerï � |
|||
wheî ZP ió firsô loadeä into memory. |
|||
|
|||
Exiting HP |
|||
|
|||
Uså ^à tï exiô HÐ anä returî tï ZP® Wheî yoõ uså ^à tï reruî HP¬ yoõ wilì �Šreturî tï iô jusô wherå yoõ lefô off® |
|||
:D |
|||
Display Modes |
|||
|
|||
HÐ caî operatå iî anù oæ fouò displaù modesº hexadecimal¬ decimal¬ binary¬ � |
|||
anä character¬ makinç iô verù usefuì foò quicklù convertinç integeò numberó � |
|||
froí onå baså tï another® Tï changå displaù modes¬ enteò thå escapå <ESC¾ � |
|||
keù followeä bù thå firsô letteò oæ thå desireä mode® Eitheò uppeò oò � |
|||
loweò caså letteró maù bå useä tï selecô thå mode® Thå displaù indicateó � |
|||
thå currenô mode¬ anä thå numbeò iî thå Ø registeò wilì bå displayeä iî thå � |
|||
currenô mode® Yoõ maù translatå numberó froí onå baså tï anotheò bù simplù � |
|||
changinç displaù modes. |
|||
Heø Displaù Mode |
|||
|
|||
Tï selecô thå heø displaù mode¬ enteò <ESC>H® Iî heø mode¬ numberó displaù � |
|||
aó fouò heø digitó froí 0000-FFFF. |
|||
|
|||
Decimaì Displaù Mode |
|||
|
|||
Tï selecô thå decimaì displaù mode¬ enteò <ESC>D® Iî decimaì mode¬ numberó � |
|||
displaù aó fivå decimaì digitó froí 00000-65535. |
|||
|
|||
Binarù Displaù Mode |
|||
|
|||
Tï selecô thå binarù displaù mode¬ enteò <ESC>B® Iî binarù mode¬ thå leasô � |
|||
significanô bytå oæ thå numbeò displayó aó ¸ binarù digits from |
|||
00000000-11111111. |
|||
Character Display Mode |
|||
|
|||
Tï selecô thå characteò displaù mode¬ enteò <ESC>C® Iî characteò mode¬ thå � |
|||
leasô significanô · bitó oæ thå numbeò displaù aó aî ASCIÉ character® � |
|||
Controì characteró arå indicateä bù á '^§ prefix® Foò example¬ 03È wilì � |
|||
displaù aó '^C§ anä DEÌ (7FH)¬ wilì displaù aó '^?'. |
|||
|
|||
Alì non-commanä characteró caî bå directlù entereä aó datá iî thå characteò � |
|||
displaù mode® Characteró thaô havå commanä functionó sucè aó 'L'¬ '/'¬ � |
|||
'='¬ ^C¬ <RET¾ (^M)¬ etc¬ caî bå entereä aó datá iî thå characteò modå bù � |
|||
prefixinç theí witè thå <ESC¾ character® Seå thå sectioî oî Enterinç � |
|||
Speciaì Characteró foò morå information. |
|||
:S |
|||
Stack |
|||
|
|||
Thå structurå oæ HP'ó ´ leveì stacë ió showî below: |
|||
|
|||
Ô -¾ 000° Stacë registeò 4 |
|||
Ú -¾ 000° Stacë registeò 3 |
|||
Ù -¾ 000° Stacë registeò 2 |
|||
-------------------------------------------- |
|||
Ø -¾ 000° Stacë registeò ± < Displayed |
|||
|
|||
HÐ alwayó displayó thå contentó oæ thå Ø registeò anä alì valueó entereä � |
|||
arå entereä intï thå Ø register® Wheî á numbeò ió entereä intï thå Ø � |
|||
register¬ thå previouó contentó oæ thå Ø registeò arå automaticallù moveä � |
|||
uð tï thå Ù register¬ thå previouó contentó oæ thå Ù registeò arå moveä uð � |
|||
tï thå Ú register¬ etc® |
|||
|
|||
Seå thå filå HP-RPN.HLP foò morå detaiì oî ho÷ HP'ó functionó affecô thå � |
|||
stacë registers. |
|||
Enterinç á Number |
|||
|
|||
<RET¾ liftó thå stack¬ pushinç thå numbeò iî registeò Ø intï registeò Y® � |
|||
Thå numbeò beinç entereä ió theî placeä iî registeò X® Stacë lifô ió � |
|||
disabled. |
|||
|
|||
Clearinç thå Stack |
|||
|
|||
Yoõ caî cleaò thå entirå stacë witè Control-Ø (^X© aô anù time® Memorù anä � |
|||
Last-Ø registeró arå noô affected. |
|||
|
|||
Exchanginç Ø anä Y |
|||
|
|||
Yoõ caî exchangå thå contentó oæ thå twï lowesô stacë registeró Ø anä Ù � |
|||
witè thå '=§ functioî (X<>Y)® Nï otheò registeró arå affected® Thió � |
|||
functioî ió usefuì wheî yoõ neeä tï reverså thå ordeò oæ operandó beforå � |
|||
performinç á functioî sensitivå tï operanä ordeò sucè aó subtraction¬ � |
|||
divisoî oò exponentiation. |
|||
Last-X |
|||
|
|||
Wheî á numeriã functioî ió executed¬ á copù oæ thå lasô valuå iî thå Ø � |
|||
registeò beforå thå functioî ió executeä ió saveä iî thå Last-Ø register® � |
|||
Thaô valuå caî bå restoreä tï thå Ø registeò usinç thå 'L§ (oò 'l'© key® � |
|||
Thå stacë ió lifted¬ pushinç thå currenô contentó oæ thå Ø registeò tï thå � |
|||
Ù register¬ etc¬ unlesó stacë lifô haó beeî disableä bù thå <RET¾ oò � |
|||
backspacå key® Thå valuå iî thå Last-Ø registeò ió noô affected® Thå � |
|||
Last-Ø functioî saveó yoõ froí havinç tï reenteò numberó yoõ wisè tï uså � |
|||
agaiî anä caî assisô yoõ iî erroò recovery. |
|||
|
|||
Stacë Roll |
|||
|
|||
Yoõ caî rolì thå stacë bù usinç '>§ (oò thå unshifteä equivalenô '.'© tï � |
|||
rolì iô uð onå leveì anä '<§ (oò ','© tï rolì iô dowî onå level® Wheî thå � |
|||
stacë ió rolleä up¬ thå contentó oæ alì stacë registeró arå moveä uð onå � |
|||
leveì anä thå valuå iî thå toð stacë registeò ió moveä dowî tï thå Ø � |
|||
register® Wheî thå stacë ió rolleä down¬ thå contentó oæ alì stacë � |
|||
registeró arå moveä dowî onå leveì anä thå valuå iî thå Ø registeò ió moveä � |
|||
uð tï thå toð stacë register® Nï stacë valueó arå losô aó á resulô oæ � |
|||
stacë rolì operations. |
|||
:E |
|||
Entering Numbers |
|||
|
|||
Invokå HÐ anä trù enterinç thå followinç sequencå oæ keys: |
|||
|
|||
^X <ESC>Ä ± <RET¾ ² « ´ * |
|||
|
|||
Yoõ havå cleareä thå stack¬ selecteä thå decimaì mode¬ entereä thå decimaì � |
|||
numberó '1§ anä '2'¬ addeä them¬ entereä '4§ anä multiplieä ´ timeó thå � |
|||
previouó result® Thå displaù shoulä sho÷ '00012'¬ whicè ió (1+2)*4. |
|||
|
|||
Youò <ENTER¾ oò <RET¾ keù correspondó tï thå HÐ <ENTER¾ key® Iô ió useä tï � |
|||
separatå twï numberó aó theù arå beinç entereä onå afteò thå otheò oò tï � |
|||
copù thå numbeò iî thå displayeä Ø registeò intï thå Ù register® Yoõ � |
|||
normallù keù iî á strinç oæ digits¬ theî presó <RET¾ tï enteò thå numbeò iî � |
|||
thå displayeä Ø register® Yoõ dï noô neeä tï uså <RET¾ afteò everù numbeò � |
|||
entry¬ however¬ aó thå uså oæ thå functioî keyó alsï automaticallù � |
|||
terminateó digiô entry. |
|||
|
|||
Dependinç oî thå currenô displaù mode¬ á maximuí numbeò oæ digitó caî bå � |
|||
entereä intï thå display¬ afteò whicè thå leadinç digitó wilì begiî tï bå � |
|||
discarded® HÐ acceptó á maximuí oæ fouò digitó iî thå heø displaù mode¬ � |
|||
fivå digitó iî thå decimaì displaù mode¬ eighô digitó iî thå binarù displaù � |
|||
modå anä onå digiô iî thå characteò displaù mode® Thå consolå belì wilì � |
|||
rinç iæ yoõ enteò á characteò thaô ió noô acceptablå iî thå currenô displaù � |
|||
mode. |
|||
|
|||
Correctinç Entrieó� |
|||
|
|||
Thå backspacå keù (^H© workó likå thå lefô arro÷ '<--§ keù oî aî HÐ � |
|||
calculator® Iô haó twï functions® Durinç digiô entry¬ iô wilì deletå thå � |
|||
lasô digiô typed® Otherwiså iô wilì cleaò thå Ø registeò anä leavå thå � |
|||
stacë lifô disabled. |
|||
Enterinç Speciaì Characters |
|||
|
|||
Thå <ESC¾ keù maù bå useä aó á prefiø iî thå characteò displaù modå tï � |
|||
allo÷ yoõ tï enteò aó á digiô thoså characteró thaô woulä otherwiså bå � |
|||
interpreteä bù HÐ aó calculatoò functions: |
|||
|
|||
+-*^/&|~=lLsSrR<>., |
|||
|
|||
aó welì aó thå controì characteró ^X¬ ^Ã anä <RET¾ (^M). |
|||
|
|||
Tï enteò thå characteò 's'¬ foò example¬ enteò '<ESC>s§ insteaä oæ 's'¬ � |
|||
sincå enterinç 's§ initiateó á storå tï á memorù register. |
|||
:F |
|||
Math Functions |
|||
|
|||
HP'ó integeò numeriã functionó anä thå keyó tï invokå theí are: |
|||
|
|||
+ Addition, X=Y+Ø � |
|||
- Subtraction, X=Y-Ø � |
|||
* Multiplication, X=Y*Ø � |
|||
^ Exponentiation, X=Y^Ø (Ù tï thå Xtè power© � |
|||
/ Integer quotient, X=INT(Y/X© |
|||
- Remainder Register R=X*(Y/X-INT(Y/X)© � |
|||
& Bitwise AND, X=Y&X � |
|||
| Bitwise OR, X=Y|X � |
|||
~ Negation [2's complement], X=~X |
|||
|
|||
Negatioî affectó onlù thå Ø register® Thå otheò operationó uså thå numberó � |
|||
iî thå firsô twï registeró Ø anä Ù aó operands¬ anä displaù thå resulô iî � |
|||
thå Ø register¬ droppinç thå stack. |
|||
|
|||
Wheî aî integeò divisioî ió performed¬ yoõ arå ofteî interesteä iî botè thå � |
|||
quotienô anä thå remainder® Thå remaindeò ió saveä iî thå speciaì reserveä � |
|||
memorù registeò Ò durinç thå divisioî operation® Memorù registeò Ò maù bå � |
|||
accesseä jusô likå anù oæ thå regulaò memorù registeró 0-5® Iô maù alsï bå � |
|||
useä tï storå numberó likå anù otheò register¬ buô anù contentó wilì bå � |
|||
overwritteî bù thå remaindeò durinç integeò divisioî operations. |
|||
|
|||
Thå consolå belì wilì rinç iæ aî undefineä keù ió presseä aó aî operator® � |
|||
Iô wilì alsï rinç anä thå currenô multiplicatioî (*)¬ divisioî (/© oò � |
|||
exponentiatioî (^© functioî wilì noô operatå iæ 16-biô overflo÷ occuró oò � |
|||
iæ divisioî bù ° ió attempted® Thå stacë ió lefô unchanged® Uså thå � |
|||
backspacå keù tï deletå thå offendinç operanä iæ yoõ wisè tï trù again. |
|||
:M |
|||
Memory Storage Registers |
|||
|
|||
Therå arå ¶ memorù storagå registeró numbereä 0-µ thaô maù bå useä tï storå � |
|||
constantó oò intermediatå valueó durinç calculations¬ foò recalleä aó � |
|||
needeä later® Thå contentó oæ memorù registeró arå noô affecteä bù thå � |
|||
cleaò stacë (^X© operation® Eitheò uppeò oò loweò caså letteró maù bå useä � |
|||
tï specifù memorù registeò Storå oò Recalì functions. |
|||
|
|||
Storing a Number |
|||
|
|||
Thå numbeò iî thå Ø registeò maù bå storeä iî anù oæ thå memorù registeró � |
|||
usinç thå commanä 'S§ followeä bù thå numbeò oæ thå desireä memorù � |
|||
register® Thå previouó contentó oæ thå memorù registeò wilì bå � |
|||
overwritten¬ buô thå numbeò iî thå Ø registeò wilì noô bå affected® Foò � |
|||
example¬ tï storå thå numbeò iî registeò Ø iî memorù registeò 2¬ enteò � |
|||
'S2'® |
|||
Recalling a Number |
|||
|
|||
Numberó maù bå recalleä froí á memorù registeò tï registeò Ø usinç thå 'R§ � |
|||
commanä followeä bù thå numbeò oæ thå memorù register® Thå stacë wilì bå � |
|||
lifted¬ pushinç thå previouó contentó oæ registeò Ø intï registeò Y¬ buô � |
|||
thå numbeò iî thå memorù registeò wilì noô bå affected® Foò example¬ tï � |
|||
recalì memorù registeò ° tï registeò X¬ enteò 'R0'. |
|||
|
|||
Remainder Register |
|||
|
|||
Aî additionaì speciaì memorù registeò Ò ió useä bù thå divisioî operatioî � |
|||
tï storå thå remainder® Iô maù alsï bå useä tï storå anä recalì numbers¬ � |
|||
buô anù contentó wilì bå overwritteî durinç á divisioî operation® Thå � |
|||
commanä 'RR§ (Recalì Remainder© afteò á divisioî operatioî wilì storå á � |
|||
copù oæ thå remaindeò iî registeò Ø anä pusè thå quotienô tï registeò Y® � |
|||
Aî exchangå (=© operatioî wilì swað theí iæ desired® |
|||
:N:HP-RPN.HLP |
|||
:Z:ZP.HLP |
|||
|
|||
@ -0,0 +1,172 @@ |
|||
; |
|||
IF.COM |
|||
|
|||
Author: Jay Sage |
|||
Version: 1.6 (includes type 4 for Z34) |
|||
Last Update: 4/28/89 |
|||
|
|||
|
|||
1- Overview 4- Error Messages |
|||
2- Syntax 5- Examples of use |
|||
3- Options |
|||
|
|||
:1 |
|||
Overview of IF.COM |
|||
|
|||
IF is the transient counterpart of the FCP-resident IF command. IF.COM |
|||
tests the indicated condition to see if it is TRUE and, if so, sets the Flow |
|||
State to TRUE (allowing the following commands to execute). If the condition |
|||
is FALSE, the Flow State is set to FALSE (allowing only Flow Commands to |
|||
execute). |
|||
|
|||
IF.COM is invoked if the current FCP has the IF.COM facility enabled. If |
|||
this is the case, whenever an IF command is issued, the FCP will load IF.COM |
|||
from the ROOT directory into memory and execute it. The command tail is |
|||
passed to IF.COM, and IF.COM acts as a conventional COM file. |
|||
|
|||
Under NZFCP distributed with NZ-COM and ZCPR vs. 3.4, IF.COM is invoked |
|||
only if the indicated condition is NOT included in the condition set |
|||
available with the resident FCP. IF.COM may be invoked directly if its |
|||
invocation is preceeded by a colon, i.e. :IF .. etc. |
|||
:2 |
|||
Syntax: (1) IF ARG1=ARG2 |
|||
(2) IF REGISTER# value |
|||
(3) IF CONDITION ARGUMENTS |
|||
|
|||
In form (1), the arguments are tested for literal equality and must match |
|||
character for character. No space is permitted preceeding or following the |
|||
equal sign. A more flexible comparison is provided by using form (3) with the |
|||
comparison conditions, i.e. IF EQ ARG1 ARG2 or IF = ARG1 ARG2. This form |
|||
permits the use of the condition set EQ, NE, GT, GE, LT, LE as well as their |
|||
symbolic equivalents =, <> or ><, >, >=, <, <=. |
|||
|
|||
In all forms which permit or require the use of numeric values such as form |
|||
(2) or the VALUE and REG conditions, numeric entry may be specified as octal, |
|||
binary or hexadecimal by appending the letters o, b or h to the number. |
|||
|
|||
In form (3), only the first two letters of the condition are signifigant. |
|||
|
|||
A '~' may be used to negate all conditions in forms (2) and (3). |
|||
:3 |
|||
Options: |
|||
|
|||
T - Flow State set to unconditionally to TRUE |
|||
|
|||
F - Flow State set unconditionally to FALSE
Š |
|||
AMBIG fnme - Flow state set TRUE if file name is ambiguous |
|||
|
|||
ARCHIVE fnme - Flow state set TRUE if archive attribute set |
|||
|
|||
BG - Flow state set TRUE if BackGrounder present |
|||
|
|||
COMPR fnme - Flow state set TRUE if file is squeezed or Crunched |
|||
|
|||
DS - Flow state set TRUE if DateStamper present |
|||
|
|||
EMPTY afn,... - if any file in indicated list is EMPTY (size is 0k), |
|||
Flow State is set to TRUE |
|||
|
|||
ERROR [value] - if ZCPR3 error flag is set, Flow State is set to TRUE. If |
|||
value is present, flow state is set TRUE only if error |
|||
number matches value. |
|||
Options (continued): |
|||
|
|||
EXIST afn,... - if all files in the list exist, Flow State is set to TRUE |
|||
|
|||
INPUT [text] - user input is enabled, and if user strikes T, Y, <cr>, or |
|||
<sp>, Flow State is set to TRUE. Text appears as a prompt and |
|||
may use '^' to generate control characters, %< to display |
|||
upper case, %> to display lower case and ctl-a/ctl-b to |
|||
enable/disable screen standout mode. |
|||
|
|||
LIST tail - Flow state set TRUE if tail contains items separated by commas |
|||
|
|||
NULL afn - if no 'afn' (field is blank), then Flow State is set to TRUE |
|||
|
|||
PAUSE n [txt} - Like INPUT above except that Flow State is automatically |
|||
set to True if user does not respond within n seconds. |
|||
|
|||
REG m op n - Flow state set TRUE if expression is true. M is a register |
|||
number, n is a test value and op is a member of the operator |
|||
set =, <>, ><, >, >=, <, <=. All can be negated with '~'. |
|||
|
|||
RO fnme - Flow state set TRUE if file Read Only attribute set |
|||
Options (continued): |
|||
|
|||
SHELL [name] - Flow state set TRUE if a shell is on shell stack. If name is |
|||
present, it is compared to the name on the top of the shell |
|||
stack and the flow state set TRUE if they match. Name may |
|||
ambiguous. |
|||
|
|||
SYS fnme - Flow state set TRUE if file Sys attribute set |
|||
|
|||
TAG fnme n - Flow state set TRUE if attribute n set in file name. |
|||
|
|||
TCAP [string] - if a Z3TCAP is installed, Flow State is set to TRUE. If |
|||
string is present it is compared to the TCAP ID string (up |
|||
to the length of the former) and the flow state set TRUE if |
|||
they match. String may contain '?' wildcards. |
|||
|
|||
VALUE m op n - Flow state set TRUE if expression is true. M and n are values |
|||
and op is an operater from the set =, <>, ><, >, >=, <, <=. |
|||
All can be negated with '~'. |
|||
|
|||
WHEEL - if WHEEL byte set, Flow State is set to TRUE |
|||
Options (continued): |
|||
|
|||
ZEX - Flow state set TRUE if ZEX is running |
|||
|
|||
reg# value - if reg (0-31) has indicated value (0-255), Flow State is |
|||
set to TRUE |
|||
|
|||
afn1=afn2 - if two afns are identical in name, Flow State is set to TRUE |
|||
|
|||
A leading tilde (~) char before a condition negates the effect of the |
|||
condition. If the condition is FALSE, the Flow State is set to TRUE. For |
|||
each condition, only the first two chars are significant (eg. NU for NULL). |
|||
|
|||
Examples: "IF ~T" is the same as "IF F" |
|||
"IF ~NULL arg" is TRUE if 'arg' is non-blank |
|||
"IF ~EXIST afn,..." is TRUE if any 'afn' in the |
|||
list does not exist. |
|||
:4 |
|||
Error Message: |
|||
|
|||
IF.COM generates several error messages relating to improper entry of |
|||
condition arguments. These messages are self-explanatory. See the help for |
|||
IF.COM Options for correct syntax for each condition. |
|||
|
|||
The message 'IF overflow' indicates a nesting beyond the permitted 8 levels. |
|||
:5 |
|||
Examples of Use: |
|||
|
|||
a. IF NULL $1 |
|||
- if the indicated parameter (from within a SUBMIT or ZEX command file) |
|||
is not provided, set the Flow State to TRUE |
|||
|
|||
b. IF ~EXIST ZEX.ASM,ZEX.ZEX |
|||
- if any one of these files does not exist, Flow State is set to TRUE |
|||
|
|||
c. IF EXIST ZEX.ASM,ZEX.ZEX |
|||
- if any one of these files does not exist, Flow State is set to FALSE |
|||
(i.e., all files must exist for a TRUE Flow State) |
|||
|
|||
d. IF NEC=$1 |
|||
- if the first passed parameter is the same as the file name "NEC.", |
|||
then the Flow State is Set to TRUE |
|||
|
|||
e. IF 5 7h |
|||
- if Register 5 = 7 hexidecimal, the Flow State is Set to TRUE |
|||
|
|||
Examples (continued): |
|||
|
|||
f. IF LT $1 FEE |
|||
- if the first passed parameter preceeds 'FEE' in alphabetical order, |
|||
the flow state is set to TRUE. |
|||
|
|||
|
|||
============================================================================== |
|||
|
|||
Z-System HELP file on 'flow-control' commands (IF, IF.COM, IFSTAT.COM, |
|||
ELSE, FI, XIF, etc.). |
|||
|
|||
@ -0,0 +1,23 @@ |
|||
; |
|||
ZHELP - Online Documentation for Z3 Tools |
|||
|
|||
A - Alias (The ZCPR3 ALIAS Facility) |
|||
I - IF (Conditional Command Processor) |
|||
V - VLU (Visual Library Utility) |
|||
F - ZFiler (Point and Shoot Shell) |
|||
Z - ZPatch (File/Disk/Memory Record Patcher) |
|||
|
|||
ZHELP can also be used to access help files directly by |
|||
entering ZHELP followed by the name of the help file. |
|||
|
|||
The Z3 help files are stored in user area 10. You can view the |
|||
directory of this user area for a listing of help topics available. |
|||
|
|||
To access help for the standard CP/M Plus programs, use the |
|||
command HELP. |
|||
|
|||
:A:ALIAS.HLP |
|||
:I:IF.HLP |
|||
:V:VLU.HLP |
|||
:F:ZFILER.HLP |
|||
:Z:ZP.HLP |
|||
@ -0,0 +1,499 @@ |
|||
:VLU106 |
|||
Copyright 1987, 1988 Esoteric Software Michal Carson |
|||
|
|||
|
|||
This program is distributed through ZSIG. |
|||
|
|||
|
|||
|
|||
|
|||
VLU is a ZCPR3-specific library utility with crunch, uncrunch, and |
|||
unsqueeze capabilities. It will allow the user to view, |
|||
uncompress, or extract library members or to view, uncompress |
|||
(uncrunch or unsqueeze, VLU will decide), or crunch disk files. |
|||
VLU will build libraries from disk files, crunching the files as |
|||
they are added. Date and time stamping is supported. |
|||
|
|||
The utility will display a list of disk files on the screen along |
|||
with a cursor and other information. Placing the cursor next to |
|||
the name of a file with the extension .LBR and pressing 'O' for |
|||
Open will display the contents of the library and shift the cursor |
|||
into that directory. |
|||
|
|||
|
|||
What is a Library? |
|||
|
|||
|
|||
The Library file format was developed to overcome two persistent |
|||
limitations of CP/M disk storage capacity: limited directory |
|||
entries and large blocking. |
|||
|
|||
Although CP/M writes files in units of 128 bytes (sectors), most |
|||
manufacturers have used larger blocks for storage on disk. On a |
|||
Kaypro with double-sided disks, for instance, all files are stored |
|||
in 2K blocks; even a file one sector in length will occupy 2K on |
|||
the disk. Because the Kaypro disk format allows only 64 directory |
|||
entries (files) on one disk, 64 of these 1-sector files (8K) will |
|||
fill a 390K disk. |
|||
|
|||
In a library, a one sector file occupies one sector (plus 32 bytes |
|||
for internal directory information). The library itself occupies |
|||
only one directory entry on the disk. If 64 one-sector files are |
|||
placed into a library, the library will occupy 10K. |
|||
|
|||
This is obviously an extreme example but illustrates the |
|||
usefulness of libraries. Other reasons exist; for instance, |
|||
libraries keep related files together. VLU will make files within |
|||
libraries more accessible. |
|||
|
|||
|
|||
What is an ARC? Which is better? |
|||
|
|||
|
|||
An ARC is another popular format for storing files in reduced space. |
|||
ARCs store files sequentially each preceded by its own header of |
|||
information which may be 18 to 29 bytes. LBRs use a 32 byte |
|||
directory entry at the beginning of the LBR; the directory |
|||
indicates where the matching file may be found. |
|||
|
|||
The information stored in an ARC file header is similar to the |
|||
information stored in an LBR directory. Both formats store the |
|||
file name, exact file length, the last modification date and time, |
|||
and a CRC-16 for integrity. LBRs also store the file's creation |
|||
date and time. |
|||
|
|||
There are many arguments in favor of each format. To the casual |
|||
user, these arguments are not important and either format will |
|||
serve for any purpose--long-term or short, organizational, |
|||
archival, or for transfer. Neither format is an effective storage |
|||
format for sequential access devices such as tape. Anyone who |
|||
insists on the absolute superiority of one format over the other |
|||
is behaving parochially. |
|||
|
|||
VLU is the best effort to date in supporting the complete |
|||
Novosielski LBR definition. A like effort expended on behalf of |
|||
the ARC format might make it similarly useful. |
|||
|
|||
|
|||
In this Library |
|||
|
|||
|
|||
Two executable versions are distributed: VLUxxx-R.COM is for |
|||
machines using reverse video as highlighting. VLUxxx-D.COM is for |
|||
machines using dim video as highlighting. VLU.FOR is a short |
|||
description of the utility; VLU.HLP is full documentation |
|||
compatible with the ZCPR3 HELP text display utility. VLU.UPD |
|||
contains a trail of the changes in VLU since its initial release. |
|||
|
|||
|
|||
The Help display |
|||
|
|||
|
|||
Pressing "/" or "?" will evoke a display summarizing the commands |
|||
available to the user. These commands change according to Wheel |
|||
status and directory choice (e.g., Delete is not available in the |
|||
library and is never available to non-wheels). Pressing either of |
|||
these keys a second time will clear the display. |
|||
|
|||
|
|||
Invoking VLU |
|||
|
|||
|
|||
Use VLU as an extension to a ZCPR3 shell, such as ZFiler, invoked |
|||
through a macro. To install it, one need only open the ZFILER.CMD |
|||
file with a word processor and enter a line of the form "1 vlu". |
|||
Thereafter, positioning ZFiler's cursor beside a library file and |
|||
pressing "1" (possibly preceded by [esc]) will bring up VLU with |
|||
the library already open. A better thought is to assign this |
|||
macro to the "O" key--"O $d1$u1:;vlu" in ZFILER.CMD--so that [esc] |
|||
"O" will open the indicated library. |
|||
|
|||
Some aspects of VLU were designed to make it an extension of |
|||
tools like ZFiler. Most of these tools use the ZCPR system files |
|||
to store the name of the current file (the file the cursor was |
|||
pointing to on exit). VLU checks these filenames and interprets |
|||
the current file (sys file 2) as a library. On starting up, VLU |
|||
will try to open a library file of this name in the current |
|||
directory. |
|||
|
|||
This allows the user to invoke VLU from the "Z" prompt of ZFiler |
|||
or through a macro, pass no parameters, yet open the current file |
|||
if it is a library (or shares the same name as a library though it |
|||
may have a different extension). If a different library is opened |
|||
before returning to ZFiler, VLU will modify the filename in |
|||
system file 2 (and thus cause ZFiler to believe it was pointing to |
|||
this library when it exited). |
|||
|
|||
As a command file, VLU can, of course, be invoked from the system |
|||
command prompt. If a library name is entered on the command line, |
|||
that name will take priority over any name currently in system |
|||
file 2 and the library will be opened if it exists. Even from |
|||
ZFiler's "Z" prompt, with the pointer on ABC.LBR, entering the |
|||
command "VLU DEF" will open DEF.LBR and place that name into |
|||
system file 2. |
|||
|
|||
If the invocation is followed by a DU: specification or by the |
|||
name of a ZCPR named directory (DIR:), VLU will display the |
|||
filenames in that directory instead of the default directory. |
|||
That is, "VLU TOOLS:" will display the contents of the TOOLS: |
|||
directory. |
|||
|
|||
VLU can be re-entered with the GO command. |
|||
|
|||
|
|||
Changing libraries |
|||
|
|||
|
|||
When a library is opened, when VLU is invoked with a library name |
|||
in the command line, or when a new directory is logged in with a |
|||
library open, the VLU cursor will point into the library |
|||
directory. Pressing the [esc] key will shift the cursor back into |
|||
the disk directory. Opening a different library is as simple as |
|||
positioning the cursor in front of the name and pressing "O". |
|||
|
|||
|
|||
Cursor motion |
|||
|
|||
|
|||
Moving the cursor (pointer) in VLU is effected using the WordStar |
|||
cursor motion controls. Ctrl-E moves the cursor up one line, ctrl- |
|||
X moves it down. Ctrl-S moves the cursor left one file, ctrl-D |
|||
moves it right. Ctrl-F brings a new directory onscreen if there |
|||
are more files in the directory (as if the display were moving |
|||
right by a directory), ctrl-A moves back toward the beginning of |
|||
the file list. Ctrl-F will wrap around from the final directory |
|||
to the original. |
|||
|
|||
The arrow keys will also function if they are properly defined in |
|||
the users Environment descriptor. The symbols "+" and "-" (and |
|||
"=", the usual non-shifted counterpart of "+") have the same |
|||
effect on the directories as ctrl-F and ctrl-A, respectively. |
|||
|
|||
The [esc] key shifts directories: from the library to the disk, |
|||
from the disk to library. In most instances the cursor will |
|||
"remember" where it was when it last pointed into that directory. |
|||
|
|||
|
|||
Extracting and Uncompressing library members |
|||
|
|||
|
|||
Positioning the cursor beside the name of a member file within a |
|||
library and pressing "E" for Extract will cause the file to be |
|||
copied from the library to the disk with no change in form. If it |
|||
is crunched or squeezed within the library, it will be crunched or |
|||
squeezed on the disk. |
|||
|
|||
Pressing "U" for Uncompress will cause a crunched file to be |
|||
uncrunched onto the disk, a squeezed file to be unsqueezed onto the |
|||
disk, or an uncompressed file to be extracted sic. |
|||
|
|||
|
|||
Changing directories |
|||
|
|||
|
|||
Library members may be extracted to a disk and/or user area other |
|||
than the one which contains the library. Open the library first, |
|||
then use the Login command to move to the destination directory |
|||
and perform the extraction or decompression. The move is |
|||
accomplished by pressing "L" (cursor position makes no difference |
|||
with this command) and answering the prompt "Directory ". The |
|||
user may enter a DU: specification (e.g., A0:, B14:, F:) or the |
|||
name of a ZCPR3 named directory to be found in the current system |
|||
(e.g., MODEM:, DUNGEON:). The colon is not necessary in any case |
|||
and an invalid directory or denied access will relog the current |
|||
area. No entry at all will also relog the current area to |
|||
facilitate disk changes. |
|||
|
|||
|
|||
Tagging files |
|||
|
|||
|
|||
The "T" command will tag an untagged file and the "Y" command will |
|||
remove the tag from a tagged file. The tag appears as a hash (#) |
|||
immediately following the filename. After a group operation |
|||
(actually, during the group operation) hard tags represented by |
|||
the hash are replaced by soft tags which appear as an apostrophe |
|||
('). Soft tags may be transformed back into hard tags by the |
|||
retag command: "#". |
|||
|
|||
Wildcard tagging is accomplished by pressing "W" and providing a |
|||
wildcard file specification in response to the prompt. All files |
|||
in the directory, starting from the beginning, which match the |
|||
file spec will be tagged. |
|||
|
|||
Group Tag ("GT") is equivalent to a *.* wildcard tag. |
|||
|
|||
It may be convenient at times to untag all files. This can be |
|||
accomplished by relogging the directory with the Login command. |
|||
Certain file operations which affect the disk directory (anything |
|||
that adds or deletes files) will also end by relogging the |
|||
directory and any remaining tags will be erased. Group operations |
|||
obviously prevent this relogging until all files have been |
|||
operated upon. |
|||
|
|||
|
|||
Group operations |
|||
|
|||
|
|||
"G" will evoke the Group prompt. From this prompt, several |
|||
commands are available to wheels. Only the View and Tag commands |
|||
are available to non-wheels. If the wheel byte is not zero, the |
|||
prompt will indicate by the first letter of each command that |
|||
View, Tag, Uncompress, crunch, and either Extract or Delete and |
|||
Build are available. Any selection is carried out on all tagged |
|||
files. The Group manager will check for ctrl-C between each file |
|||
and abort if it is seen. |
|||
|
|||
|
|||
Viewing files and library members |
|||
|
|||
|
|||
Crunched, squeezed, and uncompressed files may be viewed by |
|||
pressing "V" at the VLU prompt. The screen will clear and the |
|||
file's name will appear at the top of the screen. Just below the |
|||
filename, the file's datestamps, if present, will be shown. These |
|||
will be taken from the disk in the case of ordinary text files, |
|||
from the library directory if the file is a member, or from the |
|||
internal datestamp of a compressed file. The display will stop |
|||
with the prompt "[strike any key]" after, in general, 22 lines. |
|||
The number of lines (the size of a screen page) is taken from the |
|||
ZCPR3 Environment descriptor. The number provided there, by |
|||
convention, is two lines less than the screen height. This should |
|||
give the viewer two lines of overlap with each page. If this is |
|||
unsatisfactory, the user's Environment descriptor can be adjusted. |
|||
|
|||
At any time during the viewing, pressing ctrl-S will pause the |
|||
display. Pressing ctrl-C will abort the operation. Under Group |
|||
control, ctrl-C will abort the entire operation and no more files |
|||
will be presented; the user will be returned to the file directory |
|||
display. Unscreened files will remain tagged. Ctrl-X may be used |
|||
to skip to the next file under Group execution; it has the same |
|||
effect as ctrl-C if only one file is being viewed; id est, we |
|||
abort. |
|||
|
|||
At the "[strike any key]" prompt, pressing the period will bring |
|||
one more logical line to the screen. |
|||
|
|||
Ctrl-Z will suppress the "[strike any key]" prompt and the file |
|||
will scroll continuously. The viewer is then left with ctrl-S to |
|||
stop the display (and any key except ctrl-X and ctrl-C will |
|||
restart it). Another Ctrl-Z will restore the paging mode and |
|||
stop the screen immediately. This is handy for long files when |
|||
the interesting text is near the end. |
|||
|
|||
Certain file extensions are proscripted (e.g., COM, LBR, ARK, SYS, |
|||
RCP, REL, PRL, etc.) and VLU will give the message "may not type" |
|||
followed by the file name. Crunched files of proscripted types |
|||
may have a "stamp" of interest to the user. If a proscripted file |
|||
is crunched, VLU will give the filename as it appears and attempt |
|||
to extract the original filename and any stamp contained in the |
|||
first record of the file. Thus, the datestamps of COM and REL |
|||
files may be inspected using the View command. |
|||
|
|||
|
|||
Crunching disk files |
|||
|
|||
|
|||
The crunching faculty of VLU is incidental. Because of the Group |
|||
operations, it is quite useful but, ab ovo, crunching files on |
|||
disk has been secondary to the project of crunching files into |
|||
libraries. Selecting "K" at the command prompt will cause VLU to |
|||
crunch the file pointed to by its cursor. |
|||
|
|||
VLU will first prompt for a "stamp." By convention, this is a |
|||
message of up to 40 characters enclosed in square brackets. The |
|||
message is imbedded in the first record of the crunched file to be |
|||
displayed when the file is either uncrunched or viewed. Often, |
|||
the message reports the date of the crunching, the author or |
|||
origin of the file, or its expanded size. |
|||
|
|||
VLU will allow the entry of up to 38 characters. Two characters |
|||
are reserved so that VLU can insert the square brackets if the |
|||
user omits one or both. VLU will remove any trailing spaces from |
|||
the message; if the user wishes the spaces to appear, the user |
|||
must enter at least the final closing bracket. |
|||
|
|||
VLU will also imbed the current datestamp of the file, if present, |
|||
in the form established by CRUNCH23D. To use the datestamp in |
|||
place of a text stamp simply type a return at the "Enter stamp" |
|||
prompt. |
|||
|
|||
The crunching operation will be aborted if the file is already |
|||
compressed (either crunched or squeezed) or is of a proscripted |
|||
filetype. Proscripted filetypes are ARC, ARK, BAD, and, if the |
|||
target is a library, FOR and CIM (vide infra). |
|||
|
|||
VLU will allow the user to crunch a member out of a library onto |
|||
the disk. There seems no harm in such an operation (and as little |
|||
use). |
|||
|
|||
|
|||
File size report |
|||
|
|||
|
|||
The size of a file in kilobytes and sectors (records) is reported |
|||
when the user presses either "F" or carriage return. If the file |
|||
is a library member, size is reported to the nearest higher 1K. |
|||
If the file is on disk, size is reported according to the blocking |
|||
factor of the disk. |
|||
|
|||
|
|||
Renaming files |
|||
|
|||
|
|||
To rename a library member or a disk file, position the cursor |
|||
beside the file and press "R". Enter the new name at the prompt. |
|||
|
|||
|
|||
Deleting files |
|||
|
|||
|
|||
To delete a library member or a disk file, position the cursor |
|||
beside the file and press "D". The user will be prompted to |
|||
confirm that the file is to be deleted. Under Group Delete, the |
|||
first prompt applies to all tagged files. Answering Yes to this |
|||
prompt will delete all files with no further prompts. Answering |
|||
No will abort the operation entirely (no files deleted). |
|||
Answering Verify will cause a prompt to appear for each file in |
|||
the group. |
|||
|
|||
|
|||
Building libraries |
|||
|
|||
|
|||
In order for VLU to build a library, all files to be included |
|||
must be located in the same directory. The library may, if |
|||
necessary, be built in a foreign directory. |
|||
|
|||
As distributed, VLU will crunch all files as they are added to the |
|||
library (unless the extension is unacceptable as previously |
|||
stated). See the configuration section for possible attenuation |
|||
of this practice. |
|||
|
|||
VLU does have limits governing the maximum size library it may |
|||
build or deal with. Those limits will vary with the size of the |
|||
current TPA. Most users will never approach VLU's limits, but for |
|||
curiosity's sake, a TPA of 58K is sufficient to manipulate a |
|||
library of over 1200 members. |
|||
|
|||
To initiate the construction, tag the files which are to be |
|||
included and then type "GB" for Group and Build. VLU will prompt |
|||
for the name and directory of the "new library" and the number of |
|||
entries to allow. A carriage return at the "entries" prompt will |
|||
build a library with the minimum directory size, only large enough |
|||
to accommodate the currently tagged files. If you specify the |
|||
number of members (say, 40), VLU will build a library large enough |
|||
to hold at least this many members and will report the actual |
|||
number of possible entries ("initializing 43 entries"). |
|||
|
|||
Rather than count the number of members you have tagged and add to |
|||
that the number of members you expect to add in the future, you |
|||
may simply enter "+40" to have VLU make the calculation. VLU will |
|||
build a library large enough to hold the presently tagged files |
|||
and 40 more. If no files are currently tagged, VLU will build an |
|||
empty library large enough to hold at least 40 members. |
|||
|
|||
VLU will then initialize the library directory area. The |
|||
directory list (onscreen) will be reset to the first screen; the |
|||
cursor will move to the first tagged file and a message will |
|||
display that the file is being crunched or added as appropriate. |
|||
If any files are to be crunched, the "stamp" prompt will appear |
|||
and the stamp thus entered will be in effect for all files |
|||
crunched into the library. |
|||
|
|||
Under this operation, as under the Wildcard and other Group |
|||
operations, the directory list onscreen will shift through all |
|||
files searching for tags. This will be more noticeable in larger |
|||
directories (which require more than one display) and during the |
|||
Building of libraries (because of the pause to close the library). |
|||
|
|||
The datestamps for file creation date/time and file modification |
|||
date/time will be copied into the library directory if they are |
|||
available on the disk. They may also be imbedded in crunched |
|||
members (if no stamp is entered). The current time/date will be |
|||
placed in the library directory to indicate when the library was |
|||
originally constructed. |
|||
|
|||
|
|||
Adding files to a Library |
|||
|
|||
|
|||
Adding files to an existing library is a simple as constructing |
|||
the library in the first place and the files will be compressed |
|||
according to the same rules. Date/time stamps will be preserved. |
|||
The current date/time will be written into the library directory |
|||
to indicate the library's last modification. |
|||
|
|||
Files may be added individually or tagged and added in a Group |
|||
operation. The library to which they will be added must be open |
|||
and must have unused directory entries (deleted entries will not |
|||
be overwritten). |
|||
|
|||
|
|||
Configuration |
|||
|
|||
|
|||
Several configuration bytes are located in the first sector of the |
|||
VLU command file where they may be easily patched. For the exact |
|||
location and function of these bytes, see the accompanying file, |
|||
VLUxxxC.Z80. |
|||
|
|||
|
|||
Option menu |
|||
|
|||
|
|||
The Option menu, accessed by typing "M" at the command prompt, |
|||
will toggle many of the configuration bytes. This allows |
|||
temporary assignment of the options. |
|||
|
|||
|
|||
Security |
|||
|
|||
|
|||
The Login command of VLU will use the Z33 parser when it is |
|||
available, thus behaving exactly as the operating system would in |
|||
allowing admittance to directory areas. When Z33 is not available, |
|||
VLU allows immediate entry to any du: or dir: within the MAXDSK |
|||
and MAXUSR limits of the environment. Dir: forms outside these |
|||
limits are also accepted; passwords, if present, are enforced. |
|||
|
|||
Commands Delete and Rename and any commands that would create new |
|||
files are available only while the wheel byte is set. |
|||
|
|||
|
|||
Contributors |
|||
|
|||
|
|||
VLU directly incorporates the work of many "better makers." My |
|||
thanks to all of them as much and more for the opportunity to read |
|||
and learn from their code as well as for their library releases. |
|||
Among them, the following: |
|||
|
|||
Richard Conn, Howard Goldstein, Jay Sage, Al Dunsmuir et al. for |
|||
SYSLIB, Z3LIB, Z33LIB and VLIB--and ZCPR, itself. |
|||
|
|||
C.B. Falconer and Steven Greenberg for USQREL, UNCREL, CRN, and |
|||
BUFFERS. |
|||
|
|||
Steven Cohen for M24. Carson Wilson for DATEHL and Z80DOS. |
|||
Bridger Mitchell for FRESET and CRUNCH23D. |
|||
|
|||
Martin Murray for NULU, the standard for these efforts. And Gary |
|||
Novosielski for the library format. |
|||
|
|||
|
|||
Note from the programmer |
|||
|
|||
|
|||
VLU, its source code, and its documentation are copyright 1987, |
|||
1988 by Esoteric Software. VLU is distributed for non-commercial |
|||
use only; any commercial use or any re-distribution in association |
|||
with a commercial product or package requires the prior written |
|||
permission of the author. |
|||
|
|||
I may be reached on Z-nodes 2 and 3--Al Hawley's Ladera and Jay |
|||
Sage's Newton Centre; both are available via PC-Pursuit. I log |
|||
into these nodes approximately semi-weekly. If it is important to |
|||
reach me sooner, my home Z-node is #58, operated by Kent Mason in |
|||
Oklahoma City (405/943-8638). |
|||
|
|||
@ -0,0 +1,442 @@ |
|||
: |
|||
ZFILER HISTORY |
|||
|
|||
Version 1.1 Jan 9, 1993 Jay Sage |
|||
|
|||
1. Texô messageó werå gathereä intï á blocë iî ordeò tï supporô � |
|||
languagå overlayó aó explaineä iî mù articlå iî Thå Computeò � |
|||
Journal® Englisè anä Germaî versionó arå supplieä witè thå initiaì � |
|||
release. |
|||
|
|||
2. The CFG configuration file for use with ZCNFG was extensively� |
|||
overhauled. |
|||
|
|||
3. The source code is now being released. |
|||
� Versioî 1.0ñ Jaî 9¬ 199² Roâ Friefelä ¦ Jaù Sage |
|||
|
|||
1. Addeä optioî tï filteò VIE× anä PRINÔ output® Iæ ON¬ thå filteò � |
|||
removeó thå higè bit¬ theî printó onlù alphanumerics¬ CR¬ anä LF® � |
|||
Iæ assemblù optioî EXPTAÂ iæ false¬ TABÓ arå alsï output® Thå � |
|||
filteò settinç maù bå toggleä froí thå Optionó command. |
|||
|
|||
2. ZFILEÒ caî remembeò alì thå filå tagó wheî iô returnó afteò á Ú � |
|||
commanä oò macrï run® Thå filå lisô ió writteî tï á temporarù disë � |
|||
filå (ZFILER.TAG¬ iî á configurablå directory)¬ anä automaticallù � |
|||
reaä back® Thió featurå caî bå turneä off¬ iæ desired¬ froí thå � |
|||
Optionó command. |
|||
|
|||
3. Grouð Tag/Untaç anä Wilä Tag/Untaç maù bå separatelù seô tï worë oî � |
|||
thå entirå ring¬ oò jusô froí thå filå pointer® Grouð Reverså alwayó � |
|||
workó oî thå entirå ring® Toggleó arå oî Optionó list® Lisô macroó � |
|||
no÷ sofô taç fileó jusô likå regulaò grouð macros. |
|||
|
|||
4. Thå Optionó lisô ió no÷ 1µ itemó long® Theså flagó werå previouslù � |
|||
saveä witè thå filå mask¬ sï onlù 1± itemó coulä bå reliablù saved® � |
|||
Theù arå no÷ bit-encodeä iî thå lasô twï byteó oæ thå shelì stacë � |
|||
entry® (Thå NOÔ USESTË assemblù optioî haó noô beeî recodeä tï � |
|||
reflecô thió change® Itó limitó werå lonç agï exceeded.) |
|||
|
|||
5. Z33OPÔ arå flaç byteó copieä froí ZCPÒ tï á locaì buffer¬ useä foò � |
|||
controllinç passworä checking® Previouó versioî waó checkinç thå � |
|||
wronç bits® Sincå thå locaì buffeò ió loadeä aô runtime¬ iô waó � |
|||
moveä tï DSEG. |
|||
Version 1.0p May 16, 1991 Rob Friefeld |
|||
|
|||
--- BUGS FIXED: |
|||
1. Copù tï existinç r/ï filå failed® Thå destinatioî attributeó werå � |
|||
neveò checkeä iæ "Seô Desô Att¢ optioî waó false® |
|||
2. Oî disë full¬ partiallù copieä filå ió closeä beforå deletioî sï � |
|||
thaô disë spacå reporô ió no÷ correct. |
|||
3. Iæ thå ZEØ batcè filå ió locateä iî á specifiã DÕ noô oî thå path¬ � |
|||
ZEØ won'ô finä it® Althougè thå MACROCMDº patcè poinô coulä bå � |
|||
altereä tï "ZEØ DU:ZFILER"¬ ZÆ wilì no÷ dï thió automaticallù afteò � |
|||
creatinç thå .ZEØ file® Aó á result¬ thå MACROCMÄ entrù MUSÔ uså á ³ � |
|||
letteò commanä namå iæ yoõ patcè iô tï ruî somethinç otheò thaî � |
|||
'ZEX'. |
|||
|
|||
--- ALTERATIONS: |
|||
1. DINIT called on exit.� |
|||
2. Installatioî optioî availablå tï eraså finisheä ZFILER.ZEØ oî shelì � |
|||
run® Yoõ maù wanô tï seô thió flaç afteò debugginç youò macrï � |
|||
commanä file. |
|||
3. Clear screen on exit (EXITCLS) is config option now.� |
|||
4. Grouð Taç anä Grouð Untaç operatå froí thå filå pointeò tï thå enä � |
|||
oæ thå list¬ ratheò thaî oî thå entirå list® (Thió ió á restoratioî � |
|||
oæ somethinç ZÆ useä tï do.© |
|||
|
|||
--- NEW: |
|||
1. ZF10P.CFÇ configuratioî filå foò uså witè ZCNFG.COM® Handleó alì thå � |
|||
configuratioî excepô macrï strinç installation. |
|||
|
|||
2. Grouð Macrï putó taggeä filå counô intï (configurable© useò registeò � |
|||
#µ beforå running® Thå macrï caî theî dowî counô anä takå somå � |
|||
additionaì actioî afteò iô haó ruî oî eacè taggeä file® Thå � |
|||
intendeä uså foò thió ió tï creatå librarieó oæ cruncheä fileó witè � |
|||
onå macrï command® Foò example¬ thå script |
|||
|
|||
1 ! $d$u:;$!crunch $f M1:;reg m5;if reg 5= 0;$"Library DU ":; |
|||
lput $"Library Name: " M1:*.* +1;era M1:*.?Z?;fi;$h: |
|||
|
|||
cruncheó taggeä fileó tï á fixeä directorù M1º (oî thå RAÍ disk)¬ � |
|||
makeó á librarù ouô oæ theí (leavinç rooí foò ± morå file© witè � |
|||
inpuô foò librarù namå anä location¬ theî eraseó alì thå � |
|||
"crunchettes". |
|||
|
|||
Foò consistency¬ singlå macroó puô á "1¢ counô iî thå useò reg® � |
|||
Therå ió nï codå tï enforcå thå 0..¹ useò registeò range¬ iî caså � |
|||
yoõ wanô tï uså 18..3± (10-1µ arå reserved¬ 16-1· arå useä bù otheò � |
|||
programs). |
|||
|
|||
REÇ musô bå á Type³ oò Type´ (oò RCP© foò thå ZEØ GÏ "$!¢ tï ruî � |
|||
CRUNCÈ repeatedly. |
|||
Version 1.0o September 21, 1989 Carson Wilson |
|||
|
|||
--- Implementeä lisô capabilitù foò grouð macros® Iæ á ZFILER.CMÄ scripô � |
|||
beginó witè á commá (beforå oò afteò thå leadinç "!¢ shelì pauså � |
|||
parameter)¬ ZFILEÒ wilì alwayó expanä thå macrï directlù tï ZCPR'ó � |
|||
multiplå commanä line® Iî thå caså oæ á grouð macro¬ $P¬ $F¬ anä $Ô � |
|||
parameteró arå expandeä tï á lisô oæ alì taggeä files¬ separateä bù � |
|||
thå characteò followinç thå leadinç comma® Foò example¬ thå script |
|||
|
|||
± ¬ !echï thå taggeä fileó arå $F |
|||
|
|||
displayó "THÅ TAGGEÄ FILEÓ ARÅ "¬ followeä bù á lisô oæ thå taggeä � |
|||
fileó separateä bù ¢ ¢ oî thå consolå (assuminç ECHÏ ió á valiä ZCPÒ � |
|||
command)® ZFILEÒ theî promptó foò á keypresó beforå returning® � |
|||
Pleaså notå thaô thió macrï bufferó thå entirå lisô oæ taggeä fileó � |
|||
tï CP/M'ó commanä linå buffer¬ whicè ió onlù 12µ byteó iî length® Thå � |
|||
abovå commanä thereforå normallù causeó á "Commanä toï long¢ erroò iæ � |
|||
morå thaî abouô ¸ fileó arå tagged¬ dependinç oî thå lengthó oæ thå � |
|||
taggeä names. |
|||
|
|||
--- Madå thå escapå characteò anä thå characteró tï quotå witè iô wheî � |
|||
writinç á grouð macrï commanä tï ZEØ oò SUBMIÔ fileó installablå (seå � |
|||
ZFCNFN.Z8° foò details)® Escapå characteò ió currentlù "$"¬ anä � |
|||
quoteä characteró arå currentlù "$"¬ "|"¬ anä "<"¬ aó requireä bù ZEØ � |
|||
versioî 5. |
|||
|
|||
--- Iô ió no÷ possiblå tï answeò ZFILER'ó "Logiî [DIR][:MASKÝ ¢ prompô � |
|||
witè ".<cr>¢ (samå aó ":<cr>"© tï loç iî alì fileó iî thå currenô � |
|||
directory® Previouslù thió loggeä iî alì fileó aô useò zerï oæ thå � |
|||
currenô drive® Thå Logiî commanä no÷ alsï seemó tï accepô ".afn¢ � |
|||
insteaä oæ ":afn". |
|||
|
|||
--- Shelì biô seô whilå waitinç foò useò commands¬ theî immediatelù reseô � |
|||
wheî á commanä keù ió received® Thió shoulä allo÷ Bridgeò Mitchell'ó � |
|||
AÔ commanä scheduleò RSØ tï interrupô ZFILEÒ aó iô woulä thå CCÐ � |
|||
whilå ZFILEÒ ió promptinç foò commands. |
|||
|
|||
--- Fixeä buç whicè preventeä anù Grouð commandó froí operatinç wheî thå � |
|||
configuratioî bytå MACFLAÇ waó patcheä tï false. |
|||
|
|||
--- Removeä codå whicè attempteä tï uså thå ZCPÒ Environmenô tï determinå � |
|||
ho÷ manù lineó oæ texô tï displaù witè thå Ö command¬ aó thió waó � |
|||
onlù partiallù implemented¬ resultinç iî difficultù oî terminaló witè � |
|||
oveò 2´ rows® Texô lineó no÷ hard-codeä tï 22¬ sï ZFILEÒ shoulä worë � |
|||
oî anù terminaì witè 2´ oò morå screeî rows. |
|||
|
|||
--- Fixeä smalì buç whicè causeä "Publiã Filå Error¢ messagå tï � |
|||
disappear. |
|||
|
|||
--- Control-É ió no÷ aî aliaó foò control-Ê (jumð tï filå again)¬ foò uså � |
|||
witè terminaì definitionó (TCAPs© whicè definå control-Ê aó aî arro÷ � |
|||
key. |
|||
|
|||
--- Ideá foò futurå versionsº iô woulä bå verù difficulô tï allo÷ filå � |
|||
rinç sortinç baseä oî filå dateó (woulä neeä tï storå datå stampó � |
|||
witè ring¬ requirinç majoò rewrite)® Iô woulä bå relativelù simplå tï � |
|||
allo÷ thå Logiî anä startuð commandó tï accepô anä matcè fileó tï á � |
|||
datespec¬ though... |
|||
Version 1.0n March 20, 1989 Carson Wilson |
|||
|
|||
--- Addeä $ª scripô parameteò tï cleaò thå screeî during¬ anä rebuilä iô � |
|||
afteò á scripô prompt® Usagå ió $"$*..text..¢ Prompô texô appearó aô � |
|||
thå toð oæ á cleareä screen. |
|||
� |
|||
--- Iî anticipatioî oæ thå ZEØ 4.0x¬ '$§ anä '|§ arå no÷ thå onlù � |
|||
characteró whicè arå quoteä wheî ZFILEÒ buildó thå ZFILER.ZEØ file® � |
|||
Iæ theù appeaò iî á ZFILER.CMÄ scripô theså characteró arå quoteä � |
|||
witè á leadinç dollaò sigî wheî ZFILER.ZEØ ió built® Alì otheò � |
|||
characteró arå passeä "aó is¢ tï thå ZEØ file® Thió meanó thaô yoõ � |
|||
cannoô uså ZEØ directiveó sucè aó $1¬ |crlf|¬ etc® dynamically¬ buô � |
|||
thió waó neveò thå intentioî oæ thå interfacå betweeî ZFILEÒ anä ZEØ � |
|||
- thå ideá waó simplù tï providå multiplå executionó oæ á ZFILEÒ � |
|||
commanä script. |
|||
|
|||
--- For efficiency ZFILER no longer resets disks under Z3PLUS. |
|||
Version 1.0m January 24, 1989 Carson Wilson |
|||
|
|||
--- Copù anä Movå commandó no÷ worë properlù witè Z3PLUS¬ anä thå currenô � |
|||
12-houò timå showó aô thå toð oæ thå screeî undeò Z3PLUS. |
|||
|
|||
--- Patè fileó conflictó arå nï longeò reporteä undeò ZSDOS® Thió � |
|||
produceä problemó wheî useró trieä tï backuð directorieó alonç thå � |
|||
path® ZSDOÓ publiã conflictó arå stilì reported. |
|||
|
|||
--- Grouð Movå anä Grouð Copù erroò messageó arå no÷ sustaineä untiì thå � |
|||
useò strikeó á key¬ ratheò thaî disappearinç immediately. |
|||
|
|||
--- Promptó iî scriptó maù no÷ contaiî controì characteró aó "^x¢ wherå ø � |
|||
ió anù characteò froí À tï z. |
|||
|
|||
--- Thå dollaò sigî ió no÷ aî "escapå character¢ foò scripô prompts¬ anä � |
|||
caî bå useä tï includå thå $¬ ^¬ "¬ anä § characteró iî prompts. |
|||
|
|||
Examples: |
|||
Script Result |
|||
$"Enter name or $^C: " Enter name or ^C: � |
|||
$"Type $"//$" for help: " Type "//" for help: |
|||
|
|||
--- Movå anä Grouð Movå no÷ uså thå optioî menõ selectionó wheî movinç � |
|||
fileó insteaä oæ alwayó copyinç filå attributes. |
|||
|
|||
--- Cleaned up help screen. |
|||
|
|||
--- Tï savå debugginç timå É havå changeä thå defaulô optioî menõ � |
|||
settingó tï mù preferences. |
|||
Version 1.0l September 13, 1988 Carson Wilson |
|||
|
|||
--- Bugó iî thå Grouð Copy¬ Grouð Move¬ anä Grouð Deletå commandó whicè � |
|||
occurreä wheî thå useò aborteä certaiî promptó witè á control-Ã havå � |
|||
beeî corrected. |
|||
|
|||
--- Á buç whicè resulteä iî erratiã behavioò iæ ZFILER.CMÄ waó noô founä � |
|||
waó fixed. |
|||
|
|||
--- Thå unsQueezå commanä waó removeä tï reducå prograí size® Sincå fe÷ � |
|||
ne÷ fileó arå squeezeä anä UNCRUNCÈ no÷ supportó unsqueezinç iô seemó � |
|||
preferablå tï exporô thió functioî bù callinç UNCRUNCÈ witè á ZFILEÒ � |
|||
macro® Aî additionaì benefiô oæ thió techniquå ió thaô á singlå � |
|||
commanä no÷ maù bå useä foò botè uncrunchinç anä unsqueezing® ZFILEÒ � |
|||
wilì stilì displaù anä prinô squeezeä files® |
|||
|
|||
--- ZFILEÒ no÷ performó consistentlù wheî invokeä witè ZCPR'ó GÏ oò JUMÐ � |
|||
commands® Previouó versionó faileä wheî morå thaî onå Ú oò macrï � |
|||
commanä waó useä afteò invokinç ZFILEÒ witè GO/JUMP. |
|||
|
|||
--- (DateStampeò versionó only)® Iæ á DateStampeò (BDOÓ functioî 12© � |
|||
real-timå clocë ió available¬ thå currenô 12-houò timå ió printeä tï � |
|||
thå lefô oæ thå "ZFILER¢ namå aô thå toð oæ thå screen. |
|||
|
|||
--- Iæ runninç undeò ZSDOÓ oò ZDDOS¬ disë resetó arå skippeä foò alì � |
|||
commandó excepô Space® Thió considerablù increaseó performancå oî � |
|||
floppù disë systems. |
|||
|
|||
--- Thå environmenô addresó ió loadeä froí locatioî 10¹ aô ruî timå foò � |
|||
compatibilitù witè ZCPÒ 3.° systems. |
|||
|
|||
--- Thå performancå oæ thå Delete¬ Copy¬ Move¬ Archive¬ anä Renamå � |
|||
commandó haó beeî improveä bù minimizinç disë accesses. |
|||
|
|||
--- Thå Spacå commanä no÷ resetó individuaì drives® Thió ió morå � |
|||
efficienô anä makeó thå Ó commanä practicaì witè virtuaì drives. |
|||
|
|||
--- Thå Spacå anä Filesizå commandó no÷ worë properlù afteò printinç � |
|||
files. |
|||
|
|||
--- ZFILEÒ no÷ checkó foò anä reportó Publiã oò Patè conflictó wheî � |
|||
Copying¬ Renaming¬ Moving¬ anä Archivinç fileó undeò ZSDOS® Iî � |
|||
addition¬ fileó createä witè Copy/Move/Archivå arå alwayó seô tï � |
|||
Privatå (higè biô oæ f2=0© tï avoiä possiblå ZSDOÓ Publiã conflicts. |
|||
|
|||
--- Single file View no longer affects file tags. |
|||
|
|||
--- Single file Copy or Move no longer skip to the next file afterwards. |
|||
|
|||
--- (DateStampeò versionó only)® Iæ available¬ Copy/Move/Archivå uså � |
|||
ZSDOS'ó morå efficienô Geô Stamð anä Seô Stamð functioî calló tï � |
|||
preservå filå datestampó acrosó copies® Thå oldeò methoä oæ � |
|||
datestampinç ió retaineä foò non-ZSDOÓ systems. |
|||
|
|||
--- Rename error messages no longer disappear before they can be read. |
|||
Version 1.0k May 3, 1988 Jay Sage |
|||
|
|||
--- Fixeä somå minoò bugó iî thå codå (slipuð oæ usinç á DÂ wherå É � |
|||
intendeä á DÓ tï allocatå spacå foò longeò stringó tï bå patchable) |
|||
Version 1.0j May 1, 1988 Jay Sage |
|||
|
|||
--- Improveä flexibilitù oæ grouð macrï operatioî bù puttinç threå itemó � |
|||
iî thå configuratioî page® Thå strinç MACROCMÄ ió á null-terminateä � |
|||
strinç witè thå grouð macrï commanä line® Thå strinç MACLEADSTÒ ió á � |
|||
null-terminateä strinç oæ characteró tï bå writteî aô thå beginninç � |
|||
oæ thå grouð macrï batcè filå (ZEØ oò SUBMIT)® Thå strinç MACROFCÂ � |
|||
markó thå filå controì blocë foò thå filå witè thå grouð macrï � |
|||
commands. |
|||
|
|||
--- Fixeä á buç iî thå expansioî oæ filå nameó iî macrï parameters® Thå � |
|||
codå waó noô maskinç ouô filå attributes® Iô happeneä thaô thió diä � |
|||
noô matteò excepô foò blankó witè attributeó set¬ buô no÷ thå codå ió � |
|||
correct. |
|||
|
|||
--- Therå ió aî additionaì configuratioî optioî (lasô bytå iî CONFIÇ � |
|||
sectioî jusô beforå OPÔ string© thaô allowó filå nameó tï bå showî iî � |
|||
loweò case® Seô thå bytå tï FÆ foò uppeò case¬ ° foò loweò case. |
|||
Version 1.0i April 14, 1988 Jay Sage |
|||
|
|||
--- Thå sourcå codå tï 1.0è waó losô iî á disë crash® Thå featureó havå � |
|||
beeî recreated® Thå operatioî witè GÏ oò JUMÐ haó beeî improved. |
|||
|
|||
--- Thå shelì stacë entrù no÷ includeó thå expliciô directorù wherå thå � |
|||
filå waó founä iæ Z3³ oò lateò ió running. |
|||
Version 1.0h September 16, 1987 Jay Sage |
|||
|
|||
--- Fixeä buç iî thå codå foò logginç iî thå displayeä directorù wheî thå � |
|||
Ú commanä ió executed® Iô waó noô workinç correctlù undeò standarä � |
|||
ZCPR3° oò BackGrounder. |
|||
|
|||
--- Addeä optionó tï controì ho÷ thå ZFILER.CMÄ macrï filå ió located® Á � |
|||
choicå oî thå optioî menõ allowó onå tï turî oî oò ofæ searchinç oæ � |
|||
thå entirå patè (includinç currenô directory)® Iæ thaô optioî ió off¬ � |
|||
eitheò thå rooô directorù oò á specifieä directorù wilì bå used¬ � |
|||
dependinç oî thå configuratioî oæ thå program. |
|||
|
|||
--- ZFILEÒ caî no÷ bå reexecuteä usinç thå GÏ command® É borroweä á tricë � |
|||
froí Aì Hawley® Wheî invokeä originally¬ ZFILEÒ checkó thå namå useä � |
|||
tï invokå it® Iæ thå namå ió 'GO'¬ theî á defaulô namå storeä iî aî � |
|||
internaì buffeò ió used® Otherwise¬ iæ thå namå ió copieä tï thaô � |
|||
buffeò froí thå externaì FCB® É believå thió changå wilì allo÷ ZFILEÒ � |
|||
tï bå reconfigureä usinç thå 'O§ commanä anä theî cloneä usinç SAVE. |
|||
|
|||
--- Á morå extensivå useò configuratioî filå haó beeî provideä whicè � |
|||
compriseó sectionó oæ ZFHDR.Z8° (thå definitionó file© anä ZFMAIN.Z8° � |
|||
(thå beginninç oæ thå maiî code)® Aó before¬ reconfiguratioî caî bå � |
|||
carrieä ouô bù editinç ZFCNFH.Z8° anä assemblinç iô tï á HEØ file® � |
|||
Theî "MLOAÄ ZFNEW=ZF0LD.COM,ZFCNFH¢ wilì instalì thå changes. |
|||
Version 1.0g August 23, 1987 Carson Wilson |
|||
|
|||
--- Reverså video¬ dim¬ oò '_§ arå no÷ useä oî thå statuó linå tï displaù � |
|||
alì currenô filå attributes® 'r§ read-onlù tagó werå interferinç witè � |
|||
thå tagginç commandó anä arå nï longeò used. |
|||
|
|||
--- Corrected bug preventing view/unsqueeze of squeezed system files. |
|||
|
|||
--- Correcteä buç causinç squeezeä read-onlù fileó tï bå unsqueezeä aó � |
|||
systeí fileó wheî copyinç attributes. |
|||
|
|||
--- Made invalid command display show actual command. |
|||
|
|||
--- Removeä ZFILEÒ commanä prompô oî exiô tï avoiä confusioî betweeî � |
|||
systeí anä ZFILER'ó 'Z§ command® |
|||
|
|||
--- Fixeä initiaì helð screeî froí commanä line. |
|||
|
|||
--- Added space before 'OK' after copy/unsqueeze. |
|||
Version 1.0f June 12, 1987 Jay Sage |
|||
|
|||
--- Addeä rudimentarù grouð macrï capabilitù bù havinç ZFILEÒ construcô � |
|||
anä invokå á ZEØ script. |
|||
Version 1.0c April 27, 1987 Jay Sage |
|||
|
|||
--- Madå changeó foò compatibilitù witè ZCPR33® No÷ oî manuaì invocatioî � |
|||
ZFILEÒ returnó tï thå commanä processoò iæ ZEØ ió runninç sï thaô ZEØ � |
|||
caî continuå tï supplù commandó eveî iæ therå arå nï morå commandó oî � |
|||
thå currenô commanä line. |
|||
Version 1.0b January 13, 1987 Jay Sage |
|||
|
|||
--- Addeä DateStampeò support® No÷ oî filå copieó anä moves¬ thå timå anä � |
|||
datå stamð oæ thå sourcå filå ió carrieä tï thå destination. |
|||
|
|||
--- Modifieä handlinç oæ directorieó witè 'L§ (oò 'N'© command® Thå codå � |
|||
no÷ respectó thå DUOË flaç iî thå environment® Iæ iô ió set¬ theî anù � |
|||
attempô tï loç iî á directorù ió checkeä againsô thå maxdrivå anä � |
|||
maxuseò valueó iî thå environment® Iæ thå requesô passeó thaô test¬ � |
|||
theî thå directorù ió loggeä iî eveî iæ iô haä beeî specifieä usinç á � |
|||
DIÒ forí anä eveî iæ á passworä ió associateä witè it® Iæ thå � |
|||
requesteä directorù ió beyonä thå maxdrive/maxuseò rangå oò iæ DUOË � |
|||
ió noô set¬ theî thå nameä directorù registeò ió checked® Passwordó � |
|||
arå checkeä aó needeä usinç improveä codå (shorteò anä morå � |
|||
accurate). |
|||
|
|||
--- Addeä smalì biô oæ codå tï thå ZFILEÒ initializatioî tï changå thå JÐ � |
|||
opcodå aô 100È tï REÔ sï thaô ZFILEÒ cannoô bå reruî usinç thå "GO¢ � |
|||
commanä (thió haó baä consequences¬ sincå thå shelì stacë entrù theî � |
|||
woulä havå thå commanä "GO¢ storeä iî it!). |
|||
Version 1.0a January 1, 1987 Jay Sage |
|||
|
|||
--- IMPORTANÔ CHANGEº Tï makå ZFILEÒ consistenô witè otheò scripô � |
|||
processinç programs¬ thå defaulô parameteò designatioî characteò haó � |
|||
beeî changeä froí '%§ tï '$'® Thå parameteò '$'¬ aî alternatå foò 'P§ � |
|||
(completeä Pointed-to-filå specº du:name.typ© waó thereforå � |
|||
eliminated® Theså changeó wilì requirå editinç oæ anù VFILER.CMÄ filå � |
|||
wheî convertinç tï ZFILER.CMÄ (thå macrï filå useä bù ZFILER). |
|||
|
|||
--- Modifieä thå waù thå shelì stacë entrù ió used® Iô no÷ keepó botè thå � |
|||
originaì directorù anä thå requesteä directorù oî thå stack® Thió haó � |
|||
twï majoò advantages® Bù keepinç thå originaì directorù oî thå stack¬ � |
|||
oî exiô witè thå 'X§ commanä ZFILEÒ caî returî tï thå directorù froí � |
|||
whicè iô waó originallù invokeä nï matteò ho÷ manù otheò directorieó � |
|||
havå beeî loggeä iî bù uså oæ thå 'Z§ commanä oò á macro® Keepinç thå � |
|||
requesteä (displayed© directorù oî thå shelì stacë avoidó thå probleí � |
|||
witè á passwordeä directorù oæ havinç tï reenteò thå passworä everù � |
|||
timå ZFILEÒ returneä froí á macrï oò 'Z§ operation. |
|||
|
|||
--- Addeä featurå witè 'Z§ commanä tï allo÷ avoidancå oæ thå "Strikå anù � |
|||
Key¢ messagå oî returî tï ZFILER® Iæ thå commanä linå entereä witè � |
|||
thå 'Z§ commanä beginó witè á space¬ theî shelì waitinç wilì bå � |
|||
disabled. |
|||
|
|||
--- Fixeä á buç causeä bù thå GÁ command® Oncå thaô commanä waó used¬ aî � |
|||
archivinç flaç waó seô anä neveò cleared® Á lateò GÃ commanä theî � |
|||
useä thå group-archivå promptinç optionó insteaä oæ thå group-copù � |
|||
options® Thió flaç ió no÷ reseô beforå alì grouð operations. |
|||
|
|||
--- Addeä optioî oî filå copù anä unsqueezå functionó tï allo÷ thå � |
|||
destinatioî filå attributeó tï bå seô tï thoså oæ á filå thaô ió � |
|||
beinç overwritten® Iæ therå ió nï sucè filå anä thå attributå settinç � |
|||
optioî ió engaged¬ theî thå sourcå filå attributeó wilì bå used. |
|||
|
|||
--- Changeä codå foò filå viewinç sï thaô scrollinç wilì stoð aô thå enä � |
|||
oæ á filå (carriagå returî anä spacå wilì noô causå thå nexô filå tï � |
|||
start)® Onlù control-Ø oò control-Ã wilì bå effectivå aô thå enä oæ � |
|||
file® Alsï addeä control-Ú optioî tï gï straighô tï thå enä oæ filå � |
|||
withouô paging. |
|||
|
|||
--- Changeä thå codå thaô allowó interruptioî oæ grouð operationó sï thaô � |
|||
á carriagå returî wilì noô causå aî aborô (manù useró answeò somå � |
|||
promptó thaô requirå nï returî witè á returî anä founä thaô grouð � |
|||
operationó workeä onlù oî thå firsô file)® Anù characteò otheò thaî � |
|||
carriagå returî wilì aborô masó operations. |
|||
|
|||
--- Madå iô possiblå tï geô thå macrï helð screeî bù pressinç thå leadiî � |
|||
characteò á seconä timå iî responså tï thå 'Macro§ prompô (thió ió � |
|||
mucè easieò anä morå naturaì thaî enterinç thå '#§ command). |
|||
|
|||
--- Fixeä á buç iî thå macrï helð displaù thaô waó echoinç controì � |
|||
characteró tï thå screen® Theså arå no÷ filtered® Onå caî no÷ enteò � |
|||
ESÃ ESÃ tï seå thå macrï helð screeî anä á thirä ESÃ tï returî tï thå � |
|||
filå display. |
|||
|
|||
--- Addeä ^Ê commanä tï jumð tï nexô filå thaô matcheó thå lasô masë � |
|||
specifieä iî á "J¢ command® Thió allowó onå tï jumð easilù tï thå � |
|||
seconä oò thirä filå thaô matcheó á simplå filå spec. |
|||
|
|||
--- Fixeä buç iî "M¢ anä "GM¢ commandó thaô alloweä sourcå filå tï bå � |
|||
deleteä, eveî wheî copù haä noô beeî performed. |
|||
|
|||
--- Addeä "GR¢ grouð reverså functioî tï reverså filå tags® Taggeä fileó � |
|||
becomå untagged» untaggeä fileó becomå tagged» anä soft-taggeä fileó � |
|||
remaiî soft-tagged. |
|||
|
|||
--- Cleaneä uð loç commanä ("L¢ oò "N")® Removeä speciaì handlinç oæ � |
|||
answeò "x¢ foò directorù namå (nï longeò needed© anä changeä erroò � |
|||
handlinç code. |
|||
|
|||
--- Addeä á configuratioî optioî tï automaticallù loç iî thå displayeä � |
|||
directorù foò thå "Z¢ commanä iæ thå useò numbeò ió lesó thaî 16® Iæ � |
|||
thió optioî ió configureä in¬ theî thå disë systeí ió reseô beforå � |
|||
thå commanä linå ió ruî (thió ió thå disadvantagå oæ usinç thió � |
|||
option). |
|||
|
|||
--- Made rename command preserve all file attributes. |
|||
|
|||
--- Addeä optionó tï copù attributeó witè fileó anä tï alwayó seô thå � |
|||
archivå attributå iî thå destinatioî file® Iæ thå filå ió beinç � |
|||
moved¬ thå attributeó arå alwayó copieä anä thå archivå biô ió lefô � |
|||
aó iô was» iæ thå filå ió beinç unsqueezed¬ thå attributeó arå noô � |
|||
copieä anä thå archivå biô ió seô accordinç tï itó optioî setting. |
|||
|
|||
--------------------------------------------------------------------------- |
|||
|
|||
See the VFHIST.DOC file in VFILER Version 4.1 for the history of the� |
|||
development of VFILER. |
|||
|
|||
@ -0,0 +1,545 @@ |
|||
; ------------------------------------- |
|||
| | |
|||
| ZFILER, The Point-and-Shoot Shell | |
|||
| | |
|||
------------------------------------- |
|||
|
|||
|
|||
Z >> Introduction to Z-System Shells |
|||
F >> What is ZFILER for? |
|||
|
|||
|
|||
I >> Invoking ZFILER C >> ZFILER Commands |
|||
D >> The ZFILER Display S >> Single-File Built-In Functions |
|||
O >> Thå Optioî Commanä G >> Built-In Group Commands |
|||
J >> Credits P >> Pointeò Commandó |
|||
H >> History of ZFILER N >> Otheò Non-Filå Commandó |
|||
|
|||
|
|||
M >> ZFILER's Script Macro Facility |
|||
:Z |
|||
Z-System Shells |
|||
|
|||
Á Z-Systeí shelì ió á prograí thaô takeó oveò thå user-inpuô functioî � |
|||
oæ thå commanä processor® Thå waù thió workó ió thaô thå Z-Systeí � |
|||
environmenô includeó á speciaì areá iî memorù calleä thå shelì stacë wherå � |
|||
shelì commanä lineó caî bå kept® Wheneveò thå ZCPR³ commanä processoò ió � |
|||
finisheä processinç alì thå commandó thaô havå beeî passeä tï iô iî thå � |
|||
commanä linå buffeò (anotheò speciaì areá iî memory)¬ iô checkó thå shelì � |
|||
stack® Onlù iæ nï commanä linå ió presenô therå doeó thå commanä processoò � |
|||
itselæ prompô thå useò foò thå nexô commanä line® Iæ therå ió aî entrù iî � |
|||
thå shelì stack¬ theî thaô commanä linå ió ruî instead¬ anä thå useò nï � |
|||
longeò seeó thå commanä processoò directly. |
|||
|
|||
Somå shells¬ likå thå EASÅ oò LSÈ historù shell¬ whilå makinç á biç � |
|||
changå iî ho÷ thå systeí ió actually‚ running¬ makå relativelù littlå changå � |
|||
iî ho÷ iô appears‚ tï run® Á commanä prompô ió stilì presented¬ anä onå � |
|||
enteró commandó morå oò lesó aó usual® Thå differencå ió thaô onå haó á � |
|||
morå capablå editoò aô one'ó disposal¬ anä thå commandó arå saveä tï á � |
|||
historù filå froí whicè theù caî bå recalled¬ edited¬ anä ruî again® Aó wå � |
|||
shalì see¬ thå ZFILEÒ shelì presentó thå useò witè á dramaticallù differenô � |
|||
useò interface. |
|||
:F |
|||
� Whaô ió ZFILEÒ For¿ |
|||
|
|||
Historically¬ ZFILEÒ ió á descendanô iî thå linå oæ filå maintenancå � |
|||
utilitieó likå SWEEÐ anä NSWÐ (hencå thå "filer¢ parô oæ thå name)® Filå � |
|||
maintenancå ió generallù concerneä witè copyinç files¬ lookinç aô theiò � |
|||
contents¬ renaminç them¬ erasinç them¬ anä sï on® ZFILEÒ provideó alì theså � |
|||
functionó anä more. |
|||
Š ZFILER'ó immediatå parenô waó VFILER¬ wherå thå "V¢ stooä foò video® � |
|||
Thå TCAÐ facilitù iî Z-Systeí makeó iô easù foò programó tï takå advantagå � |
|||
oæ thå full-screeî capabilitieó oæ whateveò videï displaù terminaì happenó � |
|||
tï bå iî uså aô anù time® Iî contrasô tï applicationó undeò CP/M¬ Z-Systeí � |
|||
programó neeä noô bå configureä tï matcè thå terminal® Iô was¬ therefore¬ � |
|||
naturaì tï builä á filå maintenancå prograí iî whicè thå fileó arå displayeä � |
|||
graphicallù oî thå screen® Wheî É decideä tï explorå somå ne÷ directionó � |
|||
witè VFILER¬ tï avoiä confusioî É gavå thå prograí thå ne÷ namå ZFILER¬ foò � |
|||
Z-Systeí Filer. |
|||
Thå filå maintenancå taskó describeä abovå woulä noô requirå á shell® � |
|||
Makinç thå prograí á shell¬ however¬ allowó iô tï gï beyonä thå functionó � |
|||
includeä iî thå program'ó owî code® Becauså á shelì caî pasó commanä lineó � |
|||
tï thå operatinç system¬ ZFILEÒ caî perforí anù operatioî thaô thå computeò � |
|||
ió capablå of® Likå á menõ system¬ however¬ iô helpó thå useò bù generatinç � |
|||
thå commandó automaticallù aô thå toucè oæ á key. |
|||
|
|||
Wheî ZFILEÒ ió running¬ thå screeî ió filleä witè aî alphabetizeä � |
|||
displaù oæ thå fileó iî á specifieä directory¬ anä therå ió á pointeò thaô � |
|||
thå useò caî manipulatå usinç cursoò controì keys® Iæ wå haä á mouså tï � |
|||
movå thå pointer¬ iô woulä bå á littlå likå havinç á Macintosh® Actually¬ � |
|||
iô woulä bå á loô more® Iô woulä bå likå havinç á mouså witè fiftù buttons¡ � |
|||
Oncå thå pointeò haó beeî positioneä oî á file¬ pressinç á keù (oò twï oò � |
|||
three© causeó anù oæ á greaô numbeò oæ functionó tï bå invokeä tï acô oî � |
|||
thaô file® Wå wilì describå ho÷ thió workó iî morå detaiì shortly. |
|||
:I |
|||
� Invokinç ZFILEÒ |
|||
|
|||
Sincå ZFILEÒ performó full-screeî operations¬ á propeò Z-Systeí � |
|||
terminaì descriptoò (TCAP© musô havå beeî loaded® Iæ yoõ havå noô donå � |
|||
that¬ oò iæ yoõ havå selecteä á terminaì thaô doeó noô supporô alì thå � |
|||
functionó ZFILEÒ needs¬ theî ZFILEÒ wilì givå yoõ aî erroò message® Thå � |
|||
TCAP¬ unfortunately¬ doeó noô includå informatioî abouô whetheò dií oò � |
|||
reverså videï ió useä bù thå terminal¬ anä sincå theså twï modeó foò � |
|||
highlightinç regionó oî thå screeî arå sï different¬ ZFILEÒ ió madå � |
|||
availablå iî separatå versionó foò each. |
|||
|
|||
Therå ió alsï aî optioî tï havå eitheò fouò oò fivå columnó oæ filå � |
|||
nameó iî thå display® Personally¬ É prefeò thå four-columî version¬ whicè � |
|||
giveó aî uncluttereä screeî witè plentù oæ restfuì whitå spacå anä á verù � |
|||
distinct¬ easy-to-spoô pointer® Otheró thinë iô ió morå importanô tï bå � |
|||
ablå tï seå thå maximuí numbeò oæ fileó oî eacè screeî anä prefeò thå five-� |
|||
columî display. |
|||
|
|||
Theî therå ió thå issuå oæ supporô foò timå anä datå stampinç oæ files® � |
|||
ZFILEÒ containó thå codå foò preservinç thå timå stampó wheî fileó arå � |
|||
copied® Sï aó noô tï inflicô thå overheaä oæ thió codå oî thoså whï havå � |
|||
noô implementeä DateStampeò (thougè theù shoulä dï that!)¬ ZFILEÒ ió alsï � |
|||
provideä iî versionó witè anä withouô thå DateStampeò code. |
|||
Iæ wå supporteä alì combinationó oæ thå abovå choices¬ therå woulä bå � |
|||
eighô differenô versionó oæ ZFILER® Typically¬ thå distributioî librarù � |
|||
containó fouò oò fivå oæ thå combinations® Foò example¬ á five-columî filå � |
|||
displaù ió noô particularlù compatiblå witè reverså videï highlighting¬ � |
|||
becauså thå reverså videï oæ taggeä fileó runó intï thå reverse-videï � |
|||
pointer. |
|||
|
|||
Wheî yoõ geô ZFILER¬ yoõ havå tï chooså whicè versioî yoõ prefer¬ � |
|||
extracô iô foò thå distributioî library¬ anä givå iô á workinç namå (somå oæ � |
|||
thå earlù Z-Systeí shelló haä tï havå á specifiã name¬ buô yoõ caî givå � |
|||
ZFILEÒ anù namå yoõ like)® É prefeò thå namå ZF¬ sincå iô ió verù quicë anä � |
|||
easù tï type¬ anä É wilì uså thaô namå iî alì thå exampleó thaô follow. |
|||
|
|||
Thå generaì syntaø foò invokinç ZFILEÒ is: |
|||
|
|||
ZÆ filespec |
|||
|
|||
wherå "filespec¢ ió á standarä Z-Systeí ambiguouó filå specificatioî (thaô � |
|||
is¬ iô maù contaiî thå wildcarä characteró "?¢ anä "*")® Thå filespeã � |
|||
selectó thå directorù areá anä thå fileó froí thaô areá tï bå includeä iî � |
|||
thå screeî display. |
|||
Variouó partó oæ thå filespeã caî bå omitted® Iæ nï filespeã ió giveî � |
|||
aô all¬ theî "*.*¢ foò thå currentlù loggeä directorù ió assumed® Similarly¬ � |
|||
iæ onlù á directorù ió specifieä (e.g.¬ Bº oò 3º oò B3º oò WORK:)¬ theî alì � |
|||
thå fileó ("*.*"© iî thaô directorù arå displayed® Iæ á filå name/typå ió � |
|||
included¬ theî iô wilì servå aó á masë oî thå fileó tï bå displayed® Thuó � |
|||
"ZÆ WORK:*.DOC¢ wilì sho÷ onlù fileó oæ typå DOÃ iî thå directorù WORK:. |
|||
|
|||
Thå directorù anä filå masë caî botè bå changeä froí inside‚ ZFILEÒ aó � |
|||
welì usinç thå "L¢ oò LOÇ command® É brinç thió uð no÷ becauså therå ió á � |
|||
confusinç differencå iî thå waù thå "L¢ commanä works® VFILEÒ originallù � |
|||
alloweä onå tï changå onlù thå directorù anä noô thå filå masë froí insidå � |
|||
thå program® Tï savå thå useò thå troublå oæ typinç thå coloî afteò á � |
|||
directory¬ itó inclusioî waó madå optional® Sincå useró becamå sï � |
|||
accustomeä tï thió shorthand¬ iô waó carrieä oveò intï ZFILER® Becauså oæ � |
|||
this¬ iæ yoõ wanô tï changå onlù thå filå mask¬ yoõ musô remembeò tï precedå � |
|||
iô witè á colon® Otherwiså youò masë wilì bå takeî aó thå namå oæ á � |
|||
directorù (whicè generallù resultó iî aî erroò message). |
|||
|
|||
Iô ió no÷ possiblå tï answeò ZFILER'ó "Logiî [DIR][:MASKÝ ¢ prompô witè � |
|||
".<cr>¢ (samå aó ":<cr>"© tï loç iî alì fileó iî thå currenô directory® � |
|||
Previouslù thió loggeä iî alì fileó aô useò zerï oæ thå currenô drive® Thå � |
|||
Logiî commanä no÷ alsï seemó tï accepô ".afn¢ insteaä oæ ":afn". |
|||
Onå brieæ asidå foò programmeò types® ZFILEÒ caî bå loadeä froí anù � |
|||
directory® Onå oæ thå speciaì featureó oæ Z-Systeí sincå versioî 3.³ oæ thå � |
|||
commanä processoò allowó á prograí tï finä ouô botè itó owî namå anä thå � |
|||
directorù froí whicè iô waó actuallù loaded¬ perhapó aó thå resulô oæ á patè � |
|||
search® ZFILEÒ buildó thå shelì stacë entrù tï invokå ZFILEÒ undeò itó � |
|||
currenô namå froí thå directorù iî whicè iô ió actuallù located® Thió � |
|||
sometimeó makeó iô ruî faster¬ anä iô allowó ZFILEÒ tï bå invokeä froí á � |
|||
directorù thaô ió noô oî thå searcè path. |
|||
:D |
|||
� Thå ZFILEÒ Displaù |
|||
|
|||
Thå maiî ZFILEÒ displaù containó threå parts® Aô thå toð oæ thå screeî � |
|||
therå ió á messagå line® Iî thå versioî oæ ZFILEÒ thaô ió currenô aô thå � |
|||
timå É aí writinç thió columî (versioî 1.0L)¬ thió linå contains¬ froí lefô � |
|||
tï right¬ thå followinç information: |
|||
|
|||
(1) thå directorù thaô haó beeî selected¬ iî botè DÕ anä DIÒ (nameä � |
|||
directory© format; |
|||
|
|||
(2) thå indicatoò "[PUBLIC]¢, iæ thaô directorù ió á ZRDOÓ publiã � |
|||
directorù (iæ yoõ don'ô kno÷ whaô thió is¬ jusô ignorå it); |
|||
|
|||
(3) thå currenô timå oæ daù iæ DateStampeò oò onå oæ thå ne÷ DOSó � |
|||
(ZSDOÓ oò ZDDOS© ió running; |
|||
|
|||
(4) thå program'ó officiaì namå anä version; |
|||
|
|||
(5) thå texô strinç "Currenô File:"; |
|||
|
|||
and (6) thå namå oæ thå filå currentlù beinç pointeä tï (thió changeó aó � |
|||
thå pointeò ió moved). |
|||
Aô thå bottoí oæ thå screeî ió á commanä prompô oæ thå form |
|||
|
|||
� Command¿ (/=Help¬ X=Quit)º |
|||
|
|||
Thå cursoò (don'ô confuså thió witè thå filå pointer© ió positioneä afteò � |
|||
thió commanä prompô tï indicatå thaô ZFILEÒ ió waitinç foò yoõ tï presó á � |
|||
key. |
|||
|
|||
Thå centeò 2° lineó oæ thå screeî sho÷ thå selecteä files® Thå � |
|||
characteò strinç "-->¢ (onlù "->¢ iî thå five-columî display© floató betweeî � |
|||
thå rowó oæ filå nameó anä designateó thå so-calleä "pointed-to¢ file® Manù � |
|||
oæ thå ZFILEÒ commandó automaticallù operatå oî thió file. |
|||
|
|||
Whaô wå havå describeä sï faò ió thå maiî ZFILEÒ screen¬ buô iô ió noô � |
|||
thå onlù one® Aó thå commanä prompô suggests¬ pressinç thå slasè characteò � |
|||
(oò "?¢ iæ yoõ prefer© bringó uð á helð screeî thaô summarizeó thå built-iî � |
|||
commandó oæ ZFILER® Thió helð screeî replaceó thå filå displaù buô leaveó � |
|||
thå statuó linå aô thå toð anä thå commanä linå aô thå bottom¬ excepô thaô � |
|||
"/=Help¢ changeó tï "/=Files"® Aó yoõ might¬ therefore¬ guess¬ pressinç � |
|||
slasè agaiî wilì takå yoõ bacë tï thå filå displaù screen. |
|||
É dï noô kno÷ iæ anyonå makeó uså oæ thió feature¬ buô alì ZFILEÒ � |
|||
commanä operationó caî bå invokeä froí thå helð screen® Althougè yoõ cannoô � |
|||
seå thå filå pointer¬ yoõ caî manipulatå iô iî thå usuaì way¬ anä yoõ caî � |
|||
telì whaô filå yoõ arå pointinç tï froí thå namå displayeä aô thå uppeò � |
|||
righô oî thå statuó line. |
|||
:C |
|||
� ZFILEÒ Commandó |
|||
|
|||
Basically¬ thå commandó falì intï severaì classes® Onå classificatioî � |
|||
reflectó wherå thå codå foò thå commanä resides® Therå arå twï categories: |
|||
|
|||
A® Built-Iî Commands |
|||
B® Macrï Commands |
|||
|
|||
Clasó Á includeó thå functionó foò whicè thå codå ió parô oæ ZFILER® � |
|||
Macrï commandó arå likå aliaseó iî thaô theù generatå commanä lineó thaô arå � |
|||
passeä tï thå commanä processoò foò execution® Theså commandó makå ZFILEÒ á � |
|||
shell®� |
|||
|
|||
Á seconä classificatioî dependó oî whaô thå commanä actó upon® Threå � |
|||
categorieó describå thå objecô oæ thå commands: |
|||
|
|||
1® thå pointed-tï file |
|||
2® á grouð oæ taggeä files |
|||
3® neitheò oæ thå above |
|||
|
|||
Helð foò commandó iî clasó A3¬ residenô commandó thaô dï noô perforí � |
|||
anù actioî oî thå files¬ maù bå founä bù selectinç � Ð ‚ froí thå maiî menu® � |
|||
Help for the others may be found by selecting N . |
|||
:P |
|||
� Pointeò Commandó |
|||
|
|||
Clasó A³ includeó thå commandó thaô movå thå filå pointer® Theså arå � |
|||
showî oî thå helð screen¬ anä É wilì noô lisô theí here® Onå caî movå thå � |
|||
pointeò tï thå nexô filå oî thå screeî oò tï thå previouó onå (witè � |
|||
wraparound)» up¬ down¬ left¬ oò righô (witè wraparound)» tï thå firsô oò � |
|||
lasô filå oî thå currenô screen» oò tï thå verù firsô oò verù lasô filå oæ � |
|||
thoså selecteä bù thå filå mask® Onå caî advancå tï thå nexô screeî oæ � |
|||
fileó oò tï thå previouó screen® Obviously¬ somå oæ theså functionó wilì bå � |
|||
redundanô iî somå cases¬ sucè aó wheî alì thå selecteä fileó caî fiô oî onå � |
|||
screeî (thinë whaô happenó wheî therå ió exactlù onå filå selected). |
|||
|
|||
ZFILEÒ learnó froí thå TCAÐ thå controì characteró senô bù anù speciaì � |
|||
cursoò keyó oî thå keyboarä (provideä theù senä á singlå controì characteò � |
|||
anä provideä thå TCAÐ haó beeî seô uð correctly)¬ anä iô makeó theí generatå � |
|||
thå up¬ down¬ left¬ anä righô functions® Iæ thå cursoò keyó generatå � |
|||
controì codeó normallù useä foò anotheò function¬ theî thaô functioî wilì bå � |
|||
losô (thå cursoò keyó takå precedence)® Thaô caî causå problems® Onå � |
|||
solutioî ió tï eliminatå thå definitioî oæ thå cursoò keyó iî thå TCAÐ anä � |
|||
simplù uså thå defaulô WordStaò diamonä keyó foò thoså functions® �ŠAlternatively¬ onå caî patcè ZFILEÒ tï uså differenô keyó foò itó owî � |
|||
functions¬ buô thió ió noô straightforwarä tï do¬ anä É wilì noô describå iô � |
|||
here. |
|||
Thå "J¢ (Jump© commanä allowó yoõ tï jumð tï á filå thaô yoõ name® Thió � |
|||
ió verù handù wheî therå arå manù fileó iî thå displaù oò wheî thå filå yoõ � |
|||
wanô ió noô oî thå currenô screen® Presó thå "J¢ key¬ anä yoõ wilì bå � |
|||
prompteä foò á filå name® Yoõ dï noô havå tï enteò thå exacô name® ZFILEÒ � |
|||
automaticallù convertó whaô yoõ typå intï á wildcarä filespec¬ anä iô findó � |
|||
thå firsô filå thaô matches® Foò example¬ iæ yoõ enteò onlù "Z¢ followeä bù � |
|||
á return¬ thió ió equivalenô tï "Z*.*"¬ anä ZFILEÒ wilì movå thå pointeò tï � |
|||
thå firsô filå thaô startó witè á "Z"® Similarly¬ iæ yoõ enteò ".D"¬ ZFILEÒ � |
|||
wilì movå tï thå firsô filå witè á filå typå thaô startó witè "D". |
|||
|
|||
Thå "J¢ functioî ió verù handy» however¬ therå ió more® Manù peoplå � |
|||
arå noô awarå thaô yoõ maù presó control-Ê tï repeaô thå samå searcè anä � |
|||
finä thå nexô matchinç file® Thå searcè wilì wrað arounä froí thå enä oæ � |
|||
thå fileó bacë tï thå beginning® Thió functioî ió noô listeä oî thå helð � |
|||
screeî becauså É coulä noô finä rooí foò it. |
|||
|
|||
Control-É (TAB© ió aî aliaó foò control-Ê (jumð tï filå again)¬ foò uså � |
|||
witè terminaì definitionó (TCAPs© whicè definå control-Ê aó aî arro÷ key. |
|||
:N |
|||
� Otheò Non-Filå Commandó |
|||
|
|||
Somå otheò commandó thaô dï noô acô oî fileó areº X¬ L¬ A¬ S¬ E¬ H¬ Z¬ � |
|||
anä O® "X"¬ aó thå commanä prompô remindó you¬ ió useä tï exiô froí ZFILER® � |
|||
Besideó terminatinç thå currenô executioî oæ thå program¬ iô alsï removeó � |
|||
ZFILER'ó entrù iî thå shelì stacë (iæ iô diä not¬ yoõ woulä jusô reenteò iô � |
|||
righô away). |
|||
|
|||
Wå alreadù spokå abouô thå "L¢ (Log© commanä earlier® Thå "A¢ � |
|||
(Alphabetizå oò Arrangå oò Alphá sort© toggleó thå waù iî whicè thå fileó � |
|||
arå sorted¬ namelù alphabeticallù bù thå filå namå oò bù thå filå type® � |
|||
Thå "S¢ (Status© commanä promptó yoõ foò á disë drivå letteò anä theî telló � |
|||
yoõ thå amounô oæ spacå remaininç oî thaô disk. |
|||
|
|||
Thå "E¢ commanä (refresè scrEEî -- É kno÷ that'ó stretchinç things¬ buô � |
|||
"R¢ waó alreadù used© redrawó thå screen® Yoõ mighô thinë thaô thió woulä � |
|||
neveò bå needed¬ buô therå arå twï circumstanceó iî whicè iô comeó iî verù � |
|||
handy® Onå ió wheî ZFILEÒ ió beinç useä oî á remotå system® Iô ió truå � |
|||
thaô verù fe÷ RASó makå ZFILEÒ available¬ buô É dï oî Z-Nodå #3® Iæ yoõ geô � |
|||
somå linå noise¬ thå screeî caî becomå garbled® Theî thå "E¢ keù caî bå � |
|||
useä tï dra÷ á fresè screen. |
|||
Thå otheò circumstancå iî whicè thå "E¢ commanä saveó thå daù ió witè � |
|||
Backgrounder-ié iæ yoõ dï noô havå á screeî driveò (É don'ô foò mù Concepô � |
|||
10¸ terminaì -- neveò goô arounä tï writinç one¬ partlù becauså alì thå � |
|||
programó É uså frequentlù havå á redra÷ keù likå thió one)® É simplù definå � |
|||
á BGié keù macrï specifyinç "E¢ aó thå "redraw¢ key¬ savå thå keù � |
|||
definitionó tï ZFILER.BG¬ anä attacè thaô definitioî tï ZF.COM® Theî � |
|||
wheneveò É swað taskó bacë intï ZFILER¬ BGié simulateó mù pressinç thå "E¢ � |
|||
key¬ anä thå screeî ió redrawn® Thió ofteî giveó á fasteò screeî refresè � |
|||
thaî onå getó witè á full-fledgeä screeî driver. |
|||
|
|||
Thå "H¢ (Help© commanä generateó á macrï commanä tï invokå thå Z-Systeí � |
|||
HELÐ facility® Tï telì thå truth¬ É havå noô useä thió anä don'ô eveî � |
|||
remembeò preciselù whaô iô does® É woulä havå tï looë aô thå sourcå code. |
|||
Thå "Z¢ (Z-system© commanä promptó yoõ foò á command¬ anä whateveò yoõ � |
|||
enteò ió passeä oî tï thå Z-Systeí multiplå commanä linå buffeò foò � |
|||
execution® Wheî thaô commanä linå ió complete¬ ZFILEÒ ió reinvokeä � |
|||
automatically. |
|||
|
|||
Wheî yoõ uså thå "Z¢ command¬ yoõ wilì normallù bå loggeä intï thå � |
|||
directorù thaô ió currentlù displayed® However¬ thió wilì noô alwayó bå � |
|||
possible® ZFILEÒ allowó yoõ tï selecô directorieó witè useò numberó froí ° � |
|||
tï 31® Unlesó yoõ arå usinç á versioî oæ ZCPR3³ oò ZCPR3´ witè thå HIGHUSEÒ � |
|||
optioî enabled¬ yoõ cannoô loç intï useò areaó abovå 15® Iî thaô caså � |
|||
ZFILEÒ wilì puô yoõ iî thå directorù youò werå iî wheî yoõ invokeä ZFILER® � |
|||
Iî anù case¬ thå commanä prompô wilì indicatå thå directorù froí whicè youò � |
|||
commanä linå wilì bå executed. |
|||
Sincå commandó yoõ ruî usinç thå "Z¢ functioî maù puô somå informatioî � |
|||
oî thå screeî thaô yoõ woulä noô wanô ZFILEÒ tï obliteratå immediately¬ � |
|||
therå ió á flaç seô thaô signaló ZFILEÒ tï prompô yoõ anä tï waiô foò yoõ tï � |
|||
presó á keù beforå puttinç uð itó display® Herå ió á tið foò advanceä � |
|||
users® Iæ yoõ enteò youò commanä linå witè onå oò morå leadinç spaces¬ thió � |
|||
shell-waiô flaç wilì noô bå set¬ anä ZFILEÒ wilì returî withouô youò havinç � |
|||
tï presó á key® Thå leadinç spaceó arå strippeä froí thå commanä linå � |
|||
beforå iô ió passeä tï thå commanä processor® Thió meanó thaô yoõ cannoô � |
|||
uså á leadinç spacå tï forcå invocatioî oæ thå extendeä commanä processoò � |
|||
(ECP)» yoõ havå tï uså thå slasè prefiø instead® Á spacå anä á slasè wilì � |
|||
forcå invocatioî oæ thå ECÐ anä wilì disablå thå shell-waiô flag. |
|||
|
|||
Thå finaì commanä iî clasó A³ ió thå "O¢ (Options© command® � |
|||
Informatioî regarding it can be found in the O menu.� |
|||
:S |
|||
� Single-Filå Built-Iî Functionó |
|||
|
|||
No÷ let'ó discusó thå commandó iî clasó A1¬ thå built-iî commandó thaô � |
|||
acô oî thå pointed-tï file® Theså arå invokeä bù pressinç onå oæ thå � |
|||
followinç keys¬ whoså meaninç ió indicateä iî parenthesesº Ã (Copy)¬ Í � |
|||
(Move)¬ Ä (Delete)¬ Ò (Rename)¬ Ö (View)¬ Ð (Print)¬ Æ (Filå size)¬ Ô (Tag)¬ � |
|||
anä Õ (Untag)® Somå oæ theså arå self-explanatory¬ anä É wilì noô discusó � |
|||
them. |
|||
Thå "C¢ commanä copieó á filå tï anotheò directorù undeò thå samå name» � |
|||
iô doeó noô allo÷ onå tï givå á ne÷ namå foò thå destinatioî filå (however¬ � |
|||
yoõ caî dï thaô witè á macrï command)® Thå "M¢ commanä doeó noô reallù movå � |
|||
á file» iô copieó thå filå anä then¬ iæ thå copù waó successful¬ deleteó thå � |
|||
originaì file® Iô ió reallù á combinatioî oæ "C¢ anä "D"® Movinç á filå � |
|||
thió waù ió inefficienô iæ thå destinatioî directorù ió oî thå samå drivå aó � |
|||
thå sourcå file® Á macrï commanä thaô invokeó aî ARUNÚ aliaó caî geô arounä � |
|||
thió limitatioî (anä almosô alì otheò ZFILEÒ limitations). |
|||
|
|||
Thå "V¢ (View© anä "P¢ (Print© commandó no÷ havå á switchablå filteò � |
|||
whicè onlù passeó printablå characters¬ carriagå return¬ anä linå feeds. |
|||
Thå taç anä untaç commandó arå useä tï selecô á grouð oæ fileó oî whicè � |
|||
operationó caî bå performed® Taggeä fileó arå indicateä iî twï ways® Á � |
|||
speciaì characteò ("#"© ió placeä afteò thå filå namå iî thå display¬ and¬ � |
|||
iæ thå terminaì supportó videï highlighting¬ thå filå ió highlighted. |
|||
|
|||
Twï relateä commandó arå × (Wilä tag© anä Ù (Yanë back?)® "W¢ allowó � |
|||
yoõ tï taç oò untaç groupó oæ fileó designateä bù aî ambiguouó filå spec® � |
|||
Afteò taggeä fileó arå operateä oî bù thå built-iî grouð commandó describeä � |
|||
below¬ thå taç markeò "#¢ ió changeä tï "'¢ (á sofô tag)® Thå "Y¢ commanä � |
|||
changeó thå sofô tagó bacë intï harä tagó sï thaô furtheò grouð operationó � |
|||
caî bå performeä oî thoså files. |
|||
|
|||
ZFILEÒ no÷ rememberó alì thå filå tagó wheî iô returnó froí á macrï oò � |
|||
Ú commanä (iô writeó á temporarù file¬ ZFILER.TAG¬ tï á configurablå � |
|||
directorù whicè containó thå filå list). |
|||
:G |
|||
� Built-Iî Grouð Commandó |
|||
|
|||
Grouð commandó arå initiateä bù pressinç thå "G¢ (Group© key® Thå � |
|||
commanä prompô aô thå bottoí oæ thå screeî changeó to |
|||
|
|||
� Command¿ (/=Help¬ X=Quit© ‚ Groupº (A,C,D,F,M,P,R,T,U,V) |
|||
|
|||
Foò no÷ wå wilì consideò onlù thå built-iî grouð functionó (clasó A2© anä � |
|||
wilì takå uð grouð macrï commandó (clasó B2© nexô time. |
|||
|
|||
Excepô foò thå fouò functionó describeä below¬ thå letteró invokå thå � |
|||
samå actioî aó thå individuaì commanä correspondinç tï thaô letter¬ buô thå � |
|||
functioî ió performeä oî alì thå taggeä files® Wå wilì noô discusó thoså � |
|||
further® Notå iî particulaò thaô thå keyó "A¢ anä "R"¬ however¬ havå á � |
|||
grouð functioî thaô ió completelù differenô froí thå individuaì function. |
|||
Thå "U¢ anä "T¢ grouð functionó dï noô acô oî thå taggeä files» theù � |
|||
changå thå tagging® Thå formeò untagó alì files» thå latteò tagó theí all. |
|||
|
|||
Grouð Tag/Untaç anä Wilä Taç caî bå independentlù seô tï operatå froí � |
|||
thå filå pointeò tï thå enä oæ thå ring¬ ratheò thaî oî thå entirå ring® � |
|||
Grouð Tag/Untaç seeí tï bå thå mosô usefuì iæ aô thå starô aô thå filå � |
|||
pointer® Uså thå Optionó commanä tï controì this. |
|||
|
|||
Thå "R¢ grouð functioî ió anotheò onå thaô doeó not¬ strictlù speaking¬ � |
|||
acô oî thå taggeä files® Iô reverseó thå tags¬ tagginç thå fileó thaô haä � |
|||
beeî untaggeä anä untagginç thå oneó thaô haä beeî tagged® Thió caî bå verù � |
|||
handù iî severaì circumstances® Foò example¬ yoõ mighô wanô tï copù alì thå � |
|||
fileó excepô two® Iô ió easieò tï taç thoså twï anä theî tï reverså thå � |
|||
tags® Aó anotheò example¬ yoõ mighô wanô tï copù somå oæ thå displayeä � |
|||
fileó tï onå diskettå anä thå otheró tï á seconä diskette® É dï thió � |
|||
frequently® É begiî bù tagginç thå oneó tï gï tï thå firsô diskette® Theî � |
|||
É grouð copù ("GC"© theí tï thå destinatioî diskette® Next¬ É yanë bacë thå � |
|||
tagó usinç thå "Y¢ commanä anä theî reverså thå tagó witè "GR"® No÷ É caî � |
|||
grouð copù thå resô tï thå seconä diskette. |
|||
Thå "A¢ (Archive© grouð commanä ió verù handù foò automatinç backups® � |
|||
Wheî iô ió entered¬ thå tagó arå removeä froí anù taggeä filå whoså archivå � |
|||
flaç ió set® Aó á result¬ onlù fileó thaô havå beeî modifieä sincå thå flaç � |
|||
waó lasô seô wilì remaiî tagged® Iî addition¬ thå "A¢ grouð commanä � |
|||
automaticallù initiateó á grouð copù operatioî buô witè onå speciaì feature® � |
|||
Afteò thå filå haó beeî copieä successfully¬ thå archivå flaç oî thå sourcå � |
|||
filå ió seô tï indicatå thaô thå filå haó beeî backeä up. |
|||
|
|||
Undeò lateò versionó oæ VFILER¬ thå grouð "A¢ commanä automaticallù � |
|||
taggeä alì unarchiveä files» undeò ZFILEÒ iô untagó thå archiveä ones® Thió � |
|||
differencå ió verù important® Witè VFILER¬ yoõ werå forceä tï bacë uð alì � |
|||
thå fileó selecteä bù thå VFILEÒ filå mask® Undeò ZFILEÒ yoõ caî selecô thå � |
|||
fileó thaô wilì bå candidateó foò backinç up® Iæ yoõ wanô thå achievå thå � |
|||
samå functioî aó undeò VFILER¬ jusô taç alì thå fileó firsô witè "GT¢ anä � |
|||
theî archivå theí witè "GA"® Oî thå otheò hand¬ iæ yoõ wanô tï exludå BAË � |
|||
fileó froí thå backup¬ yoõ caî "GT¢ alì files¬ untaç thå "*.BAK¢ fileó usinç � |
|||
thå "W¢ command¬ anä theî uså thå "GA¢ command. |
|||
Afteò yoõ enteò thå commanä "GA"¬ yoõ wilì bå prompteä foò á � |
|||
destinatioî directory® Yoõ dï noô havå tï supplù one¡ Iæ yoõ simplù enteò � |
|||
á carriagå return¬ thå copù operatioî wilì bå skipped¬ anä yoõ wilì bå lefô � |
|||
witè tagó oî thå fileó thaô neeä tï bå backeä up® Yoõ caî theî uså á macrï � |
|||
functioî tï bacë theí uð iî á specializeä way¬ sucè aó crunchinç � |
|||
(compressing© theí tï thå backuð disë (insteaä oæ copyinç theí aó theù are© � |
|||
oò puttinç theí intï á librarù oî thå backuð diskette® Thå macrï techniqueó � |
|||
requireä tï dï thió arå iî thå FILEÒ Scripô Macrï Facility‚ section. |
|||
:O |
|||
� Thå Optioî Commanä |
|||
|
|||
Wheî thå optioî commanä letteò "O¢ ió pressed¬ á speciaì optionó screeî � |
|||
ió displayed® Eleveî operatinç characteristicó caî bå changeä froí á menõ � |
|||
witè thå followinç appearancå (approximately): |
|||
|
|||
A® singlå replacå querù Y |
|||
B® grouð replacå querù Y |
|||
C® archivå replacå querù N |
|||
D® verifù querù Y |
|||
E® verifù defaulô Y |
|||
F® suppresó SYÓ fileó Y |
|||
G® sorô bù filå namå N |
|||
H® seô copieä filå attributeó Y |
|||
I® uså desô filå attributeó Y |
|||
J® archivå destinatioî Y |
|||
K® searcè patè foò CMÄ filå N |
|||
Wå wilì explaiî thå meaninç oæ eacè oæ theså optionó iî á moment® � |
|||
Firsô á fe÷ wordó abouô thå mechanics® Whilå thå optionó menõ ió displayed¬ � |
|||
pressinç thå indeø letteò aô thå lefô wilì causå thå settinç oæ thå � |
|||
correspondinç optioî tï bå toggled¬ anä thå ne÷ statå wilì bå showî iî thå � |
|||
columî aô thå right® Thå listinç abovå showó thå initiaì statå oæ thå � |
|||
optionó iî mù personaì versioî oæ ZFILER® Wheî yoõ arå finisheä togglinç � |
|||
options¬ jusô presó carriagå returî tï returî tï thå maiî ZFILEÒ menu® Theså � |
|||
optioî settingó arå storeä iî thå ZFILEÒ shelì stacë entrù anä wilì thuó � |
|||
continuå iî effecô througè alì ZFILEÒ operationó untiì thå commanä "X¢ ió � |
|||
useä tï terminatå thå shell. |
|||
|
|||
Thå firsô threå optionó concerî ho÷ ZFILEÒ respondó wheî copyinç (oò � |
|||
moving© fileó anä á filå oæ thå samå namå alreadù existó iî thå destinatioî � |
|||
directory® Iteí Á applieó wheî individuaì fileó arå copieä (commandó "C¢ � |
|||
anä "M")» iteí Â applieó wheî á grouð copù ió performeä (commandó "GC¢ anä � |
|||
"GM")» anä iteí Ã applieó wheî performinç aî archivinç operatioî (commanä � |
|||
"GA")® Iæ thå optioî ió "YES"¬ theî ZFILEÒ wilì prompô onå beforå existinç � |
|||
fileó arå eraseä anä givå onå thå chancå tï canceì thå operatioî foò thaô � |
|||
file¬ leavinç thå existinç filå intact® Iæ thå optioî ió toggleä tï "NO"¬ � |
|||
theî existinç fileó wilì bå overwritteî withouô eveî á message. |
|||
Thå nexô twï optionó affecô thå verificatioî oæ thå copieä filå iî thå � |
|||
destinatioî directory® Iteí Ä determineó whetheò oò noô thå useò wilì bå � |
|||
askeä abouô verification® Iæ thió optioî ió seô tï "N"¬ theî thå statå oæ � |
|||
optioî Å wilì determinå whetheò oò noô verificatioî ió performeä oî filå � |
|||
copies® Iæ thió optioî ió seô tï "Y"¬ theî beforå eacè copy¬ move¬ grouð � |
|||
copy¬ oò grouð move¬ ZFILEÒ wilì puô uð thå prompô "Verifù (Y/N)?". |
|||
|
|||
Thå nexô twï optionó affecô thå waù fileó arå displayeä oî thå screen® � |
|||
Iæ iteí Æ ió seô tï "Y"¬ theî fileó witè thå "system¢ oò SYÓ attributå wilì � |
|||
bå suppressed¬ thaô is¬ noô includeä amonç thå selecteä fileó oî whicè � |
|||
ZFILEÒ acts® Thió ió á reasonablå choicå foò thió option¬ sincå thå mosô � |
|||
commoî uså oæ thå SYÓ attributå ió tï makå thå fileó disappeaò froí � |
|||
consideratioî durinç filå maintenancå anä displaù operations® Iteí Ç oî thå � |
|||
optionó menõ determineó whetheò fileó arå sorteä firsô bù namå anä theî bù � |
|||
typå oò vicå versa® Changinç thió optioî ió presentlù equivalenô tï thå "A¢ � |
|||
commanä froí thå maiî ZFILEÒ commanä menu. |
|||
Thå nexô threå optionó concerî ho÷ filå attributeó arå treateä wheî � |
|||
fileó arå copied® Onå possibilitù ió tï creatå ne÷ fileó witè á cleaî slatå � |
|||
oæ attributeó (thaô is¬ alì attributeó resetº noô read-only¬ noô SYS¬ noô � |
|||
archived)® Thió ió whaô wilì happeî wheî optioî È ió seô tï "N¢ (buô notå � |
|||
optioî J¬ whicè maù overridå this)® Wheî thå attributeó oæ thå destinatioî � |
|||
filå arå tï bå set¬ theù caî bå seô iî twï possiblå ways® Iæ á filå oæ thå � |
|||
samå namå existeä iî thå destinatioî directory¬ theî itó filå attributeó � |
|||
coulä bå useä foò thå copù thaô replaceó it® Thió ió whaô wilì bå donå iæ � |
|||
optioî É ió seô tï "Y"® Iæ optioî É ió seô tï "N¢ oò iæ therå waó nï � |
|||
matchinç filå iî thå destinatioî directory¬ theî thå attributeó wilì bå seô � |
|||
tï matcè thoså oæ thå sourcå file. |
|||
Optioî Ê caî seô á speciaì overridå foò thå archivå oò ARÃ attribute® � |
|||
Iæ thå optioî ió seô tï "N"¬ theî thå ARÃ attributå ió treateä jusô likå thå � |
|||
otheò attributeó accordinç tï optionó È anä I® Iæ optioî Ê ió seô tï YES¬ � |
|||
theî thå destinatioî filå alwayó haó itó ARÃ attributå set. |
|||
|
|||
Therå waó aô onå timå á greaô deaì oæ controversù oveò thå waù thå ARÃ � |
|||
attributå ió handleä undeò ZFILER® Aô onå timå iô waó alwayó reset¬ sï thaô � |
|||
thå destinatioî filå woulä bå markeä aó noô backeä up® Anotheò schooì oæ � |
|||
thoughô asserteä that¬ oî thå contrary¬ thå filå waó backeä up¬ sincå therå � |
|||
waó á copù oæ iô oî thå sourcå disë froí whicè thå filå waó copied® Thaô � |
|||
latteò argumenô madå considerablå senså iî thå caså oæ copyinç fileó froí á � |
|||
masteò disë tï á RAÍ disë beforå á worë session® Herå iô waó certainlù � |
|||
importanô tï starô witè alì fileó markeä witè thå ARÃ attributå sï thaô onå � |
|||
coulä easilù telì aô thå enä oæ thå sessioî whicè fileó haä beeî modifieä sï � |
|||
thaô theù coulä bå copieä bacë tï thå permanenô storagå medium. |
|||
|
|||
Alì iî all¬ É neveò understooä thió controversy® Botè approacheó � |
|||
clearlù havå merit¬ anä sincå ZFILEÒ supportó both¬ É sa÷ nï reasoî foò alì � |
|||
thå argument® Iî á futurå versioî oæ ZFILER¬ É thinë É woulä likå tï adä á � |
|||
flaç worä thaô woulä indicatå whicè driveó shoulä automaticallù seô thå ARÃ � |
|||
flaç wheî thå Ê optioî ió seô tï YES® Thaô way¬ thå optioî coulä bå madå tï � |
|||
applù tï RAÍ driveó only. |
|||
Thå finaì iteí oî thå optioî menu¬ optioî K¬ determineó ho÷ thå macrï � |
|||
commanä filå ZFILER.CMÄ (seå discussioî below© wilì bå located® Therå arå � |
|||
twï choices® Iæ optioî Ë ió seô tï YES¬ theî ZFILEÒ wilì looë foò iô firsô � |
|||
iî thå currentlù displayeä directorù anä theî alonç thå entirå ZCPR³ searcè � |
|||
path® Thió optioî ió usefuì iæ onå wantó tï havå differenô macrï commanä � |
|||
fileó thaô applù tï specifiã directorù areas® Alternatively¬ iæ optioî Ë ió � |
|||
seô tï NO¬ theî ZFILEÒ locateó thå CMÄ filå withouô usinç thå path® � |
|||
Dependinç oî ho÷ ZFILEÒ ió configureä (thió wilì bå discusseä anotheò time)¬ � |
|||
thå filå wilì bå soughô eitheò iî thå rooô directorù oæ thå patè (thå lasô � |
|||
directorù specifieä oî thå searcè path© oò iî á specifiã drive/useò areá � |
|||
codeä intï ZF.COM® Thió alternativå resultó iî fasteò operation¬ especiallù � |
|||
iæ thå specifieä directorù resideó oî á RAÍ disk. |
|||
|
|||
Thå optionó controlleä bù thå optioî menõ caî alsï bå permanentlù � |
|||
changeä iî thå ZFILEÒ prograí filå usinç á patchinç utilitù likå ZPATCH® Iî � |
|||
thå firsô pagå oæ thå file¬ yoõ wilì seå thå ascié strinç "OPT:"® Thå � |
|||
eleveî byteó followinç thió strinç contaiî thå startuð valueó foò thå eleveî � |
|||
options® Patcè á bytå tï 0° foò NÏ oò FÆ foò YES. |
|||
|
|||
Onå maù alsï uså Aì Hawley'ó Zconfig¬ alonç witè thå .CFÇ filå provideä � |
|||
witè youò copù oæ ZFILER¬ iî ordeò tï instalì ZFILER tï youò tastes® � |
|||
Handleó alì thå configuratioî normallù needed® Yoõ maù alsï uså á filå � |
|||
patcheò tï changå thå defaulô nameó oæ somå oæ ZFILER'ó temporarù fileó, iæ � |
|||
yoõ wish. |
|||
:M:ZFMACRO |
|||
:H:ZFHIST |
|||
:J |
|||
� Creditó |
|||
|
|||
Thió documenô containó thå texô oæ twï articleó oî ZFILEÒ bù Jaù Sagå � |
|||
whicè originallù appeareä iî Thå Computeò Journaì issueó #3¶ anä #37® � |
|||
Reprinteä witè permissioî oæ thå publisher: |
|||
|
|||
Thå Computeò Journal |
|||
P.O® Boø 12 |
|||
S® Plainfield¬ NÊ 07080-0012 |
|||
|
|||
Theså .HLÐ fileó foò ZFILEÒ werå editeä bù Leï M® Cavanaugè IIÉ froí � |
|||
thå documentatioî provideä witè ZFILER. |
|||
|
|||
@ -0,0 +1,409 @@ |
|||
; ---------------------------------- |
|||
| | |
|||
| ZFILER's Script Macro Facility | |
|||
| | |
|||
---------------------------------- |
|||
|
|||
|
|||
M >> Introduction to ZFILEÒ's Macros |
|||
|
|||
|
|||
<< Macro Execution >> << Macro Writing >> |
|||
|
|||
I >> Invokinç Macros S >> Macrï Scripts |
|||
G >> Group Macros D >> Defininç Macroó -- Thå CMÄ File |
|||
R >> Ruleó foò Scripô Expansion |
|||
E >> Macrï Examples |
|||
L >> Sample Macro CMD Listing |
|||
:M |
|||
Introduction to ZFILEÒ's Macros |
|||
|
|||
Althougè ZFILEÒ caî accomplisè manù taskó usinç itó built-iî functions¬ � |
|||
itó reaì poweò comeó froí thå macrï facility¬ whicè allowó iô tï bå extendeä � |
|||
tï includå anù functionó thaô caî bå performeä usinç combinationó oæ otheò � |
|||
programs® Thió ió wherå ZFILEÒ reallù makeó uså oæ itó poweò aó á shell® � |
|||
Firsô É wilì describå ho÷ thå macrï facilitù ió used¬ anä theî É wilì � |
|||
describå ho÷ thå useò defineó thå macrï functions® Aó witè thå built-iî � |
|||
functions¬ macrï functionó caî operatå eitheò oî singlå fileó oò oî groupó � |
|||
oæ files® Thå single-filå macrï facilitù ió welì developeä anä waó alreadù � |
|||
presenô iî nearlù thå samå forí iî VFILER» thå grouð macrï facilitù ió ne÷ � |
|||
witè ZFILEÒ and has been greatly expanded. |
|||
:I |
|||
Invokinç Macros |
|||
|
|||
Onå waù tï initiatå á macrï operatioî oî thå pointed-tï filå ió tï � |
|||
presó thå macrï invocatioî key¬ whicè ió normallù thå escapå key® Á prompô � |
|||
oæ "Macro:¢ wilì appeaò afteò thå normaì ZFILEÒ commanä prompt® Aô thió � |
|||
poinô yoõ havå severaì choices® Iæ yoõ kno÷ thå keù correspondinç tï thå � |
|||
macrï yoõ wanô tï run¬ theî yoõ caî simplù presó thaô key® ZFILEÒ wilì theî � |
|||
construcô á commanä linå anä pasó iô oî tï thå commanä processoò foò � |
|||
execution® Iæ ZFILEÒ ió configureä foò instanô macrï operatioî (iô � |
|||
generallù is)¬ theî macroó associateä witè thå numbeò keyó "0¢ througè "9¢ � |
|||
caî bå initiateä withouô thå macrï invocatioî key» thaô is¬ thå numbeò keù � |
|||
entereä alonå aô thå maiî ZFILEÒ commanä prompô wilì generatå thå macrï � |
|||
function. |
|||
|
|||
Iæ yoõ presó thå macrï invocatioî keù á seconä time¬ á user-createä helð � |
|||
screeî wilì bå displayed® Thió screeî generallù listó thå availablå macrï � |
|||
functions® Yoõ caî no÷ presó thå keù foò thå desireä function¬ oò yoõ caî � |
|||
presó carriagå returî tï canceì thå macrï operatioî anä returî tï thå maiî � |
|||
ZFILEÒ menu® Thå helð menõ screeî wilì alsï bå displayeä iæ yoõ presó thå �Š"#¢ key® Thió ió á holdoveò froí VFILEÒ anä ariseó iî parô becauså oæ thå � |
|||
structurå oæ thå filå iî whicè thå macroó arå defineä (morå oî thió � |
|||
shortly). |
|||
:G |
|||
Group Macros |
|||
|
|||
Grouð macroó arå invokeä iî á similaò waù froí thå grouð functioî � |
|||
commanä line® Afteò yoõ havå taggeä á grouð oæ files¬ presó thå "G¢ keù tï � |
|||
enteò grouð mode® Thå prompô wilì lisô onlù thå built-iî grouð functions¬ � |
|||
buô iæ yoõ presó thå macrï invocatioî key¬ yoõ caî proceeä aó describeä � |
|||
abovå foò single-filå macrï operations¬ excepô thaô thå macrï functioî wilì � |
|||
bå performeä oî eacè oæ thå taggeä files. |
|||
|
|||
Thå grouð macrï facilitù workó á littlå differentlù thaî thå single-� |
|||
filå macrï facility® Sincå thå commanä linå woulä generallù noô bå lonç � |
|||
enougè tï contaiî thå commandó foò alì thå taggeä files¬ thå grouð macrï � |
|||
facilitù workó bù writinç ouô á batcè filå foò processinç bù ZEØ oò SUBMIT® � |
|||
Iî thió waù therå ió virtuallù nï limiô tï thå numbeò oæ fileó oî whicè � |
|||
grouð macroó caî operate. |
|||
Therå arå manù configurablå optionó (describeä below© thaô arå associateä � |
|||
witè thå grouð macrï operation® Theså includå thå namå oæ thå ZEØ oò SUÂ � |
|||
batcè file¬ thå directorù tï whicè iô ió written¬ anä thå commanä linå thaô � |
|||
ZFILEÒ generateó tï initiatå thå batcè operation® Thå NZ-COÍ versioî oæ � |
|||
ZFILEÒ useó á filå calleä ZFILER.ZEØ anä thå commanä linå "ZEØ ZFILER"® Thå � |
|||
Z3PLUÓ version¬ undeò whicè ZEØ wilì noô run¬ useó á filå calleä ZFILER.SUÂ � |
|||
anä á commanä linå oæ "SUBMIÔ ZFILER". |
|||
|
|||
Sincå macroó (anä thå maiî menõ "Z¢ function© worë bù passinç commandó � |
|||
tï thå commanä processor¬ filå tagó werå oncå losô bù oldeò versionó oæ � |
|||
ZFILER» wheî theså oldeò versionó resumeä operation¬ thå procesó starteä � |
|||
afresh® ZFILEÒ no÷ rememberó alì thå filå tagó wheî iô returnó froí á macrï � |
|||
oò Ú commanä (iô writeó á temporarù file¬ "ZFILER.TAG"¬ tï á configurablå � |
|||
directorù whicè containó thå filå list). |
|||
List Capability for Group Macros |
|||
|
|||
Iæ á ZFILER.CMÄ scripô beginó witè á commá (beforå oò afteò thå leadinç � |
|||
"!¢ shelì pauså parameter)¬ ZFILEÒ wilì alwayó expanä thå macrï directlù tï � |
|||
ZCPR'ó multiplå commanä line® Iî thå caså oæ á grouð macro¬ $P¬ $F¬ anä $Ô � |
|||
parameteró arå expandeä tï á lisô oæ alì taggeä files¬ separateä bù thå � |
|||
characteò followinç thå leadinç comma® |
|||
|
|||
For example, the script: |
|||
|
|||
1 , !echo the tagged files are $F |
|||
|
|||
displayó "THÅ TAGGEÄ FILEÓ ARÅ "¬ followeä bù á lisô oæ thå taggeä fileó � |
|||
separateä bù ¢ ¢ oî thå consolå (assuminç ECHÏ ió á valiä ZCPÒ command)® � |
|||
ZFILEÒ theî promptó foò á keypresó beforå returning® Pleaså notå thaô thió � |
|||
macrï bufferó thå entirå lisô oæ taggeä fileó tï CP/M'ó commanä linå buffer¬ � |
|||
whicè ió onlù 12µ byteó iî length® Thå abovå command¬ therefore¬ normallù � |
|||
causeó á "Commanä toï long¢ erroò iæ morå thaî abouô ¸ fileó arå tagged¬ � |
|||
dependinç oî thå lengthó oæ thå taggeä names. |
|||
|
|||
Lisô capabilitù allowó programó whicè accepô á filå list¬ sucè aó LPUÔ � |
|||
oò V¬ tï ruî oî taggeä files® ZEØ ió NOÔ involved. |
|||
Group Macro Tagged File Count |
|||
|
|||
Thå numbeò oæ fileó taggeä ió puô intï Useò Registeò #µ (configurable© � |
|||
beforå runninç ZEX® Thå macrï caî theî dowî counô anä takå somå additionaì � |
|||
actioî afteò iô haó ruî oî eacè taggeä file. |
|||
|
|||
For example, if you press "G<ESC>1", the script: |
|||
|
|||
1 ! $d$u:;$!crunch $f B1:;reg m5;if reg 5= 0;$"Library DU ":; |
|||
lput $"Library Name: " B1:*.* +1;era B1:*.?Z?;fi;$h: |
|||
|
|||
cruncheó taggeä fileó tï á fixeä emptù directorù B1:¬ makeó á librarù ouô oæ � |
|||
theí (leavinç rooí foò ± morå file© witè inpuô foò librarù namå anä � |
|||
location¬ theî eraseó alì "thå crunchettes"® Thió macrï requireó REÇ tï � |
|||
decremenô Registeò 5. |
|||
|
|||
Notå thaô REÇ musô bå á Type³ oò Type´ (oò RCP© foò thå ZEØ GÏ "$!¢ tï � |
|||
ruî CRUNCÈ repeatedly® Alsï notå thaô registeró onlù holä á 25µ count¡ Foò � |
|||
consistency¬ singlå macroó puô á "1¢ counô iî thå Useò Register® Useò � |
|||
registeò rangå 0..¹ ió noô enforced¬ sï yoõ caî uså registeró 10..3± iæ yoõ � |
|||
wish® However¬ 10-1µ arå reserved¬ while 16-1· arå useä bù other programs. |
|||
:S |
|||
� Macrï Scriptó |
|||
|
|||
ZFILEÒ macrï scriptó arå similaò tï thoså iî ARUNÚ anä iî thå otheò � |
|||
menõ shelló (MENU¬ VMENU¬ FMANAGER© iî thaô parameteò expressionó caî � |
|||
appear® Thå criticaì parameteró -- thå oneó thaô implemenô functionó thaô � |
|||
cannoô bå achieveä anù otheò waù -- arå thoså thaô conveù informatioî abouô � |
|||
thå directorù currentlù displayeä bù ZFILEÒ anä abouô thå pointed-tï file® � |
|||
Parameteró consisô oæ á "$¢ characteò followeä bù onå oæ thå characteró � |
|||
listeä below. |
|||
Useò prompô parameters: |
|||
|
|||
§ Useò inpuô prompt |
|||
¢ Useò inpuô prompt |
|||
* Clear screen in user prompt |
|||
$ Escape character (example: '$"' for double quote) |
|||
^ Control character (example: '^x' for control-X) |
|||
|
|||
|
|||
Parameteró foò directories: |
|||
|
|||
- currentlù displayeä directory |
|||
à DIÒ form |
|||
Ä Drivå letter |
|||
Õ Useò number |
|||
|
|||
- homå directorù (froí where ZFILEÒ waó invoked) |
|||
È DÕ form |
|||
Ò Homå DIR |
|||
Parameteró foò pointed-tï file: |
|||
|
|||
Ð Fulì informatioî (DU:FN.FT) |
|||
Æ Filå namå (FN.FT) |
|||
Î Filå namå only |
|||
Ô Filå typå only |
|||
|
|||
Speciaì parameters: |
|||
|
|||
¡ GÏ substitutioî indicator |
|||
¤ Thå dollaò character |
|||
|
|||
Thå parameteró arå listeä iî á speciaì ordeò above¬ anä wå wilì explaiî � |
|||
thaô later® Firsô wå wilì jusô presenô thå meaninç foò eacè parameter. |
|||
|
|||
Thå parameteò expressionó $¢ anä $§ arå useä tï displaù á prompô � |
|||
messagå tï thå useò anä tï reaä iî á responså string® Singlå anä doublå � |
|||
quoteó arå equivalent® Oncå thå prompô parameteò haó beeî detected¬ alì � |
|||
subsequenô characteró uð tï onå oæ thå quotå characteró arå displayeä aó thå � |
|||
useò prompt® Thus¬ iæ É aí noô mistaken¬ therå ió presentlù nï waù tï puô � |
|||
eitheò quotå characteò intï thå prompt® Thå enä oæ thå linå oò thå enä oæ � |
|||
thå filå wilì alsï terminatå thå prompt. |
|||
Iæ yoõ wanô tï makå fancù screens¬ yoõ caî includå escapå sequenceó anä � |
|||
somå controì characteró (obviouslù carriagå returî won'ô work)® Promptó iî � |
|||
scriptó maù contaiî controì characteró aó "^x"¬ wherå ø ió anù characteò � |
|||
froí À tï z. |
|||
|
|||
Thå dollaò sigî maù bå useä aî "escapå character¢ foò scripô prompts¬ � |
|||
anä caî be used to include the $, ^, ", and ' characters in prompts. |
|||
|
|||
Examples: |
|||
Script Result |
|||
$"Enter name or $^C: " Enter name or ^C: |
|||
$"Type $"//$" for help: " Type "//" for help: |
|||
|
|||
Thå $ª scripô parameteò clearó thå screeî during¬ anä rebuildó iô afteò � |
|||
á scripô prompt® Usagå ió $"$*..text.."® Prompô texô appearó aô thå toð oæ � |
|||
á cleared screen. |
|||
No÷ foò thå directorù parameters® Parameteró C¬ D¬ anä Õ returî � |
|||
informatioî abouô thå currentlù displayeä directory¬ whilå È anä Ò returî � |
|||
informatioî abouô thå homå directory¬ thå onå froí whicè ZFILEÒ waó � |
|||
originallù invoked® PLEASÅ NOTEº macroó alwayó operatå froí thå homå � |
|||
directory® Thå reasoî foò thió ió thaô ZFILEÒ caî displaù directorieó witè � |
|||
useò numberó higheò thaî 1µ eveî wheî iô ió noô possiblå tï loç intï theså � |
|||
areas® Iæ yoõ wanô tï operatå iî thå displayeä directory¬ theî youò scripô � |
|||
musô includå aî expliciô directory-changå commanä oæ thå forí "$D$U:¢ aô thå � |
|||
beginninç (oò "$C:¢ iæ youò systeí requireó thå uså oæ nameä directories© � |
|||
anä á commanä oæ thå forí "$H:¢ (oò "$R:"© aô thå end. |
|||
|
|||
Onå speciaì notå abouô thå parameteró thaô returî directorù names® Iæ � |
|||
thå directorù haó nï name¬ theî thå strinç "Noname¢ ió returned® Thió wilì � |
|||
presumablù noô matcè anù actuaì namå anä wilì lead¬ onå hopes¬ tï á benigî � |
|||
erroò condition® Theså parameteró arå includeä onlù foò systemó thaô dï noô � |
|||
allo÷ directorieó tï bå indicateä usinç thå DÕ forí (É hopå thaô fe÷ iæ anù � |
|||
systemó arå seô uð thió way). |
|||
No÷ wå comå tï thå fouò filå namå parameters® Theù allo÷ uó tï � |
|||
generatå easilù thå completå filå specificatioî oò anù parô oæ it® Notå � |
|||
thaô "$F¢ ió noô quitå thå samå aó "$N.$T"® Thå latteò alwayó containó á � |
|||
dot» thå formeò doeó noô iæ thå filå haó nï filå type. |
|||
|
|||
Finally¬ wå havå twï speciaì parameters® "$$¢ ió includeä tï allo÷ á � |
|||
dollaò sigî characteò tï bå entereä intï thå script® "$!¢ ió á controì � |
|||
parameteò thaô ió useä onlù wheî á grouð macrï ió executed® Iæ iô ió placeä � |
|||
immediatelù beforå á tokeî (strinç oæ contiguouó characters)¬ theî thaô � |
|||
tokeî wilì bå replaceä bù thå strinç "GO¢ oî alì buô thå firsô expansioî oæ � |
|||
thå script® Thió allowó grouð macrï scriptó tï operatå fasteò bù avoidinç � |
|||
repetitivå loadinç oæ á COÍ file® Iô musô bå useä witè greaô carå anä � |
|||
consideration¬ however¬ foò reasonó thaô É wilì noô gï intï here. |
|||
:D |
|||
� Defininç Macroó ‚ -- Thå CMÄ File |
|||
|
|||
No÷ let'ó learî ho÷ tï definå thå macrï functionó wå want® Aó É � |
|||
indicateä earlier¬ thå macroó arå defineä iî á filå calleä "ZFILER.CMD¢ (thå � |
|||
ZFILEÒ ComManÄ file)® Iî thå versioî oæ ZFILEÒ distributeä witè NZ-COÍ anä � |
|||
Z3PLUS¬ thå CMÄ filå ió searcheä foò iî thå rooô directorù oæ thå ZCPR³ � |
|||
commanä searcè path® Aó describeä earlier¬ thå optioî menõ allowó thå � |
|||
entirå patè tï bå used® Therå arå alsï somå additionaì configurablå optionó � |
|||
thaô wilì bå discusseä anotheò time® Yoõ musô bå surå tï puô youò � |
|||
ZFILER.CMÄ filå iî thå appropriatå directory® Iæ thå filå cannoô bå � |
|||
located¬ yoõ wilì stilì geô thå macrï prompt¬ but¬ afteò yoõ havå specifieä � |
|||
á macrï key¬ thå erroò messagå "ZFILER.CMÄ NOÔ Found¢ wilì bå displayed. |
|||
|
|||
Thå ZFILER.CMÄ filå ió aî ordinarù texô filå thaô yoõ caî creatå witè � |
|||
anù editoò oò wordprocessoò thaô caî makå plaiî ASCIÉ fileó (WordStaò iî � |
|||
nondocumenô mode¬ foò example)® Thå CMÄ filå haó twï parts® Thå firsô parô � |
|||
containó thå macrï commanä definitions» thå seconä containó thå helð screeî � |
|||
(describeä earlier). |
|||
Iî thå firsô parô oæ thå CMÄ file¬ eacè linå defineó á macro® Thå � |
|||
characteò iî thå firsô columî ió thå keù associateä witè thaô definitioî � |
|||
(caså doeó noô matter)® Macroó caî bå associateä witè thå 1° numbeò keys¬ � |
|||
2¶ letteò keys¬ anä alì printablå speciaì characteró excepô foò "#¢ � |
|||
(explaineä below)® Thå spacå characteò anä alì controì characteró arå noô � |
|||
allowed® Owinç tï aî oversight¬ thå rubouô (DEL© characteò caî bå � |
|||
associateä witè á macro! |
|||
|
|||
Afteò thå characteò thaô nameó thå macrï therå maù bå anù numbeò oæ � |
|||
blankó (includinç zero)® Iæ thå firsô non-blanë characteò ió "!"¬ theî thå � |
|||
"strikå anù key¢ (shell-wait© prompô wilì appeaò beforå ZFILEÒ putó uð thå � |
|||
filå displaù afteò á macrï commanä ió run® Thió shoulä bå useä wheneveò thå � |
|||
macrï wilì leavå informatioî oî thå screeî thaô yoõ wilì wanô tï read® � |
|||
Afteò thå "!¢ therå caî agaiî bå anù numbeò oæ spaces® Anù remaininç texô � |
|||
oî thå linå ió takeî aó thå scripô foò thå macrï command. |
|||
Thå seconä parô oæ thå CMÄ filå startó wheî á "#¢ characteò ió founä iî � |
|||
thå firsô columî (hencå thå exclusioî oæ thaô characteò aó á macrï name)® � |
|||
Oncå thaô characteò appears¬ alì remaininç text¬ includinç texô oî thå line¬ � |
|||
wilì bå useä aó thå helð screen® Sincå ZFILEÒ wilì adä somå informatioî tï � |
|||
thå displaù (thå namå oæ thå pointed-tï filå anä á prompt)¬ yoõ wilì � |
|||
generallù wanô tï keeð thå helð screeî tï nï morå thaî 2° lines¬ includinç � |
|||
aî extrá blanë linå aô thå enä foò spacing® Witè somå experimentatioî yoõ � |
|||
wilì geô thå hanç oæ designinç thió screen. |
|||
|
|||
|
|||
Here is a parameter reminder you can include in your ZFILER.CMD file: |
|||
|
|||
$! ZEX 'GO' $P DU:FN.FT $D Current Drive |
|||
$".." PROMPT $F FN.FT $U Current User |
|||
$'..' PROMPT $N FN $C Current DIR |
|||
$* CLS on Prompt $T FT $H Home DU $R Home DIR |
|||
:R |
|||
� Ruleó foò Scripô Expansioî |
|||
|
|||
ZFILEÒ followó á specifiã sequencå oæ stepó wheî expandinç á script¬ � |
|||
onå thaô giveó iô á speciaì featurå that¬ É woulä guess¬ fe÷ useró arå awarå � |
|||
of® Thå firsô steð iî thå expansioî ió tï procesó onlù thå user-inpuô � |
|||
prompô parameters¬ substitutinç foò thå prompô whateveò thå useò entereä iî � |
|||
response® Thió resultó iî á modifieä scripô thaô ió theî processeä bù thå � |
|||
seconä steð iî thå expansion® Becauså thå expansioî ió handleä thió way¬ � |
|||
thå useò inpuô caî includå ZFILEÒ scripô parameters¡ Thus¬ thå scripô caî � |
|||
bå useä tï writå á script® Yoõ wilì seå aî examplå oæ thió later. |
|||
|
|||
Thå seconä steð iî thå expansioî ió tï substitutå valueó foò thå � |
|||
directorù parameters¬ whicè arå somewhaô likå constants® Theù dï noô changå � |
|||
aó á functioî oæ thå pointed-tï file® Finally¬ iî á thirä step¬ thå � |
|||
remaininç parameteró arå expanded® Foò grouð macros¬ thió finaì steð iî thå � |
|||
expansioî ió repeateä foò eacè oæ thå taggeä files® Thå filå parameteró arå � |
|||
expandeä differentlù foò eacè file¬ and¬ startinç witè thå seconä taggeä � |
|||
file¬ thå "$!¢ parameteò causeó "GO¢ substitution. |
|||
:E |
|||
� Macrï Exampleó |
|||
|
|||
Thå macrï CMÄ listinç iî sectioî � Ì ‚ showó aî examplå oæ á ZFILER.CMÄ � |
|||
file¬ onå designeä tï illustratå somå techniqueó oæ macrï writing® Whilå � |
|||
writinç thió article¬ É discovereä thaô onå caî includå blanë lineó aó showî � |
|||
tï makå thå CMÄ filå easieò tï read® Thå helð screeî parô oæ thå listinç ió � |
|||
takeî froí mù personaì scripô filå (oî which¬ É havå tï confess¬ É havå noô � |
|||
reallù workeä verù hard)® Thå macrï definitioî parô oæ thå listinç includeó � |
|||
onlù á fe÷ oæ thå definitions® Yoõ maù wisè tï uså thå Prinô functioî oæ � |
|||
thå HELÐ utilitù tï prinô ouô thió section¬ iî ordeò tï follo÷ alonç witè � |
|||
thió discussion. |
|||
Thå macrï "Q¢ ió includeä tï illustratå á verù simple¬ buô useful¬ typå � |
|||
oæ macro® Iô invokeó thå verù powerfuì filå typinç prograí QÌ (quicë look© � |
|||
oî thå pointed-tï file® Thió ió handù wheî yoõ wanô morå powerfuì viewinç � |
|||
capabilitù thaî thaô offereä bù thå built-iî "V¢ command® QÌ caî handlå � |
|||
cruncheä fileó anä libraries¬ anä iô caî displaù texô oò heø forwarä oò � |
|||
backward. |
|||
|
|||
Macrï "U¢ uncompresseó á file® Iô illustrateó á morå compleø scripô � |
|||
thaô involveó flo÷ controì anä parameteró thaô extracô individuaì componentó � |
|||
oæ thå pointed-tï filå name® Iô testó thå filå typå tï seå iæ thå middlå � |
|||
letteò ió "Q¢ oò "Z"® Iî thå formeò case¬ iô unsqueezeó thå file» iî thå � |
|||
latter¬ iô uncruncheó it® Thå uncompresseä filå iô puô intï thå sourcå � |
|||
file'ó directory. |
|||
|
|||
Macroó S¬ K¬ anä Â illustratå thå uså oæ inpuô prompting® Thå firsô � |
|||
onå allowó thå useò tï specifù thå filå attributeó tï bå set® Notå thaô thå � |
|||
prompô includeó á helpfuì remindeò oæ thå syntaø requireä bù SFA. |
|||
Macrï Ë cruncheó fileó tï á user-specifieä destination® Iô alsï � |
|||
illustrateó ho÷ onå logó intï thå currentlù displayeä directory® É dï thió � |
|||
herå sï thaô á nulì answeò tï thå prompô (i.e.¬ jusô á carriagå return© wilì � |
|||
resulô iî thå cruncheä fileó beinç placeä iî thå currentlù displayeä � |
|||
directorù ratheò thaî iî thå homå directory¬ aó woulä otherwiså bå thå caså � |
|||
(sincå thaô ió wherå thå macrï runó from¬ remember)® Aó á result¬ however¬ � |
|||
thió macrï wilì noô operatå properlù iî useò areaó abovå 1µ undeò BGié oò � |
|||
versionó oæ thå commanä processoò thaô dï noô allo÷ logginç intï higè useò � |
|||
areas. |
|||
|
|||
Macrï Â performó á slightlù morå compleø function® Iô noô onlù � |
|||
compresseó thå pointed-tï filå tï á specifieä destinatioî directory¬ buô iô � |
|||
theî markó thå sourcå filå aó havinç beeî backeä up® Á combinatioî oæ thå � |
|||
grouð archivå built-iî commanä (tï taç fileó thaô neeä backinç up© anä á � |
|||
grouð macrï Â (tï perforí thå backup© giveó thå ZFILEÒ useò á waù tï bacë uð � |
|||
fileó iî cruncheä forí oî thå backuð disk. |
|||
Macrï Í ió includeä tï sho÷ thaô á ZFILEÒ macro¬ wheî iô needó tï dï � |
|||
somethinç morå compleø thaî iô ió capablå oæ doinç alì bù itself¬ caî pasó � |
|||
thå tasë tï aî ARUNÚ alias® Thå MOVÅ aliaó firsô determineó whetheò thå � |
|||
sourcå anä destinatioî arå oî thå samå drive® Iî thaô case¬ MOVE.COÍ ió � |
|||
useä tï perforí thå move® Otherwise¬ thå sourcå filå ió copieä tï thå � |
|||
destinatioî anä theî deleted® Whaô wå have¬ therefore¬ ió á MOVÅ commanä � |
|||
thaô freeó thå useò oæ thå responsibilitù oæ worryinç abouô whicè driveó arå � |
|||
involveä -- anotheò examplå oæ ho÷ Z-Systeí caî freå yoõ froí considerationó � |
|||
thaô neeä noô concerî you¬ thaô dï noô requirå humaî intelligencå tï decide. |
|||
|
|||
Thå finaì threå macrï exampleó arå executioî macros® Macrï Ø causeó � |
|||
thå pointed-tï filå tï bå executed® Á morå sophisticateä versioî mighô � |
|||
checë tï makå surå thaô thå filå typå ió COM® É opteä foò thå flexibilitù � |
|||
oæ pointing¬ foò example¬ tï PROGRAM.Z8° anä havinç PROGRAM.COÍ run® Iæ � |
|||
therå ió nï COÍ filå witè á matchinç name¬ thå erroò handleò wilì takå carå � |
|||
oæ things® Yoõ wilì notå thå leadinç coloî beforå thå "$n¢ parameter® Iô � |
|||
makeó surå thaô thå currenô directorù ió searcheä eveî iæ iô ió noô oî thå � |
|||
path® Prompteä inpuô ió useä tï allo÷ á commanä taiì tï bå included. |
|||
Thå Ú macrï performó á user-specifieä functioî oî thå pointed-tï file® � |
|||
Twï separatå useò promptó allo÷ botè thå commanä anä á commanä taiì tï bå � |
|||
given® Foò example¬ iæ yoõ wanteä tï squeezå thå filå tï A0:¬ yoõ woulä � |
|||
enteò "SQ¢ iî responså tï thå firsô prompô anä "A0:¢ iî responså tï thå � |
|||
second. |
|||
|
|||
Thå ° macrï illustrateó ho÷ thå responså tï á prompô caî bå useä aó á � |
|||
ZFILEÒ script® Thió macrï takeó carå oæ alì thoså functionó wå forgoô tï � |
|||
includå iî ZFILER.CMD® Thå wholå macrï ió jusô prompteä input¬ anä whateveò � |
|||
wå answeò wilì bå ruî aó á script® É uså thió functioî sï ofteî thaô É puô � |
|||
iô oî á numbeò keù sï thaô iô caî bå invokeä witè á singlå keù ratheò thaî � |
|||
thå usuaì pair® Also¬ aó yoõ maù havå noticed¬ É includå iî thå macrï helð � |
|||
screeî á lisô oæ thå parameteró thaô caî bå used. |
|||
|
|||
Thå onlù reaì limitatioî oæ thió macro-to-write-a-macrï approacè ió � |
|||
thaô prompteä inpuô cannoô bå includeä iî thå response® Aó É writå this¬ � |
|||
however¬ iô occuró tï må thaô thió limitatioî coulä bå overcomå bù � |
|||
recursivelù parsinç thå prompô parameteró untiì nonå remain¬ anä onlù theî � |
|||
goinç oî tï thå subsequenô macrï expansioî steps. |
|||
:L |
|||
� SAMPLE MACRO LISTINÇ |
|||
-------------------- |
|||
Ñ qì $p |
|||
|
|||
Õ ¡ iæ $t=?q?;$!sys:uæ $ð $d$u:;else;$!sys:uncò $ð $d$u:;fi |
|||
|
|||
Ó ¡ $!sfá $ð $¢ SFÁ Optionó (/o,o.® o=ARC,-ARC,R/O,R/W,SYS,DIR)º " |
|||
Ë ¡ $d$u:;$!cruncè $æ $"Destinatioî directorù (DU:© -- ";$h: |
|||
 $d$u:;cruncè $æ $"Destinatioî directorù (DU:© -- ";sfá $æ /arc;$h: |
|||
|
|||
Í ¡ /movå $ð $"Destinatioî directorù foò moveº " |
|||
|
|||
Ø ¡ $d$u:;:$î $¢ Commanä Tailº ";$h: |
|||
Ú ¡ $d$u:;$¢ Commanä tï perforí oî fileº ¢ $æ $¢ Tailº ";$h: |
|||
° ¡ $"Enteò ZFILEÒ macrï scriptº " |
|||
£ SAMPLÅ ZFILEÒ MACROÓ FOÒ TCJ |
|||
|
|||
0® on-linå macrï A® seô Archivå biô N® NULU |
|||
1® LPUÔ B® Backuð (cr/sfa© O. |
|||
2® Z80ASÍ tï COÍ C® CRÃ P® Protect |
|||
3® Z80ASÍ tï REÌ D® Datå displaù Q® QL |
|||
4® Comparå Fileó E® Ediô R. |
|||
5® F® S® SFA |
|||
6® G® T® Type |
|||
7® H® U® Uncompress |
|||
8® I® V® VLU |
|||
9® J® W. |
|||
K® Kruncè X® eXecute |
|||
L® LDIÒ Y. |
|||
M® Movå Z® ruî command |
|||
|
|||
$¡ ZEØ 'GO§ $Ä DRIVÅ $Ð DU:FN.FÔ $Æ FN.FT |
|||
$"..¢ PROMPÔ $Õ USEÒ $Î FÎ $Ô FT |
|||
$'..§ PROMPÔ $È HOME |
|||
|
|||
Binary file not shown.
@ -0,0 +1,344 @@ |
|||
; |
|||
Z P |
|||
|
|||
Version 1.7 |
|||
|
|||
A ZCPR3 Screen-Oriented File/Disk/Memory Patcher |
|||
|
|||
I --> Installation |
|||
C --> Configuration |
|||
O --> Overview |
|||
S --> Syntax |
|||
R --> Running ZP |
|||
M --> Memory Mode |
|||
D --> Disk Mode |
|||
F --> File Mode |
|||
X --> String Search |
|||
E --> Record Edit |
|||
H --> HP Calculator |
|||
Q --> HP Quik Ref |
|||
K --> Record Cache |
|||
:I |
|||
Installation |
|||
|
|||
Thå distributioî versioî oæ ZÐ ió supplieä readù foò uså iî ZCPR33« � |
|||
environments® ZCPR3° useró shoulä instalì ZÐ usinç theiò normaì method® |
|||
:C |
|||
Configuration� |
|||
|
|||
ZCNFÇ anä ZP.CFÇ maù bå useä tï configurå ZÐ tï alteò thå operatioî oæ thå � |
|||
prograí tï suiô thå user® Defaulô values¬ sucè aó thå startinç memorù modå � |
|||
addresó anä thå ASCIÉ recorä characteò displaù modå maù bå configured® |
|||
|
|||
Thå linå graphicó menõ boø displaù maù bå configureä tï displaù thå menõ � |
|||
boø iî linå graphicó (foò useró witè reverså videï standout)¬ standouô linå � |
|||
graphicó (foò useró witè darë screenó anä dií standout© anä tï noô displaù � |
|||
thå menõ boø aô all. |
|||
|
|||
Foò useró witè reverså videï standouô anä unblinkinç blocë cursors¬ ZÐ maù � |
|||
bå configureä tï refresè thå recorä displaù oî enterinç thå ediô modå iî � |
|||
ordeò tï deletå thå standouô videï placå markeró produceä bù á strinç � |
|||
searcè oò aî addresó find® Thå heø recorä displaù standouô markeò caî � |
|||
causå confusioî wheî attemptinç tï ediô thå markeä byte witè aî unblinkinç � |
|||
cursor. |
|||
|
|||
ZÐ maù alsï bå configureä tï cleaò thå screeî oî exit® Thå defaulô ió tï � |
|||
leave the screen display on screen. |
|||
:O |
|||
Overview� |
|||
|
|||
ZÐ (Zcpr3 Patcher© ió á Z8° screen-orienteä recorä editor-patcher® ZP.1OM¬ � |
|||
á typå ± version¬ loadinç anä executinç aô 100h¬ wilì ruî undeò anù versioî � |
|||
oæ ZCPR3® ZP.4OM¬ á typå ´ version¬ executeó onlù undeò ZCPR34+¬ Z3PLUÓ oò � |
|||
BGii® Botè versionó requirå aî extendeä Z3TCAÐ (aó defineä bù VLIB4D+© anä � |
|||
alsï requirå thaô thå ZCPR³ wheeì bytå bå set® Thå sourcå codå maù alsï bå � |
|||
assembleä tï producå á typå ³ version¬ runninç aô 8000è undeò ZCPR33+¬ �ŠZ3PLUÓ oò BGii. |
|||
|
|||
ZÐ waó originallù looselù baseä oî SUPERZAP¬ aká SPÚ oò ZAP33¬ anä waó � |
|||
developeä aó á work-alikå foò Steveî Cohen'ó greaô ZPATCH1° thaô would¬ iî � |
|||
additioî tï editinç filå records¬ alsï providå screen-orienteä editinç oæ � |
|||
memorù anä disë records® ZÐ ió intendeä tï complemenô ratheò thaî replacå � |
|||
ZPATCH¬ aó welì aó tï complemenô Roâ Friefeld'ó excellenô BCOMÐ anä VCOMP¬ � |
|||
especiallù wheî theù arå patcheä tï uså thå ZPATCH/WÓ commanä sets® Iî � |
|||
ordeò tï keeð ZÐ relativelù simple¬ iô lackó ZPATCH'ó comprehensivå strinç � |
|||
searcè optionó anä doeó noô havå á commanä tï senä thå currenô recorä tï � |
|||
thå printer® Unlikå ZPATCH¬ ZÐ ió á transienô utilitù anä noô á shell. |
|||
|
|||
ZÐ haó á one-recorä cachå foò temporarù recorä storagå anä caî movå thå � |
|||
cachå contentó betweeî file¬ memorù anä disë records® Thió allowó you¬ foò � |
|||
example¬ tï takå á one-recorä Z3TCAP.Z3Ô filå anä patcè iô intï memorù iî � |
|||
thå ZCPR³ environment® |
|||
|
|||
ZÐ alsï containó thå powerfuì anä full-featureä HP12 RPÎ programmer'ó � |
|||
integeò calculator¬ whicè maù bå calleä uð iî file¬ disk¬ memorù oò recorä � |
|||
ediô modeó (eveî durinç thå editinç process)¬ tï perform¬ savå oò recalì � |
|||
thå resultó oæ integeò calculationó oò logicaì operationó iî hex¬ decimal¬ � |
|||
binary¬ oò characteò modes® |
|||
:S |
|||
Syntax� |
|||
|
|||
Whilå ZÐ allowó thå useò tï freelù switcè amonç modeó durinç prograí � |
|||
operation¬ iô alsï maù bå instructeä tï comå uð iî thå desireä initiaì modå � |
|||
bù usinç thå followinç commanä linå syntax: |
|||
|
|||
ZP [hex_addr] - Memory mode at hex address |
|||
ZP dir: - Disk mode |
|||
ZP [dir:]afn - File mode |
|||
ZP // - Display syntax help screen |
|||
:R |
|||
Running ZP |
|||
|
|||
Excepô foò thå HÐ calculator¬ ZÐ ió menu-driveî anä useó commandó similaò � |
|||
tï ZPATCH10¬ sï iô shoulä requirå littlå iî thå waù oæ instruction® Morå � |
|||
specifiã informatioî abouô thå operatioî oæ eacè modå maù bå founä iî thå � |
|||
following sectionó. |
|||
|
|||
Severaì alternatå commands¬ however¬ dï noô appeaò iî thå menu® Foò � |
|||
example¬ therå arå severaì alternatå exiô commands® Whilå thå 'Q§ commanä � |
|||
ió thå onlù exiô commanä showî iî thå commanä menus¬ 'X§ anä ESÃ arå � |
|||
also accepted as exiô commands® |
|||
|
|||
Foò easieò browsing¬ thå spacå characteò ió accepteä aó aî alternatå next-� |
|||
screeî commanä aô thå memory¬ filå anä disë menus. |
|||
ASCII Record Display Mode |
|||
|
|||
ZÐ caî displaù characteró iî thå ASCIÉ parô oæ thå recorä displaù iî onå oæ � |
|||
twï user-selectablå ways® ZP'ó distributioî defaulô ASCIÉ displaù modå � |
|||
displays onlù thå actuaì displayablå characters¬ displayinç alì otheò � |
|||
characteró aó '.'s® Thió typå oæ display¬ typicaì oæ DDT¬ ió relativelù � |
|||
uncluttereä buô iô ió morå difficulô tï reaä texô thaô haó thå higè bitó oæ � |
|||
characters set, such as WordStaò fileó anä disë directorieó. |
|||
|
|||
Alternately¬ ZÐ caî bå commandeä tï filteò thå higè bitó oæ thå characteró � |
|||
beinç displayed¬ convertinç ASCIÉ characteró witè thå higè biô seô tï � |
|||
displayablå characteró anä displayinç alì otheò characteró aó '.'s® Thió � |
|||
typå oæ display¬ typicaì oæ PEEK¬ convertó morå characteró tï ASCII® Whilå � |
|||
iô caî ofteî appeaò morå cluttered¬ iô ió easieò tï reaä WordStaò fileó anä � |
|||
disë directorieó iî thió mode® |
|||
|
|||
Durinç operation¬ thå useò caî togglå thå typå oæ ASCIÉ displaù desireä bù � |
|||
usinç thå non-menõ commanä Control-Á (^A© aô anù oæ thå maiî modå menus® � |
|||
Therå ió alsï á ZCNFG-configurablå flaç thaô controló thå defaulô ASCIÉ � |
|||
displaù mode® |
|||
:M |
|||
Memory Mode |
|||
|
|||
Memorù modå ió ZP'ó defaulô modå oæ operatioî wheî nï otheò modå ió � |
|||
specifieä oî thå commanä line® Iæ nï startinç addresó ió specifieä oî thå � |
|||
commanä line¬ thå addresó oæ thå ZCPR³ environmenô ió thå defaulô startinç � |
|||
addresó foò thå ZÐ display¬ buô ZCNFÇ maù bå useä tï configurå á differenô � |
|||
defaulô startinç address¬ sucè aó 100h¬ iæ desired® Thå displaù wilì alsï � |
|||
starô aô thió configureä addresó wheî memorù modå ió entereä froí anotheò � |
|||
ZÐ mode. |
|||
|
|||
Iæ yoõ includå á startinç addresó oî thå commanä linå (uð tï ´ hexidecimaì � |
|||
characteró witè NÏ non-heø characters)¬ ZÐ wilì begiî itó displaù aô thå � |
|||
memorù recorä containinç thå specifieä address® Á subsequenô ediô commanä � |
|||
wilì alsï begiî aô thå specifieä address® |
|||
|
|||
ZÐ useó thå commanä buffeò aô 80è aó itó workinç recorä buffer¬ sï wheneveò � |
|||
yoõ vie÷ thå commanä buffeò record¬ yoõ wilì actuallù bå lookinç aô á copù � |
|||
oæ thå recorä thaô waó previouslù viewed® Notå ho÷ thå commanä buffeò � |
|||
displaù changeó wheî yoõ steð througè iô froí oppositå directions® Wheî iô � |
|||
ió displayinç thå commanä buffeò contents¬ ZÐ alsï displayó á speciaì � |
|||
headeò tï reminä yoõ thaô yoõ arå viewinç thå commanä buffer¬ aó iô ió � |
|||
generallù inadvisablå (anä usuallù futile© tï attempô tï ediô thå contentó � |
|||
oæ thå commanä buffer. |
|||
|
|||
Thå 'T§ (Toð oæ Memory© commanä displayó thå highesô memorù recorä (FF80h-� |
|||
FFFFh© anä thå 'B§ (Bottoí oæ Memory© commanä displayó thå firsô memorù � |
|||
recorä (0000h-007Fh)® |
|||
|
|||
Thå 'A§ commanä allowó yoõ tï selecô thå addresó oæ á memorù 'record§ tï � |
|||
view® ZÐ wilì displaù thå 12¸ bytå 'record§ containinç thaô address¬ witè � |
|||
thå bytå aô thå specifieä addresó highlighteä iî botè thå Heø anä ASCIÉ � |
|||
displays® Iæ thå ediô modå ió subsequentlù selected¬ thå ediô cursoò wilì � |
|||
alsï bå positioneä aô thå specifieä address. |
|||
:D |
|||
Disk Mode |
|||
|
|||
Wheî yoõ selecô thå drivå yoõ wisè tï accesó iî disë mode¬ yoõ maù alsï � |
|||
specifù á useò area¬ usinç eitheò á DUº oò DIRº specification® Thå � |
|||
specifieä drive/useò theî becomeó thå defaulô foò anù subsequenô filå � |
|||
accesses. |
|||
|
|||
ZÐ startó thå disë modå displaù witè thå firsô directorù record® Otheò � |
|||
recordó maù bå selecteä bù block¬ record¬ oò track® |
|||
|
|||
Floppù disë systeí tracë recordó maù bå displayeä bù selectinç tracë ° oò � |
|||
bù steppinç bacë froí thå directory® Harä disë systeí recordó maù bå � |
|||
displayeä wheî thå 'first§ disë (á DPÂ OFFSEÔ oæ lesó thaî 10© ió loggeä � |
|||
in® Otherwiså thå displaù ió limiteä tï thå actuaì loggeä disë tracks® � |
|||
Wheî steppinç pasô thå firsô oò lasô tracë oò recorä oæ thå disk¬ ZÐ wilì � |
|||
wrað arounä tï thå otheò enä oæ thå disk. |
|||
:F |
|||
File Mode |
|||
|
|||
Thå drive/useò containeä iî anù filenamå specificatioî becomeó thå defaulô � |
|||
foò anù subsequenô filå oò disë accesses® |
|||
|
|||
Wheî wildcarä filenameó arå entered¬ ZÐ wilì displaù thå firsô filå founä � |
|||
iî thå directorù thaô matcheó thå specifieä ambiguouó filename® Iæ thå � |
|||
filenamå entereä ió á COÍ file¬ á displaù offseô oæ 0100è wilì bå addeä � |
|||
automaticallù tï thå filå recorä addresseó sï thaô thå firsô filå recorä � |
|||
wilì starô aô á displaù addresó oæ 0100h® Otheò filå typeó wilì bå � |
|||
displayeä startinç aô aî addresó oæ 0000è (offseô ½ 0)® Thå 'O§ (Offset© � |
|||
commanä allowó yoõ tï changå thå displaù offseô aó desired. |
|||
|
|||
Thå 'A§ commanä allowó yoõ tï selecô aî addresó iî thå file® ZÐ wilì � |
|||
displaù thå 12¸ bytå recorä containinç thaô address¬ witè thå bytå aô thå � |
|||
specifieä addresó highlighteä iî botè thå Heø anä ASCIÉ displays® Iæ thå � |
|||
ediô modå ió subsequentlù selected¬ thå ediô cursoò wilì alsï bå positioneä � |
|||
aô thå specifieä address. |
|||
:X |
|||
String Search |
|||
|
|||
ZP'ó strinç searcè functioî ió similaò tï ZPATCH's¬ buô iô ió mucè morå � |
|||
basiã anä haó nï options® Stringó tï bå locateä maù bå entereä aó heø oò � |
|||
ASCIÉ characteró oò anù combination® ASCIÉ stringó arå entereä delimiteä � |
|||
bù singlå oò doublå quoteó anä wilì bå automaticallù capitalized® Heø � |
|||
characteró arå entereä delimiteä bù commaó oò spaces® Botè singlå anä � |
|||
doublå quotå characteró musô bå entereä aó heø characters® Thå remaindeò �Šoæ thå terminaì displaù linå afteò thå prompt¬ abouô 4µ characters¬ maù bå � |
|||
useä foò characteò entry® Foò example¬ thå entry: |
|||
|
|||
'Fil',65,6e,61 "me" will create the search string 'FILENAME' |
|||
|
|||
Á fe÷ compromiseó anä assumptionó havå beeî madå sï thaô thå samå searcè � |
|||
routinå maù bå useä iî alì situations® Wheî doinç thå search¬ ZÐ wilì � |
|||
firsô comparå á searcè characteò witè thå buffeò characteò withouô regarä � |
|||
tï ASCIÉ case® Iæ nï matcè ió found¬ thå buffeò characteò wilì bå filtereä � |
|||
anä capitalizeä (iæ ASCII© anä anotheò comparisoî made® Thió allowó yoõ tï � |
|||
searcè foò texô iî WordStaò fileó oò disë directorieó withouô worryinç � |
|||
abouô caså oò higè bits¬ whilå stilì retaininç thå abilitù tï dï searcheó � |
|||
foò heø characteró sucè aó commanä oò addresó characters® Foò example: |
|||
|
|||
'Filename§ wilì matcè 'FILEN','A'+80h,'ME§ or 'FILENAME§ |
|||
(wherå thå 'A§ haó thå higè biô set)¬ while � |
|||
|
|||
'Filen',E1,"me¢ wilì matcè 'FILEN','A'+80h,'ME'¬ buô noô � |
|||
'FILENAME§ (specificallù insistinç oî aî exacô matcè � |
|||
foò E1h¬ whicè ió 'A§ witè thå higè biô set). |
|||
|
|||
Aó á resulô oæ thió relativelù simplå searcè scheme¬ heø searcè characteró � |
|||
thaô happeî tï alsï bå loweò caså ASCIÉ characteró wilì matcè botè exacô � |
|||
anä 'capitalized§ characters¬ whicè mighô resulô iî aî occasionaì falså � |
|||
positivå match® Foò examplå 65è ('e'© wilì matcè botè 65è anä 45è ('E'). |
|||
|
|||
Strinç searcheó maù bå stoppeä aô anù timå bù enterinç anù character® Disë � |
|||
modå strinç searcheó wilì continuå untiì á matcè ió founä oò untiì yoõ stoð � |
|||
thå search¬ wrappinç aô thå lasô tracë bacë tï thå firsô track® |
|||
|
|||
Wheî thå 'C§ commanä ió useä tï continuå á search¬ thå searcè wilì starô � |
|||
froí thå addresó oæ thå lasô matcè iæ iô ió locateä iî thå recorä currentlù � |
|||
displayed¬ otherwiså iô wilì starô aô thå beginninç oæ thå currenô record. |
|||
|
|||
Wheî á strinç ió located¬ thå recorä iî whicè iô ió founä wilì bå displayeä � |
|||
anä thå firsô bytå oæ thå strinç wilì bå highlighteä iî botè thå Heø anä � |
|||
ASCIÉ displays® Iæ thå ediô modå ió theî selected¬ thå ediô cursoò wilì bå � |
|||
positioneä aô thå starô oæ thå founä string® Iæ á strinç ió noô found¬ thå � |
|||
currenô recorä wilì bå redisplayed. |
|||
:E |
|||
Record Edit |
|||
|
|||
ZP¬ likå ZPATCH¬ useó thå WordStaò diamonä keyó (^S¬ ^E¬ ^D¬ ^X© tï controì � |
|||
thå cursoò durinç editing® Thå backspacå keù ió aî alternatå tï ^Ó tï movå � |
|||
thå cursoò left® Thå arro÷ keyó defineä iî thå Z3TCAÐ arå alsï mappeä aó � |
|||
alternatå cursoò controì keys¬ eveî thougè theù arå noô showî iî thå ediô � |
|||
modå commanä menu® |
|||
|
|||
Somå terminals¬ sucè aó ANSÉ terminals¬ have arro÷ keyó thaô generatå morå � |
|||
thaî onå character® Foò theså terminals¬ thå arro÷ keù definitionó iî thå � |
|||
Z3TCAÐ wilì probablù bå thå WordStaò diamonä keys® Pressinç aî actuaì � |
|||
arro÷ keù maù causå itó strinç tï bå interpreteä bù ZÐ aó thå equivalenô � |
|||
serieó oæ characters® Thió wilì usuallù bå undesirable® Iî thå caså oæ � |
|||
ANSÉ terminals¬ thå arro÷ codeó wilì causå aî exiô froí ZP. |
|||
|
|||
Wheî thå ediô modå ió entereä followinç á strinç searcè oò aî addresó � |
|||
specification¬ thå ediô cursoò wilì bå placeä aô thå beginninç oæ thå founä � |
|||
strinç oò aô thå specifieä address® Specifyinç thå desireä ediô addresó � |
|||
beforå enterinç thå ediô modå ió á quicë waù tï directlù reacè thå desireä � |
|||
addresó iî thå recorä beinç edited® Thå addresó oæ thå bytå currentlù � |
|||
beinç editeä ió displayeä iî thå ediô modå menõ box. |
|||
|
|||
Thå ESÃ keù toggleó thå ediô modå betweeî thå Heø anä ASCIÉ displays® |
|||
|
|||
ZÐ haó á speciaì Filì commanä (^F© thaô allowó yoõ tï filì á numbeò oæ � |
|||
byteó iî thå 12¸ bytå recorä beinç editeä witè á specifieä filì byte® Thå � |
|||
fill syntaø isº |
|||
|
|||
Filì bytå (iî heø oò quoteä ASCII: 0, e5, ff, '*', etc) |
|||
Separatoò (comma¬ spacå oò tab© � |
|||
Decimaì numbeò oæ byteó tï bå filled (* = fill to end of record) |
|||
|
|||
Filló begin witè thå currenô cursoò position® Filì lengthó uð tï 25µ (FFh© � |
|||
wilì bå accepted¬ buô á maximuí oæ 12¸ byteó can bå filled® Thå filì wilì � |
|||
alwayó stoð aô thå enä oæ thå recorä iæ yoõ enteò á lengtè greateò thaî thå � |
|||
numbeò oæ byteó remaininç iî thå record® Yoõ maù alsï enteò thå speciaì � |
|||
lengtè characteò ª tï telì ZÐ tï filì tï thå enä oæ thå record® Enteò '?§ � |
|||
aô thå filì prompô foò á helð screen. |
|||
|
|||
ZÐ useó thå ZPATCÈ commandó tï exiô thå ediô mode® Enteò ^Ñ tï quiô � |
|||
withouô savinç thå changes¬ anä enteò ^× tï savå thå changeó anä exit® |
|||
:Q |
|||
HP Calculator Quick Reference |
|||
|
|||
ZÐ containó thå powerfuì anä full-featureä HP12 RPÎ programmer'ó integeò � |
|||
calculator® Thå calculatoò maù bå calleä uð aô anù timå (eveî durinç thå � |
|||
editinç process© tï perform¬ savå oò recalì thå resultó oæ integeò � |
|||
calculationó oò logicaì operationó iî hex¬ decimal¬ binary¬ oò characteò � |
|||
modes® |
|||
|
|||
Thå calculatoò ió botè invokeä anä exiteä bù enterinç ^C® Sincå thå � |
|||
calculatoò retainó alì registeò informatioî aó lonç aó ZÐ ió running¬ � |
|||
calculatoò registeró maù bå useä tï storå referencå datá betweeî otheò ZÐ � |
|||
operations® Thå calculatoò maù alsï bå invokeä durinç recorä editinç � |
|||
operationó withouô affectinç thå editinç procesó iî anù way. |
|||
HP12 Command Summary |
|||
|
|||
^X Clear entire stack |
|||
BS Delete last character |
|||
<RET> Enter number into register X |
|||
= Exchange the contents of X and Y |
|||
L Restore last X value |
|||
< or , Roll stack down one level |
|||
> or . Roll stack up one level |
|||
Sn Store contents of X in memory register n (0-5 or R) |
|||
Rn Recall contents of memory register n to register X |
|||
^C Exit HP12 |
|||
|
|||
HP12 Math Function Summary |
|||
|
|||
« Addition¬ X=Y+Ø� |
|||
Subtraction¬ X=Y-Ø� |
|||
ª Multiplication¬ X=Y*Ø� |
|||
Þ Exponentiation¬ X=Y^Ø (Y to the power X)� |
|||
¯ Integeò quotient¬ X=INT(Y/X©� |
|||
- Remainder in Register R=X*(Y/X-INT(Y/X)© � |
|||
¦ Bitwiså AND¬ X=Y&X� |
|||
ü Bitwiså OR¬ X=Y|X� |
|||
þ Negatioî [2'ó complement]¬ X=~Ø |
|||
:K |
|||
Record Cache |
|||
|
|||
ZÐ provideó á one-recorä buffeò intï whicè yoõ caî copù thå currentlù � |
|||
displayeä record® Yoõ caî lateò exchangå thå cacheä recorä witè thå recorä � |
|||
beinç currentlù displayed® Thió allowó you¬ foò example¬ tï experimentallù � |
|||
ediô á recorä whilå maintaininç á copù oæ thå unediteä recorä iî thå cachå � |
|||
buffer® Notå thaô wheî yoõ exiô ZP¬ thå contentó oæ thå cachå buffeò wilì � |
|||
bå lost¬ sï iæ yoõ wisè tï preservå á record¬ exchangå iô witè á recorä � |
|||
froí á 'holding§ filå oæ aô leasô onå recorä iî lengtè thaô yoõ havå � |
|||
previouslù reserveä foò recorä storagå (ZÐ wilì noô creatå files.© Yoõ caî � |
|||
alsï savå á cacheä recorä iî aî unuseä 12¸ bytå 'record§ iî memory¬ usinç � |
|||
SAVE.COÍ tï savå thå memorù recorä tï á filå afteò yoõ exiô ZP® Finally¬ � |
|||
ZÐ contentó wilì remaiî preserveä iæ yoõ reenteò iô usinç thå JUMÐ (tï thå � |
|||
loaä addresó displayeä iî thå signoî banner© command¬ assuminç thaô yoõ � |
|||
haven'ô overwritteî thå ZÐ locations. |
|||
|
|||
Thå seconä ZÐ statuó linå displayó thå thå origiî oæ thå current cacheä � |
|||
record® Copyinç á recorä intï thå cachå wilì overwritå thå previouó � |
|||
contentó oæ thå cache® Performinç á cachå copù oò exchangå operatioî � |
|||
automaticallù returnó yoõ tï youò previouó modå anä updateó thå currenô � |
|||
recorä display. |
|||
:N:HP-RPN.HLP |
|||
:H:HP-ZP.HLP |
|||
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -1,4 +0,0 @@ |
|||
b:copy zinstal.zpm a: |
|||
b:copy startzpm.com a: |
|||
zpmldr |
|||
|
|||
Loading…
Reference in new issue