CP/M 3 & ZPM3 Updates

Source/CPM3/Clean.cmd

@@ -3,6 +3,7 @@ setlocal
 
 if exist bios3.spr del bios3.spr
 if exist bnkbios3.spr del bnkbios3.spr
+if exist swpbios3.spr del swpbios3.spr
 if exist *.rel del *.rel
 if exist cpmldr.com del cpmldr.com
 if exist *.err del *.err

Source/CPM3/boot.z80

@@ -12,6 +12,7 @@
 	extrn	dph0
 	extrn	@dtbl,@ctbl
 	extrn	@date,@hour,@min,@sec
+	extrn	@srch1
 	
 	include	ver.inc
 	
@@ -196,6 +197,7 @@ dinit6a:
 	inc	hl			; next byte
 	djnz	dinit6a
 	ret				; finished
+
 dinit7:	; process unit
 	ld	e,0			; initialize slice index
 	ld	b,1			; default loop counter
@@ -247,9 +249,34 @@ stpsiz	equ	$ - stpimg
     ;	called CCP.COM on the system drive.
 
 ?ldccp:
+
+	if drvswap
+
+	; Swap A: and system drive (make A: the system drive)
+	ld	bc,(@dtbl)		; get drive A DPH
+	ld	hl,@dtbl		; point to boot drive DPH
+	ld	a,(@sysdr)
+	rlca
+	call	addhla
+	ld	e,(hl)			; set boot drive to drive A DPH
+	ld	(hl),c			; ... and save boot drive DPH
+	inc	hl
+	ld	d,(hl)
+	ld	(hl),b
+	ld	(@dtbl),de		; set drive a DPH to boot drive
+	
+	xor	a			; update @sysdr
+	ld	(@sysdr),a
+	
+	endif
+	
+	; Force CCP to use system boot drive as initial default
+	ld	a,(@sysdr)		; get system boot drive
+	ld	(@ccpdr),a		; set CCP current drive
+
 	; First time, load the CCP.COM file into TPA
 	ld	a,(@sysdr)		; get system boot drive
-	;ld	(4),a			; save in page zero (zpm?)
+	;ld	(4),a			; save in page zero???
 	inc	a			; drive + 1 for FCB
 	ld	(ccp$fcb),a		; stuff into FCB
 	add	'A' - 1			; drive letter
@@ -310,9 +337,13 @@ ld$1:
 	
 	endif
 	
-	; Force CCP to use system boot drive as initial default
-	ld	a,(@sysdr)		; get system boot drive
-	ld	(@ccpdr),a		; set CCP current drive
+	;; Set first search path to system boot drive
+	;inc	a
+	;ld	(@srch1),a
+	
+	;ld	e,a
+	;ld	c,14
+	;call	bdos
 
 	ret
 
@@ -367,11 +398,23 @@ rl$1:
 	push	hl
 	push	de
 	
+	; force return through time$ret
+	ld	hl,time$ret
+	push	hl
+	
 	; branch to get or set routine
 	ld	a,c		; get switch value
 	or	a		; test for zero
-	jr	nz,time$set	; 0 means get time, else set time
+	jr	z,time$get	; 0 means get time
+	jr	time$set	; else set time
+
+time$ret:
+	; restore HL, DE
+	pop	de
+	pop	hl
+	ret
 
+time$get:
 	; RTC -> cpm date/time in SCB
 	
 	; read time from RTC
@@ -390,7 +433,7 @@ rl$1:
 	ld	a,(tim$sec)	; get second from time buf
 	ld	(@sec),a        ; ... and put in SCB
 	
-	jr	time$ret
+	ret
 
 time$set:
 	; CPM date/time in SCB -> RTC
@@ -411,15 +454,8 @@ time$set:
 	ld	hl,tim$buf	; ... from time buffer
 	rst	08		; do it
 	
-	jr	time$ret
-
-time$ret:
-	; restore HL, DE
-	pop	de
-	pop	hl
 	ret
 
-
 date2cpm:
 	; Convert YYMMSS from time buffer at HL
 	; into offset from CPM epoch and store

Source/CPM3/genbnk.dat

@@ -3,7 +3,7 @@ PAGWID   = 4F
 PAGLEN   = 17
 BACKSPC  = N
 RUBOUT   = N
-BOOTDRV  = C
+BOOTDRV  = A
 MEMTOP   = FD
 BNKSWT   = Y
 COMBAS   = 80

Source/CPM3/genres.dat

@@ -3,7 +3,7 @@ PAGWID   = 4F
 PAGLEN   = 17
 BACKSPC  = N
 RUBOUT   = N
-BOOTDRV  = C
+BOOTDRV  = A
 MEMTOP   = FD
 BNKSWT   = N
 COMBAS   = 00

Source/CPM3/optbnk.lib

@@ -4,3 +4,5 @@ true	equ -1
 false	equ not true
 
 banked	equ true
+
+drvswap	equ false

Source/CPM3/optres.lib

@@ -4,3 +4,5 @@ true	equ -1
 false	equ not true
 
 banked	equ false
+
+drvswap	equ false

Source/CPM3/optswp.lib

@@ -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

Source/CPM3/scb.asm

@@ -5,6 +5,7 @@
         public @mltio, @ermde, @erdsk, @media, @bflgs
 	public @date, @hour, @min, @sec, ?erjmp, @mxtpa
 	public @ccpdr
+	public @srch1, @srch2, @srch3, @srch4
 
 
 scb$base equ    0FE00H          ; Base of the SCB
@@ -34,6 +35,10 @@ scb$base equ    0FE00H          ; Base of the SCB
 @MLTIO	equ	scb$base+4Ah	; Current Multi-Sector Count
 				; (byte,r/w)
 @ERMDE  equ     scb$base+4Bh    ; BDOS Error Mode (byte, r/o)
+@SRCH1	equ	scb$base+4Ch	; BDOS Drive Search Chain 1
+@SRCH2	equ	scb$base+4Dh	; BDOS Drive Search Chain 2
+@SRCH3	equ	scb$base+4Eh	; BDOS Drive Search Chain 3
+@SRCH4	equ	scb$base+4Fh	; BDOS Drive Search Chain 4
 @ERDSK	equ	scb$base+51h	; BDOS Error Disk (byte,r/o)
 @MEDIA	equ	scb$base+54h	; Set by BIOS to indicate
 				; open door (byte,r/w)

Source/Images/hd_zpm3/s0/u0/WBW.TXT

@@ -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
+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.

Source/Images/hd_zpm3/s0/u10/ALIAS.HLP

@@ -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:
+

Source/Images/hd_zpm3/s0/u10/HP-RPN.HLP

@@ -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
+

Source/Images/hd_zpm3/s0/u10/HP-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
+

Source/Images/hd_zpm3/s0/u10/IF.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.).
+

Source/Images/hd_zpm3/s0/u10/MENU.HLP

@@ -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

Source/Images/hd_zpm3/s0/u10/VLU.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).
+

Source/Images/hd_zpm3/s0/u10/ZFHIST.HLP

@@ -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.
+ 

Source/Images/hd_zpm3/s0/u10/ZFILER.HLP

@@ -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.
+

Source/Images/hd_zpm3/s0/u10/ZFMACRO.HLP

@@ -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
+

Source/Images/hd_zpm3/s0/u10/ZP.HLP

@@ -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
+

Source/ZPM3/Build.cmd

@@ -13,11 +13,12 @@ copy ..\ZCCP\ccp.com .
 copy ..\ZCCP\zinstal.zpm .
 copy ..\ZCCP\startzpm.com .
 copy ..\CPM3\genbnk.dat .
-rem copy ..\CPM3\bios3.spr .
-copy ..\CPM3\bnkbios3.spr .
+copy ..\CPM3\swpbios3.spr bnkbios3.spr
 copy ..\CPM3\gencpm.com .
 copy ..\CPM3\biosldr.rel .
 
+copy ..\CPM3\cpmldr.com .
+
 rem ZPM Loader
 echo.
 echo.
@@ -54,7 +55,7 @@ for %%f in (
   makedos.com
   bnkbdos3.spr
   resbdos3.spr
-  zpm3.sub
+  cpmldr.com
 ) do call :upd_img %%f
 goto :eof
 

Source/ZPM3/Clean.cmd

@@ -12,6 +12,7 @@ if exist system.odd del system.odd
 if exist biosldr.rel del biosldr.rel
 if exist *.sym del *.sym
 if exist zpmldr.com del zpmldr.com
+if exist cpmldr.com del cpmldr.com
 if exist startzpm.com del startzpm.com
 if exist gencpm.com del gencpm.com
 if exist *.dat del *.dat

Source/ZPM3/zpm3.sub

@@ -1,4 +0,0 @@
-b:copy zinstal.zpm a:
-b:copy startzpm.com a:
-zpmldr
-