mirror of https://github.com/wwarthen/RomWBW.git
wayne
13 years ago
153 changed files with 5709 additions and 807 deletions
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -0,0 +1,564 @@ |
|||
|
|||
DDTZ v2.7 |
|||
by C.B. Falconer |
|||
edited by George A. Havach |
|||
|
|||
Introduction: |
|||
============ |
|||
DDTZ v2.7 is a complete replacement for DDT, Digital Research's |
|||
famous Dynamic Debugging Tool, with improved functionality, bug |
|||
extermination, and full Z80 support. In general, DDTZ is fully |
|||
compatible with the original utility, but it has extra and |
|||
extended commands and many fewer quirks. All Z80-specific |
|||
instructions can be (dis)assembled, though in Intel rather then |
|||
Zilog format. Furthermore, DDTZ will correctly trace ('T' and 'U' |
|||
commands) both 8080 and Z80 instructions, depending on which CPU |
|||
is operating. On startup, the program announces which CPU it is |
|||
running on. |
|||
|
|||
DDTZ v2.7 now handles the 64180 added opcodes. It does NOT test |
|||
for a 64180 CPU, since this cannot be done without executing |
|||
illegal Z80 instructions, which in turn will crash some |
|||
simulators. However v2.7 does not execute any 64180 instructions |
|||
internally, only in the subject program. |
|||
|
|||
This issue supplies the "M" version assembled, to avoid errors |
|||
when switching between MSDOS and CPM systems. The command table |
|||
is updated accordingly. Most CPM users are also MSDOS users, but |
|||
not vice-versa. |
|||
|
|||
The program is invoked by typing |
|||
|
|||
ddtz<ret> |
|||
or |
|||
ddtz [d:]filespec<ret> |
|||
|
|||
In the second form, DDTZ will load the specified file into |
|||
memory starting at 0100H, unless it's a .HEX file that sets its |
|||
own load address. Besides reporting the NEXT free address and |
|||
the PC (program counter) after a successful load, DDTZ also shows |
|||
the number of memory pages needed for a SAVE. Instead of having |
|||
to write all this down, just use the 'X' command at any time to |
|||
redisplay these three values for the current application. |
|||
|
|||
NOTE: loading more code above the NEXT pointer revises these |
|||
values. |
|||
|
|||
As in DDT, when a program is loaded above the area holding the |
|||
'A' and 'U' (and now 'W') command code, these commands are |
|||
disabled, and the extra memory is released to the user. Thus, |
|||
DDTZ can occupy as little as 3K total memory space. Unlike DDT, |
|||
however, DDTZ will not overwrite itself or the system on program |
|||
loads (except .HEX files). |
|||
|
|||
At initialization, the stack pointer (SP) points to a return to |
|||
DDTZ, just like for the CCP. Thus, programs that normally return |
|||
to the CCP will be returned to DDTZ. The 'B' command |
|||
reinitializes this condition. |
|||
|
|||
|
|||
The intercept vector copies the BDOS version number, etc., so |
|||
an object program does not know that DDTZ is running (except |
|||
for BIOS-BDOS vector size). Thus, programs that check the version |
|||
number should execute correctly under DDTZ. |
|||
|
|||
All input parameters can now be entered in any of three formats: |
|||
|
|||
(1) hexadecimal (as in DDT), |
|||
(2) decimal, by adding a leading '#' character, |
|||
(3) ASCII, by enclosing between either single or double |
|||
quotes; either one or two characters are allowed. |
|||
|
|||
Leading blanks in command lines and parameters are absorbed. |
|||
Either a comma or a (single) space is a valid delimiter. |
|||
Either uppercase or lowercase input is accepted. |
|||
|
|||
The default command (for anything not otherwise recognizable) |
|||
is 'H'. This allows convenient calculation, along with the other |
|||
features described below. So, to convert a number, just enter |
|||
it! |
|||
|
|||
As in DDT, the prompt character is '-', and the only error |
|||
message is the query ('?'), which generally kicks you back to |
|||
command mode. |
|||
|
|||
New Commands (Over DDT): |
|||
======================= |
|||
|
|||
NOTE: letters in parenthesis, e.g. "(U)", show the equivalent |
|||
command for DDTZM version (compatible with MSDOS debug). |
|||
|
|||
@ Sets or shows (with no parameter) the internally stored |
|||
"base" value. Also used with the 'S' and 'D' commands as |
|||
an optional parameter (though without the '@') to display |
|||
memory from an arbitrary base marker (offset). When set to |
|||
zero (the default), it does not affect any screen displays. |
|||
|
|||
B B)egin: resets the USER stack pointer to its initial value, |
|||
such that any program that exits by an RET will return to |
|||
DDTZ. DDTZ provides a default stack space of |
|||
approximately 24 bytes for user programs. |
|||
|
|||
C C)ompare first_address,last_address,against_address: shows |
|||
all the byte differences between two memory areas, in the |
|||
format |
|||
|
|||
XXXX aa YYYY bb |
|||
|
|||
where XXXX and YYYY are the comparative memory addresses, |
|||
and aa and bb are the corresponding byte values. Can be |
|||
used to verify the identity of two files by first |
|||
loading them into different memory areas with the 'R' |
|||
command (see below). |
|||
|
|||
|
|||
W Write: stores the modified memory area to disk under the |
|||
(K) filename specified by the 'I' command, overwriting the |
|||
original file from which it was loaded (the user is queried |
|||
before doing so). By default, the image of memory from |
|||
0100H through the "NEXT" value -1 is saved. "K first_addr, |
|||
last_address" overrides this and allows writing ANY memory |
|||
area to a file. Almost a necessity for CPM 3.0 (no SAVE!). |
|||
K)eep on DDTZ |
|||
|
|||
X eXamine: redisplays the "NEXT PC SAVE" report at any time. |
|||
(Q) Q)uery size on DDTZ. |
|||
|
|||
S S)earch first_address, last_addr, value: searches the |
|||
(W) specified memory area for the value (a 16-bit word, not a |
|||
byte) and shows the locations of all such. Very useful for |
|||
finding CALL's or JMP's to a particular address, etc. |
|||
W)here on DDTZ |
|||
|
|||
Y Y)our_option parm1,parm2,address: executes an arbitrary |
|||
routine at the specified address, with the BC and DE |
|||
registers set to parm1 and parm2, respectively. |
|||
|
|||
Z Displays (but does not alter) the Z80's alternate register |
|||
set, including the index registers (disabled if running on |
|||
an 8080). On Z80's, automatically included as the last |
|||
part of the display by the 'X' command. |
|||
|
|||
|
|||
Based (Offset) Displays: |
|||
======================= |
|||
|
|||
The 'D' and 'E' commands can use a stored base value (offset), |
|||
as set by the '@' command. The current @ value may be |
|||
overridden for a single execution of these commands by adding the |
|||
base as an extra parameter in the command line. The effect is |
|||
to add this value to the first/last address and display |
|||
accordingly. The address listing on the left becomes XXXX:YYYY, |
|||
where XXXX is the offset address and YYYY is the actual memory |
|||
address being displayed. For example, if you have a data area |
|||
located at 42B7H and wish to preserve easy access, just enter |
|||
"@42b7". Now, "d0,3f" will dump memory starting at 4237H. |
|||
|
|||
|
|||
Further Changes from DDT: |
|||
======================== |
|||
|
|||
A A)ssemble now accepts the full Z80 as well as 8080 |
|||
instruction set, although it expects them in Intel rather |
|||
than Zilog format (see notes below under the 'L' |
|||
command). When in doubt, see the mnemnonic list below. |
|||
|
|||
D D)isplay or D)ump will accept an optional third parameter |
|||
to set the base value for a single execution only. Format |
|||
has been cleaned up. |
|||
|
|||
H H)ex_arithmetic on two values also shows their |
|||
difference in decimal. With only one value, converts to |
|||
hexadecimal, decimal, and ASCII (low-order byte only). |
|||
|
|||
|
|||
N N)ame now allows drive specification (d:...) and sets up |
|||
(I) the complete command line, including both FCB's (at |
|||
addresses 005CH and 006CH). The tail (stored at 0081H up) |
|||
is NOT upshifted. |
|||
I)nput on DDTZ |
|||
|
|||
U U)nassemble now displays the raw hexcode, especially handy |
|||
(L) when examining non-code areas. Intel (8080 style) mnemonics |
|||
are used, so some disassembled instructions may look |
|||
strange. E.g., the Z80's 'IN B,(C)' and 'OUT (C),B' become |
|||
'INP B' and 'OUTP B', respectively; 'LD (nnnn),BC' becomes |
|||
'SBCD nnnn', 'ADD IX, BC' becomes 'DADX B', and 'JP (IX)' |
|||
becomes 'PCIX'. |
|||
L)ist on DDTZ |
|||
|
|||
L L)oad now permits loading a file into memory with an |
|||
(R) offset, which is added to the default load address of |
|||
0100H. When reading in a .HEX file with a preset bias, |
|||
the 'R' command will not transfer control to an invalid |
|||
execution point. Another execution of the 'R' command will |
|||
reread the input file, e.g.: |
|||
|
|||
n blah<ret> |
|||
l<ret> |
|||
...modify the code and generally mess about... |
|||
l<ret> |
|||
|
|||
The original file is reloaded, and the modifications are |
|||
removed. |
|||
R)ead on DDTZ |
|||
|
|||
E E)nter, like D)isplay, now accepts an optional second |
|||
(S) parameter to set the base value for a single execution |
|||
only. |
|||
S)ubstitute or S)et on DDTZ |
|||
|
|||
T T)rap/trace on termination now shows the complete CPU |
|||
state. Traps and traces no longer lock up when a user RST |
|||
7 instruction is executed. Tracing of BDOS/BIOS calls is |
|||
heavily trun cated, avoiding clutter and preventing system |
|||
crashes. |
|||
|
|||
NOTE: Most of the UNDOCUMENTED Z80 op-codes are handled. Others |
|||
can crash the system. |
|||
|
|||
R R)egisters also shows what two-byte values the HL and SP |
|||
(X) registers are actually pointing to. On Z80's, displays the |
|||
alternate register set. |
|||
eX)amine on DDTZ |
|||
|
|||
NOTE: Any use of the 'W' or 'L' command resets the system DMA |
|||
transfer address to the standard default value of 0080H. |
|||
|
|||
|
|||
; This is the output of DDTZ when disassembling OPTYPE.TRY |
|||
NOP LDA 06A4 MOV M,H |
|||
LXI B,06A4 DCX SP MOV M,L |
|||
STAX B INR A HLT |
|||
INX B DCR A MOV M,A |
|||
INR B MVI A,20 MOV A,B |
|||
DCR B CMC MOV A,C |
|||
MVI B,20 MOV B,B MOV A,D |
|||
RLC MOV B,C MOV A,E |
|||
EXAF MOV B,D MOV A,H |
|||
DAD B MOV B,E MOV A,L |
|||
LDAX B MOV B,H MOV A,M |
|||
DCX B MOV B,L MOV A,A |
|||
INR C MOV B,M ADD B |
|||
DCR C MOV B,A ADD C |
|||
MVI C,20 MOV C,B ADD D |
|||
RRC MOV C,C ADD E |
|||
DJNZ 0134 MOV C,D ADD H |
|||
LXI D,06A4 MOV C,E ADD L |
|||
STAX D MOV C,H ADD M |
|||
INX D MOV C,L ADD A |
|||
INR D MOV C,M ADC B |
|||
DCR D MOV C,A ADC C |
|||
MVI D,20 MOV D,B ADC D |
|||
RAL MOV D,C ADC E |
|||
JR 0134 MOV D,D ADC H |
|||
DAD D MOV D,E ADC L |
|||
LDAX D MOV D,H ADC M |
|||
DCX D MOV D,L ADC A |
|||
INR E MOV D,M SUB B |
|||
DCR E MOV D,A SUB C |
|||
MVI E,20 MOV E,B SUB D |
|||
RAR MOV E,C SUB E |
|||
JRNZ 0134 MOV E,D SUB H |
|||
LXI H,06A4 MOV E,E SUB L |
|||
SHLD 06A4 MOV E,H SUB M |
|||
INX H MOV E,L SUB A |
|||
INR H MOV E,M SBB B |
|||
DCR H MOV E,A SBB C |
|||
MVI H,20 MOV H,B SBB D |
|||
DAA MOV H,C SBB E |
|||
JRZ 0134 MOV H,D SBB H |
|||
DAD H MOV H,E SBB L |
|||
LHLD 06A4 MOV H,H SBB M |
|||
DCX H MOV H,L SBB A |
|||
INR L MOV H,M ANA B |
|||
DCR L MOV H,A ANA C |
|||
MVI L,20 MOV L,B ANA D |
|||
CMA MOV L,C ANA E |
|||
JRNC 0134 MOV L,D ANA H |
|||
LXI SP,06A4 MOV L,E ANA L |
|||
STA 06A4 MOV L,H ANA M |
|||
INX SP MOV L,L ANA A |
|||
INR M MOV L,M XRA B |
|||
DCR M MOV L,A XRA C |
|||
MVI M,20 MOV M,B XRA D |
|||
STC MOV M,C XRA E |
|||
JRC 0134 MOV M,D XRA H |
|||
DAD SP MOV M,E XRA L |
|||
|
|||
|
|||
XRA M JPE 06A4 SLAR M |
|||
XRA A XCHG SLAR A |
|||
ORA B CPE 06A4 SRAR B |
|||
ORA C XRI 20 SRAR C |
|||
ORA D RST 5 SRAR D |
|||
ORA E RP SRAR E |
|||
ORA H POP PSW SRAR H |
|||
ORA L JP 06A4 SRAR L |
|||
ORA M DI SRAR M |
|||
ORA A CP 06A4 SRAR A |
|||
CMP B PUSH PSW SLLR B |
|||
CMP C ORI 20 SLLR C |
|||
CMP D RST 6 SLLR D |
|||
CMP E RM SLLR E |
|||
CMP H SPHL SLLR H |
|||
CMP L JM 06A4 SLLR L |
|||
CMP M EI SLLR M |
|||
CMP A CM 06A4 SLLR A |
|||
RNZ CPI 20 SRLR B |
|||
POP B RST 7 SRLR C |
|||
JNZ 06A4 RLCR B SRLR D |
|||
JMP 06A4 RLCR C SRLR E |
|||
CNZ 06A4 RLCR D SRLR H |
|||
PUSH B RLCR E SRLR L |
|||
ADI 20 RLCR H SRLR M |
|||
RST 0 RLCR L SRLR A |
|||
RZ RLCR M BIT 0,B |
|||
RET RLCR A BIT 0,C |
|||
JZ 06A4 RRCR B BIT 0,D |
|||
CZ 06A4 RRCR C BIT 0,E |
|||
CALL 06A4 RRCR D BIT 0,H |
|||
ACI 20 RRCR E BIT 0,L |
|||
RST 1 RRCR H BIT 0,M |
|||
RNC RRCR L BIT 0,A |
|||
POP D RRCR M BIT 1,B |
|||
JNC 06A4 RRCR A BIT 1,C |
|||
OUT 20 RALR B BIT 1,D |
|||
CNC 06A4 RALR C BIT 1,E |
|||
PUSH D RALR D BIT 1,H |
|||
SUI 20 RALR E BIT 1,L |
|||
RST 2 RALR H BIT 1,M |
|||
RC RALR L BIT 1,A |
|||
EXX RALR M BIT 2,B |
|||
JC 06A4 RALR A BIT 2,C |
|||
IN 20 RARR B BIT 2,D |
|||
CC 06A4 RARR C BIT 2,E |
|||
SBI 20 RARR D BIT 2,H |
|||
RST 3 RARR E BIT 2,L |
|||
RPO RARR H BIT 2,M |
|||
POP H RARR L BIT 2,A |
|||
JPO 06A4 RARR M BIT 3,B |
|||
XTHL RARR A BIT 3,C |
|||
CPO 06A4 SLAR B BIT 3,D |
|||
PUSH H SLAR C BIT 3,E |
|||
ANI 20 SLAR D BIT 3,H |
|||
RST 4 SLAR E BIT 3,L |
|||
RPE SLAR H BIT 3,M |
|||
PCHL SLAR L BIT 3,A |
|||
|
|||
|
|||
BIT 4,B RES 3,D SET 2,H |
|||
BIT 4,C RES 3,E SET 2,L |
|||
BIT 4,D RES 3,H SET 2,M |
|||
BIT 4,E RES 3,L SET 2,A |
|||
BIT 4,H RES 3,M SET 3,B |
|||
BIT 4,L RES 3,A SET 3,C |
|||
BIT 4,M RES 4,B SET 3,D |
|||
BIT 4,A RES 4,C SET 3,E |
|||
BIT 5,B RES 4,D SET 3,H |
|||
BIT 5,C RES 4,E SET 3,L |
|||
BIT 5,D RES 4,H SET 3,M |
|||
BIT 5,E RES 4,L SET 3,A |
|||
BIT 5,H RES 4,M SET 4,B |
|||
BIT 5,L RES 4,A SET 4,C |
|||
BIT 5,M RES 5,B SET 4,D |
|||
BIT 5,A RES 5,C SET 4,E |
|||
BIT 6,B RES 5,D SET 4,H |
|||
BIT 6,C RES 5,E SET 4,L |
|||
BIT 6,D RES 5,H SET 4,M |
|||
BIT 6,E RES 5,L SET 4,A |
|||
BIT 6,H RES 5,M SET 5,B |
|||
BIT 6,L RES 5,A SET 5,C |
|||
BIT 6,M RES 6,B SET 5,D |
|||
BIT 6,A RES 6,C SET 5,E |
|||
BIT 7,B RES 6,D SET 5,H |
|||
BIT 7,C RES 6,E SET 5,L |
|||
BIT 7,D RES 6,H SET 5,M |
|||
BIT 7,E RES 6,L SET 5,A |
|||
BIT 7,H RES 6,M SET 6,B |
|||
BIT 7,L RES 6,A SET 6,C |
|||
BIT 7,M RES 7,B SET 6,D |
|||
BIT 7,A RES 7,C SET 6,E |
|||
RES 0,B RES 7,D SET 6,H |
|||
RES 0,C RES 7,E SET 6,L |
|||
RES 0,D RES 7,H SET 6,M |
|||
RES 0,E RES 7,L SET 6,A |
|||
RES 0,H RES 7,M SET 7,B |
|||
RES 0,L RES 7,A SET 7,C |
|||
RES 0,M SET 0,B SET 7,D |
|||
RES 0,A SET 0,C SET 7,E |
|||
RES 1,B SET 0,D SET 7,H |
|||
RES 1,C SET 0,E SET 7,L |
|||
RES 1,D SET 0,H SET 7,M |
|||
RES 1,E SET 0,L SET 7,A |
|||
RES 1,H SET 0,M DADX B |
|||
RES 1,L SET 0,A DADX D |
|||
RES 1,M SET 1,B LXI X,06A4 |
|||
RES 1,A SET 1,C SIXD 06A4 |
|||
RES 2,B SET 1,D INX X |
|||
RES 2,C SET 1,E DADX X |
|||
RES 2,D SET 1,H LIXD 06A4 |
|||
RES 2,E SET 1,L DCX X |
|||
RES 2,H SET 1,M INR [X+05] |
|||
RES 2,L SET 1,A DCR [X+05] |
|||
RES 2,M SET 2,B MVI [X+05],20 |
|||
RES 2,A SET 2,C DADX SP |
|||
RES 3,B SET 2,D MOV B,[X+05] |
|||
RES 3,C SET 2,E MOV C,[X+05] |
|||
|
|||
|
|||
MOV D,[X+05] DSBC B DADY B |
|||
MOV E,[X+05] SBCD 06A4 DADY D |
|||
MOV H,[X+05] NEG LXI Y,06A4 |
|||
MOV L,[X+05] RETN SIYD 06A4 |
|||
MOV [X+05],B IM0 INX Y |
|||
MOV [X+05],C LDIA DADY Y |
|||
MOV [X+05],D INP C LIYD 06A4 |
|||
MOV [X+05],E OUTP C DCX Y |
|||
MOV [X+05],H DADC B INR [Y+05] |
|||
MOV [X+05],L LBCD 06A4 DCR [Y+05] |
|||
MOV [X+05],A RETI MVI [Y+05],2 |
|||
MOV A,[X+05] LDRA DADY SP |
|||
ADD [X+05] INP D MOV B,[Y+05] |
|||
ADC [X+05] OUTP D MOV C,[Y+05] |
|||
SUB [X+05] DSBC D MOV D,[Y+05] |
|||
SBB [X+05] SDED 06A4 MOV E,[Y+05] |
|||
ANA [X+05] IM1 MOV H,[Y+05] |
|||
XRA [X+05] LDAI MOV L,[Y+05] |
|||
ORA [X+05] INP E MOV [Y+05],B |
|||
CMP [X+05] OUTP E MOV [Y+05],C |
|||
POP X DADC D MOV [Y+05],D |
|||
XTIX LDED 06A4 MOV [Y+05],E |
|||
PUSH X IM2 MOV [Y+05],H |
|||
PCIX LDAR MOV [Y+05],L |
|||
SPIX INP H MOV [Y+05],A |
|||
RLCR [X+05] OUTP H MOV A,[Y+05] |
|||
RRCR [X+05] DSBC H ADD [Y+05] |
|||
RALR [X+05] shld 06A4 ADC [Y+05] |
|||
RARR [X+05] RRD SUB [Y+05] |
|||
SLAR [X+05] INP L SBB [Y+05] |
|||
SRAR [X+05] OUTP L ANA [Y+05] |
|||
SRLR [X+05] DADC H XRA [Y+05] |
|||
BIT 0,[X+05] lhld 06A4 ORA [Y+05] |
|||
BIT 1,[X+05] RLD CMP [Y+05] |
|||
BIT 2,[X+05] INP M POP Y |
|||
BIT 3,[X+05] OUTP M XTIY |
|||
BIT 4,[X+05] DSBC SP PUSH Y |
|||
BIT 5,[X+05] SSPD 06A4 PCIY |
|||
BIT 6,[X+05] INP A SPIY |
|||
BIT 7,[X+05] OUTP A RLCR [Y+05] |
|||
RES 0,[X+05] DADC SP RRCR [Y+05] |
|||
RES 1,[X+05] LSPD 06A4 RALR [Y+05] |
|||
RES 2,[X+05] LDI RARR [Y+05] |
|||
RES 3,[X+05] CCI SLAR [Y+05] |
|||
RES 4,[X+05] INI SRAR [Y+05] |
|||
RES 5,[X+05] OTI SRLR [Y+05] |
|||
RES 6,[X+05] LDD BIT 0,[Y+05] |
|||
RES 7,[X+05] CCD BIT 1,[Y+05] |
|||
SET 0,[X+05] IND BIT 2,[Y+05] |
|||
SET 1,[X+05] OTD BIT 3,[Y+05] |
|||
SET 2,[X+05] LDIR BIT 4,[Y+05] |
|||
SET 3,[X+05] CCIR BIT 5,[Y+05] |
|||
SET 4,[X+05] INIR BIT 6,[Y+05] |
|||
SET 5,[X+05] OTIR BIT 7,[Y+05] |
|||
SET 6,[X+05] LDDR RES 0,[Y+05] |
|||
SET 7,[X+05] CCDR RES 1,[Y+05] |
|||
INP B INDR RES 2,[Y+05] |
|||
OUTP B OTDR RES 3,[Y+05] |
|||
|
|||
|
|||
RES 4,[Y+05] SET 0,[Y+05] SET 4,[Y+05] |
|||
RES 5,[Y+05] SET 1,[Y+05] SET 5,[Y+05] |
|||
RES 6,[Y+05] SET 2,[Y+05] SET 6,[Y+05] |
|||
RES 7,[Y+05] SET 3,[Y+05] SET 7,[Y+05] |
|||
|
|||
; These are the result of disassembling 64180OPS.TRY |
|||
; These opcodes are available ONLY on the 64180 CPU |
|||
; DDTZ will both assemble and disassemble these. |
|||
IN0 B,20 TST E MLT B |
|||
OUT0 20,B IN0 H,20 MLT D |
|||
TST B OUT0 20,H TSTI 20 |
|||
IN0 C,20 TST H MLT H |
|||
OUT0 20,C IN0 L,20 TSIO 20 |
|||
TST C OUT0 20,L SLP |
|||
IN0 D,20 TST L MLT SP |
|||
OUT0 20,D TST M OTIM |
|||
TST D IN0 A,20 OTDM |
|||
IN0 E,20 OUT0 20,A OIMR |
|||
OUT0 20,E TST A ODMR |
|||
|
|||
; The following are UNDOCUMENTED z80 opcodes from XTDOPS.TRY. |
|||
; DDTZ will disassemble these, but will not assemble them. |
|||
; They use xh/xl (or yh/yl) as separate byte registers. |
|||
; Use these at your own risk. |
|||
INRX H ACXR H MOVY H,B |
|||
DCRX H ACXR L MOVY H,C |
|||
MVIX H,20 SUXR H MOVY H,D |
|||
INRX L SUXR L MOVY H,E |
|||
DCRX L SBXR H MOVY H,A |
|||
MVIX L,20 SBXR L MOVY L,B |
|||
MOVX B,H NDXR H MOVY L,C |
|||
MOVX B,L NDXR L MOVY L,D |
|||
MOVX C,H XRXR H MOVY L,E |
|||
MOVX C,L XRXR L MOVY L,A |
|||
MOVX D,H ORXR H MOVY A,H |
|||
MOVX D,L ORXR L MOVY A,L |
|||
MOVX E,H CPXR H ADYR H |
|||
MOVX E,L CPXR L ADYR L |
|||
MOVX H,B INRY H ACYR H |
|||
MOVX H,C DCRY H ACYR L |
|||
MOVX H,D MVIY H,20 SUYR H |
|||
MOVX H,E INRY L SUYR L |
|||
MOVX H,A DCRY L SBYR H |
|||
MOVX L,B MVIY L,20 SBYR L |
|||
MOVX L,C MOVY B,H NDYR H |
|||
MOVX L,D MOVY B,L NDYR L |
|||
MOVX L,E MOVY C,H XRYR H |
|||
MOVX L,A MOVY C,L XRYR L |
|||
MOVX A,H MOVY D,H ORYR H |
|||
MOVX A,L MOVY D,L ORYR L |
|||
ADXR H MOVY E,H CPYR H |
|||
ADXR L MOVY E,L CPYR L |
|||
|
|||
|
|||
Command Summary: |
|||
=============== |
|||
|
|||
DDTZM command DDTZ command |
|||
============= ============ |
|||
@ (base) |
|||
A)ssemble first_address A |
|||
B)egin {i.e., initialize stack and return} B |
|||
C)ompare first_address,last_address,against_address C |
|||
D)ump first_address[,last_address[,base]] D |
|||
E)nter_in_memory first_address[,base] S)ubstitute |
|||
F)ill first_address,last_address,value F |
|||
G)o_to [address][,trap1[,trap2]] G |
|||
H)ex_arithmetic value1(,value2) H |
|||
L)oad_file (offset) R)ead |
|||
M)ove first_address,last_address,destination M |
|||
N)nput FCBs_command_line I)nput |
|||
Q)uit (not avail) |
|||
R)egister examine/change [register|flag] X)amine |
|||
S)earch first_address,last_address,word W)hereis |
|||
T)race_execution [count] T |
|||
Untrace_execution [count] (i.e. do count instr) U)ntrace |
|||
U)nassemble_code first_address[,last_address] L)ist code |
|||
W)rite [first_address,last_address] K)eep |
|||
X)amine {i.e. display memory parameters for application} Q)uery |
|||
Y)our_option BC:=parm1,DE:=parm2,call_address Y |
|||
Z)80_register_display Z |
|||
|
|||
|
|||
If you find this program useful, contributions will be gratefully |
|||
accepted and will encourage further development and release of |
|||
useful CPM programs. My practice is to include source. |
|||
|
|||
C.B. Falconer |
|||
680 Hartford Turnpike, |
|||
Hamden, Conn. 06517 (203) 281-1438 |
|||
|
|||
DDTZ and its associated documentation and other files are |
|||
copyright (c) 1980-1988 by C.B. Falconer. They may be freely |
|||
copied and used for non-commercial purposes ONLY. |
|||
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -0,0 +1,134 @@ |
|||
SAMPKEY.DOC: |
|||
Sample Macros for ZDE, 01 June 90 by Carson Wilson. |
|||
|
|||
This file describes the sample macros contained in SAMPKEY.ZDK |
|||
and SAMPKEY.ZDT. As distributed, ZDE contains no Macro Key |
|||
definitions. I have included the SAMPKEY.* files both to give |
|||
you an idea of the versatility available through ZDE's macro |
|||
capability and to provide you with some useful choresaving |
|||
routines. Many of the sample Macros come directly from the ZDE |
|||
Manual, and illustrate the use of conditional testing, jumps, and |
|||
control key entry from within Macros. In addition to being |
|||
educational, most of these "sample" Macros do useful work. While |
|||
you may (and should) define ZDE's Macros to do anything you wish |
|||
(or nothing, if you wish), I think you may find one or more of |
|||
these samples useful just as they are. |
|||
|
|||
To install the macros in SAMPKEY.ZDK (or any .ZDK file) into your |
|||
copy of ZDE, just type "ZDENSTAL ZDE SAMPKEY.ZDK." Then exit |
|||
ZDENSTAL with the <S>ave option. This produces a working copy of |
|||
ZDE.COM with Macro Keys 0 to 9 as defined in the .ZDK file. |
|||
|
|||
To alter or replace the Macros in SAMPKEY.ZDK, first edit the |
|||
text file SAMPKEY.ZDT with ZDE. Then translate SAMPKEY.ZDT into |
|||
a new macro file with the command "ZDKCOM SAMPKEY.ZDT." You can |
|||
also translate .ZDK files back into .ZDT files if you wish; see |
|||
ZDKCOM.DOC for more information. |
|||
|
|||
The following briefly describes each of the Macros in the SAMPKEY |
|||
files: |
|||
|
|||
|
|||
MACRO 0 - SWAP CHARACTERS. |
|||
|
|||
Macro Text: |
|||
q^S^S^G^D^U^U^D^G |
|||
|
|||
Purpose: |
|||
Swaps the character behind the cursor with the previous |
|||
character. Useful for catching typos. |
|||
|
|||
|
|||
MACRO 1 - SOFTEN PARAGRAPH. |
|||
|
|||
Macro Text: |
|||
q^QS^X^[=^M]^S^V ^V^D^[![ |
|||
|
|||
Purpose: |
|||
"Softens" Hard Carriage Returns from the line the cursor |
|||
is on to the end of the paragraph. This allows |
|||
reformatting with ^B of files from other word |
|||
processors. |
|||
|
|||
|
|||
MACRO 2 - MOVE TO START OF SENTENCE. |
|||
|
|||
Macro Text: |
|||
q^[~.1^S^[1^[~.<^[2^D^[= 2^[=^M2 |
|||
|
|||
Purpose: |
|||
Moves the cursor to the beginning of the sentance the |
|||
cursor is currently on. |
|||
|
|||
|
|||
MACRO 3 - MOVE TO START OF PARAGRAPH. |
|||
|
|||
Macro Text: |
|||
q^QS^S^S^[= [^D^D |
|||
|
|||
Purpose: |
|||
Moves the cursor to the beginning of the paragraph the |
|||
cursor is currently on. |
|||
|
|||
|
|||
MACRO 4 - REFORM AND RETURN. |
|||
|
|||
Macro Text: |
|||
q^B^QP |
|||
|
|||
Purpose: |
|||
Reformat beginning with the line the cursor is on and |
|||
return cursor to current location. Useful when |
|||
revising text in the middle of a paragraph. |
|||
|
|||
|
|||
MACRO 5 - BROWSE FILE. |
|||
|
|||
Macro Text: |
|||
n^[;^C^[![ |
|||
|
|||
Purpose: |
|||
Move through file a screen at a time. Press ESC to |
|||
stop. |
|||
|
|||
|
|||
MACRO 6 - DELETE WORD LEFT. |
|||
|
|||
Macro Text: |
|||
n^A^T |
|||
|
|||
Purpose: |
|||
Erases the word to the left of the cursor. |
|||
|
|||
|
|||
MACRO 7 - UNDERLINE WORD RIGHT. |
|||
|
|||
Macro Text: |
|||
n^V^PS^F^PS |
|||
|
|||
Purpose: |
|||
Brackets the word to the right of the cursor with the |
|||
control code ^S, causing the word to be underlined when |
|||
printed (NOTE: printer must be installed). |
|||
|
|||
|
|||
MACRO 8 - SWAP LINES. |
|||
|
|||
Macro Text: |
|||
q^QS^KB^S^X^KK^S^E^E^KV |
|||
|
|||
Purpose: |
|||
Swaps the current line with the previous line, moving |
|||
the cursor with it. Can be used to move a single line |
|||
up any distance within your file. |
|||
|
|||
|
|||
MACRO 9 - HELP MESSAGE. |
|||
|
|||
Macro Text: n^QE^QS^N^N0=SwCh 1=Soft 2=SentBg 3=ParaBg |
|||
4=Reform 5=Browse 6=DelLft 7=Undl 8=SwLn 9=Hlp |
|||
^[;^[;^[;^Y^Y^QP |
|||
|
|||
Purpose: |
|||
Briefly displays help message at top of screen. |
|||
|
|||
Binary file not shown.
@ -0,0 +1,11 @@ |
|||
q^S^S^G^D^U^U^D^G |
|||
q^QS^X^[=^M]^S^V ^V^D^[![ |
|||
q^[~.1^S^[1^[~.<^[2^D^[= 2^[=^M2 |
|||
q^QS^S^S^[= [^D^D |
|||
q^B^QP |
|||
n^[;^C^[![ |
|||
n^A^T |
|||
n^V^PS^F^PS |
|||
q^QS^KB^S^X^KK^S^E^E^KV |
|||
n^QE^QS^N^N0=SwCh 1=Soft 2=SentBg 3=ParaBg 4=Reform 5=Browse 6=DelLft 7=Undl 8=SwLn 9=Hlp ^[;^[;^[;^Y^Y^QP |
|||
|
|||
File diff suppressed because it is too large
@ -0,0 +1,7 @@ |
|||
Z-System Display Editor is Eric Meyer's famous VDE improved and |
|||
enhanced for Z-System. ZCPR named directory and line queue |
|||
capabilities, preserves file datestamps and runs faster under ZSDOS, |
|||
improved install program and documentation, and key compiler |
|||
included. Over twenty flaws in VDE 2.66 corrected. Also runs under |
|||
vanilla CP/M 2.2 and CP/M Plus. |
|||
|
|||
@ -0,0 +1,304 @@ |
|||
New in ZDE |
|||
|
|||
Z-System Display Editor |
|||
|
|||
Version 1.0 10 Mar 89 |
|||
|
|||
ZDE and its documentation are copyright 1989 by Carson Wilson, |
|||
all rights reserved. They may not be circulated in any |
|||
incomplete or modified form without written permission of the |
|||
author. Any commercial use of ZDE, defined as any situation |
|||
where the duplicator receives revenue by duplicating or |
|||
distributing ZDE by itself or in conjunction with any hardware |
|||
or software product, is expressly prohibited unless authorized |
|||
in writing by Carson Wilson. |
|||
|
|||
|
|||
CONTENTS |
|||
|
|||
1. Functional Enhancments. |
|||
1.1. File Datestamp Capability. |
|||
1.2. Named Directory Capability. |
|||
1.3. Line Queue Capability. |
|||
1.4. Other Enhancements. |
|||
2. Bugs Fixed. |
|||
3. ZDENSTAL. |
|||
4. Notes to DosDisk Users. |
|||
5. Planned Enhancements. |
|||
6. Development History. |
|||
|
|||
|
|||
1. Functional Enhancments. |
|||
|
|||
1.1. File Datestamp Capability. |
|||
|
|||
Under ZSDOS, the Create date and time of files edited with |
|||
ZDE are maintained across editions. If .BAK files are being |
|||
created, the create dates of new files will be the same as their |
|||
.BAK files. Note that if a file with the name of a block being |
|||
saved with ^KW or ESC-W already exists, the saved block will have |
|||
the same Create stamp as the (previously) existing file. I hope |
|||
to address this side-effect in future versions by prompting before |
|||
erasing existing files during ^KW commands. |
|||
|
|||
1.2. Named Directory Capability. |
|||
|
|||
ZDE will now accept ZCPR named directories when loading, |
|||
renaming, and erasing files, and when requesting a directory |
|||
listing with the ^KF command. The named directory (if available) |
|||
is also displayed as part of the current file name in the status |
|||
line. |
|||
Since ZCPR directory names can occupy up to eight columns on |
|||
the status line, it was necessary to move the rest of the status |
|||
line over by eight columns. I was able to gain an extra column by |
|||
putting only one space between the filetype and the "[x" |
|||
specifier, but the result is that if your terminal displays less |
|||
than 55 columns the current column number will not be visible in |
|||
your status line. |
|||
This is unfortunate, but the status line is already about as |
|||
compressed as possible. To include all of the information I would |
|||
have to add a second status line for narrow terminals, which would |
|||
add a good deal of code and complexity to what is already a |
|||
complicated program. Since most CP/M terminals (including my own) |
|||
have 80 columns, I have decided in favor of the majority in this |
|||
instance. |
|||
You may also notice that the ^QA prompt "Chg? (Y/N/*)" has |
|||
been shortened to "Chg?" and the "Wait..." message is now "Wait". |
|||
These changes were also necessary because of the decrease in |
|||
available space on the status line. |
|||
|
|||
1.3. Line Queue Capability. |
|||
|
|||
A third functional enhancment is the new ^QQ command, which |
|||
causes ZDE to skip to line numbers stored in ZCPR's user-defined |
|||
message bytes. Under ZCPR3, up to eight line or page numbers may |
|||
be passed to ZDE. The original idea was to use the interface to |
|||
produce a Turbo Pascal-like integrated environment for program |
|||
development, but the interface is certainly not limited to |
|||
programmers. |
|||
The numbers are stored in ZCPR's 16 user-defined message |
|||
bytes, and ZDE treats these bytes as a packed array of up to eight |
|||
elements. ^QQ causes ZDE to cycle through the array, going to the |
|||
stored locations sequentially until the end of the array or a zero |
|||
element is reached, at which point ZDE returns to the first stored |
|||
location. |
|||
The numbers are stored as inverted 2-byte hex words (LSB |
|||
first), so for example to store the lines 12, 44, and 108 a |
|||
program would set the 16 user-defined bytes as follows: |
|||
|
|||
0C 00 2C 00 6C 00 00 00 00 00 00 00 00 00 00 00 |
|||
|
|||
In this example, when ZDE reaches the fourth word (00 00) it |
|||
returns to the start of the array and goes to line 12 (0C 00). |
|||
Any ZCPR program, or even an alias (using Jay Sage's powerful |
|||
ARUNZ parameters) can now give ZDE the locations of up to eight |
|||
line numbers of interest. With a little imagination we could |
|||
probably create an integrated text search/edit environment which |
|||
searches multiple files for a string and points ZDE to the exact |
|||
location of each match for editing. Thanks to Cameron Cotrill and |
|||
Al Grabauskas for suggesting this feature. |
|||
|
|||
1.4. Other Enhancements. |
|||
|
|||
In response to a suggestion by Phil Newman, ZDE now properly |
|||
accepts and displays user areas between 16 and 31. While I do not |
|||
normally suggest storing files in these areas because many CP/M |
|||
programs do not handle them properly, they are useful occasionally |
|||
on very large disks or for security purposes, and are supported by |
|||
ZCPR and ZSDOS, so I have included them in ZDE. |
|||
For NewWord compatibility, I have changed the "To Mark" |
|||
command from ^QP to ^QZ. This is also better mnemonically, since |
|||
the "place mark" command is ^PZ. |
|||
The search and replace functions now match upper or lower |
|||
case by default. To search for an exact match by case, you must |
|||
enter "/c/" or "/C/" (for Case) before the search string. The |
|||
"/i/" option is no longer active. I have changed default |
|||
find/replace wildcard character to ^Z so that ZDE can find strings |
|||
with literal '_' characters. Use the ^QZ command to find a |
|||
literal ^Z. |
|||
^KB, ^KK, ^KU and ^QY no longer cause unnecessary redisplays. |
|||
For faster operation, ZDE no longer resets drives under ZSDOS |
|||
(same as CP/M Plus). |
|||
Under ZSDOS and CP/M Plus, ZDE sets the error mode to 0FEh. |
|||
All BDOS errors are displayed on the screen, but ZDE retains |
|||
control. |
|||
For your protection, ZSDOS Path and Public files are Read |
|||
Only under ZDE. That is, you can access files via Path or Public |
|||
but you cannot erase Path or Public files. If you get a ZSDOS |
|||
"File W/P" error when saving data with the ^KS, ^KD, ^KX, or ^KW |
|||
commands or when erasing a file with ^KE, you may have given the |
|||
name of a ZSDOS Path or Public file. Try again with a new name. |
|||
|
|||
|
|||
2. Bugs Fixed. |
|||
|
|||
If just a drive letter in given during the ^KF (display |
|||
files) command, files in the current user area are displayed |
|||
rather than files in user area 0 (thanks to Ben Cohen). |
|||
ZDE no longer crashes if no name is given in response to the |
|||
^KW prompt (thanks to Eric Meyer for finding this one). |
|||
^KB and ^KK now behave properly when entered at the rightmost |
|||
column of the screen. |
|||
The "Chg?" prompt is now properly erased in all circumstances. |
|||
Full disk errors caused CP/M Plus and ZSDOS systems to report |
|||
the wrong amount of free space. This has been corrected by |
|||
closing the output file after full disk errors (thanks to Howard |
|||
Goldstein for this idea). |
|||
File read-only errors no longer set the drive byte to "^@" |
|||
under CP/M 2.2 (thanks again to Phil Newman for finding this one). |
|||
Backwards replace now finds the first occurrence of the |
|||
string before the cursor even if the cursor is only one character |
|||
to the right of the string. If the string is replaced, the cursor |
|||
now returns to the START of the new string instead of one after it |
|||
as before (this may change the effects of some ZDE key macros). |
|||
Ben Cohen noticed that VDE's left margin (Lnn) print option |
|||
sometimes failed to indent the first line. This has been fixed. |
|||
ZDE also prints the header text at the same location no matter |
|||
what left margin is used, rather than indenting the header and |
|||
causing it to wrap to the next line. Print option verification is |
|||
also much more rigorous now than in previous versions. |
|||
^KS, ^KD, and ^KX file name requests now abort with a |
|||
carriage return as well as ^U, and ^U now returns you to ZDE in |
|||
response to the ^KX filename request. |
|||
The bug fix published in VDE266.FIX has been incorporated. |
|||
Several ZDE bugs affecting use with DosDisk have been |
|||
eliminated (see below for bugs IN DosDisk 1.00, however). |
|||
Tabs displayed in the last column of the last row no longer |
|||
cause the screen to scroll. |
|||
Virtual screen displays no longer show garbage at the end of |
|||
the line if the cursor is at the left side of the screen, and |
|||
moving to the left edge of the screen with ^A no longer causes |
|||
redisplay. |
|||
^A now moves to the first character on line 2 before jumping |
|||
to line 1 when line 1 is empty. |
|||
^PZ now causes a horizontal scroll if it moves the cursor |
|||
beyond the right edge of the screen. |
|||
Block and place markers no longer set file status to |
|||
"Changed." |
|||
The cursor no longer jumps around when moving left from |
|||
columns after 254. The cursor now stops at column 254 instead of |
|||
255, and the status line says "Col 255" for any column past 254. |
|||
Text past column 254 CAN actually be edited, but it will not be |
|||
displayed by ZDE. |
|||
Strings can now be found with ^QA even if they are the very |
|||
last item in the file (credit goes to Cameron W. Cotrill for |
|||
finding this one). |
|||
"^OI@" now removes all soft tab stops "as advertised" in |
|||
VDE266.DOC instead of setting them all to 1, making it possible to |
|||
set new tabs after entering "^OI@". "^OI#" has the same effect. |
|||
^^ now sets file status to "Changed" when converting from |
|||
lower-to-upper case as well as upper-to-lower. |
|||
"Wait..." message now disappears after disk operations with |
|||
ruler on and status line off. VDE266 forgot to erase the message |
|||
in this situation. |
|||
Backwards find and replace operations now work properly |
|||
instead of repeating the prompt indefinitely when the replace |
|||
string is shorter than the find string (thanks to Ben Cohen for |
|||
pointing this out). |
|||
VDE restored INSert to its entry status just BEFORE the final |
|||
byte of the macro, resulting in irregular behavior and sometimes |
|||
causing macro elements to appear after the "INS" indicator in the |
|||
status line. ZDE waits until the entire macro has executed before |
|||
restoring entry status. Due to ZDE's code structure, the INS |
|||
status line indicator does not change during macro execution. |
|||
ZDE restores INSert to entry status when macros abort due to |
|||
errors (e.g., "[[[ Not Found ]]]"). |
|||
|
|||
|
|||
3. ZDENSTAL. |
|||
|
|||
Included in this library is ZDENSTAL.COM, the new install |
|||
program for ZDE. ZDENSTAL it is very similar to VINST in |
|||
operation, but adds the feature of displaying the actual print |
|||
toggles and switches at all prompts, rather than the default ones. |
|||
So if you change the first default print toggle character to ^K |
|||
for example, all other prompts referring to that toggle now |
|||
reflect the change. |
|||
Files for use with ZDENSTAL must have the type ".ZDE" (option |
|||
installation), ".ZDP" (printer installation), or ".ZDK" (macro |
|||
keys), but are otherwise compatible with files used to install VDE |
|||
2.66. With Fred Haines' permission, I have adapted his wonderful |
|||
VDKCOM.COM utility for use with ZDE, and renamed it (what else?) |
|||
ZDKCOM.COM (see ZDKCOM.DOC). |
|||
ZDENSTAL also corrects the bug which prevented VINST from |
|||
loading installation files whose archive bits were set. |
|||
|
|||
|
|||
4. Notes to DosDisk Users. |
|||
|
|||
DosDisk users are advised of a bug in DosDisk 1.00 which appeared |
|||
during the development of ZDE. Calling Reset 13 while DosDisk is |
|||
active can cause DosDisk to think other active drives are all |
|||
drive A:. Bridger Mitchell, author of DosDisk, is aware of this |
|||
bug and is working on a fix. In the meantime, users of CP/M 2.2 |
|||
and ZRDOS who wish to edit files on MS-DOS disks should NOT log |
|||
into the MS-DOS drive while editing with ZDE, as this causes ZDE |
|||
to do a Reset 13 when writing to the MS-DOS drive. To edit files |
|||
on the MS-DOS drive, run ZDE from drive A: or another non-MS-DOS |
|||
drive. |
|||
|
|||
Users of ZSDOS and CP/M Plus need not worry about this problem |
|||
with ZDE, as ZDE never resets disks under ZSDOS or CP/M Plus. By |
|||
the same token, however, ZSDOS and CP/M Plus users must not change |
|||
disks in the MS-DOS drive from within ZDE, because DosDisk (like |
|||
CP/M 2.2) requires a disk reset or warm boot when disks are |
|||
changed (see DosDisk manual, p. 7). |
|||
|
|||
|
|||
5. Planned Enhancements. |
|||
|
|||
If time permits, future versions of ZDE may contain the |
|||
following enhancements: |
|||
An improved ZDENSTAL which directly accepts ASCII files for |
|||
key definitions, along the lines of ZDKCOM. |
|||
Bridger Mitchell has suggested command "bindings" which would |
|||
allow any control key or meta key sequence to be linked to any ZDE |
|||
command. This idea will be familiar to users of Perfect Writer. |
|||
Key bindings would allow ZDE to simulate EMACS, for example. |
|||
Bruce Morgen and others have suggested automatic terminal |
|||
installation under ZCPR, allowing the same copy of ZDE to be used |
|||
with any terminal. |
|||
Allow more than two default filetypes available and fixed |
|||
disks. |
|||
It may be possible to preserve file create datestamps under |
|||
CP/M Plus and Z3PLUS. |
|||
|
|||
|
|||
6. Development History. |
|||
|
|||
1984: VDE began as Eric Meyer's set of improvements on the tiny |
|||
(4k) "VDO" memory- mapped editor by Fritz Schneider (1982), |
|||
as adapted by George Peace (1984) for the Osborne Executive. |
|||
|
|||
1985: The first terminal adaptation, VDE-PX for the Epson PX-8. |
|||
Ongoing improvements also in parallel Osborne versions |
|||
VDE-OS. |
|||
|
|||
1986: The unified VDE(M) version 2.00, with generic terminal |
|||
installation. Versions 2.1-2.3 added new features |
|||
including macros; global replace; tighter compression; many |
|||
Print options; file directory; undelete. |
|||
|
|||
1987: 2.4 (1/87): Improved scrolling and screen functions; more |
|||
screen sizes supported; WordStar file mode; |
|||
place markers; ^OZ; block print; larger macro |
|||
keys; VINSTALL terminal menu. |
|||
|
|||
2.5 (3/87): User area support; variable tabs; double |
|||
spacing; search wildcards; more standard block |
|||
functions; improved format- ting; many |
|||
additions to VINSTALL. |
|||
|
|||
2.6 (7/87): Greater WordStar compatibility; many new |
|||
functions; more free RAM; faster scrolling; |
|||
search options; keyboard buffer. |
|||
|
|||
1988: Development through v2.64, with new functions; top margin; |
|||
doublespaced printing; auto mode filetypes. |
|||
|
|||
2.65 (4/88): Auto indent; tab set enhancements; small fixes. |
|||
|
|||
2.66 (6/88): Printer left margin; small fixes. |
|||
|
|||
1989: First version of ZDE. |
|||
|
|||
@ -0,0 +1,55 @@ |
|||
QUICK REFERENCE FOR ZDE 1.0 |
|||
------- [Note: the ^K- and ESC- prefixes are nearly interchangeable.] -------- |
|||
|
|||
|
|||
CURSOR AND SCREEN: |
|||
|
|||
<up> = ^E <rt> = ^D ^Q<rt>,<lf> start, end of line |
|||
<dn> = ^X <lf> = ^S or ^H ^Q<up>,<dn> top, end of screen |
|||
[Note: An alternate arrow key set can also be installed.] |
|||
|
|||
^F word right ^QR to top of file ^QB to block start |
|||
^A word left ^QC to end of file ^QZ to place marker |
|||
^R page back ^QI to page/line no. ^QQ to queue line |
|||
^C page forward |
|||
^W scroll back line ESC<up>,<dn> shift up, down 1/4 screen |
|||
^Z scroll down line ESC<rt>,<lf> shift right, left 32 cols |
|||
^O<up> make current line top |
|||
|
|||
DELETING: MISCELLANY: FIND and REPLACE: |
|||
|
|||
^G delete char right ^V INSERT on/off ^QF find string |
|||
DEL delete char left ^N insert a CR ^QA find and replace |
|||
^T delete word right TAB Tab or move to stop /B/ackwards |
|||
^Y delete line ^^ upper/lower case /C/ase-specific |
|||
^QY del to end of ln ^KI information message /// quote "/" |
|||
^Q-DEL " to beg of ln ^PZ set place marker ^Z = wildcard |
|||
^QT_ del to character ^OD HCR display on/off ^L [^\] repeat last |
|||
^U UNdelete char ^OQ header on/off find/repl |
|||
^QU UNdelete line ^OW make window |
|||
^OZ blank screen |
|||
|
|||
DISK FILES: BLOCKS: PRINTING: |
|||
|
|||
^KN change filename ^KB block start ^KP print text |
|||
^KL load new file ^KK block end (Options: P,B,T,L, |
|||
^KR read in disk file ^KU unmark block ^,"",*nn,@nn,#nn) |
|||
^KF show disk files ^KC copy block ^OP set page length |
|||
^KE erase disk file ^KV move block ^P- insert ^-code: |
|||
^KS save work, continue ^KY delete block B,D,S,Y toggles |
|||
^KD save, load new file ^KW write block to disk Q,W,E,R switches |
|||
^KX save and exit |
|||
^KQ quit without save |
|||
|
|||
FORMATTING: |
|||
|
|||
^OR,L set rt, lf margins ^OI,N tab set, clear ^B reform text |
|||
^OX margin release ^OV tabs variable/fixed ^OT ruler line |
|||
^OC center line ^OA auto indent mode |
|||
^OF flush line right ^OS double spacing |
|||
|
|||
MACROS: |
|||
|
|||
ESC-M define macro ESC-# store macro key ESC-!,=,~,+ |
|||
ESC-; wait (pause) ESC-0..9 use key macro programming |
|||
|
|||
@ -0,0 +1,67 @@ |
|||
..Print in Wordstar mode, using the "L8" option for normal pitch |
|||
..printers and 8.5" paper. |
|||
|
|||
ZZZZZZZZ DDDDDDD EEEEEEEE |
|||
ZZ DD DD EE |
|||
ZZ DD DD EE |
|||
ZZ DD DD EEEEEE |
|||
ZZ DD DD EE |
|||
ZZ DD DD EE |
|||
ZZZZZZZZ DDDDDDD EEEEEEEE |
|||
|
|||
Z-System Display Editor |
|||
|
|||
|
|||
Table of Contents |
|||
|
|||
1. Introduction. . . . . . . . . . . . . . . . . . . . . . 1 |
|||
2. Installing ZDE. . . . . . . . . . . . . . . . . . . . . 2 |
|||
3. Invoking ZDE. . . . . . . . . . . . . . . . . . . . . . 2 |
|||
4. ZDE's Command Set. . . . . . . . . . . . . . . . . . . 2 |
|||
4.1. Command Summary. . . . . . . . . . . . . . . . . . . 3 |
|||
4.1.1. Control Keys: . . . . . . . . . . . . . . . . . . . 3 |
|||
4.1.2. File and Block Commands: . . . . . . . . . . . . . 3 |
|||
4.1.3. Escape and Macro Commands . . . . . . . . . . . . . 4 |
|||
4.1.4. Quick Commands . . . . . . . . . . . . . . . . . . 4 |
|||
5. Command Descriptions. . . . . . . . . . . . . . . . . . 5 |
|||
5.1. Auto-Indent Mode (^O-A). . . . . . . . . . . . . . . 5 |
|||
5.2. Block Commands . . . . . . . . . . . . . . . . . . . 5 |
|||
5.3. Cursor Movement . . . . . . . . . . . . . . . . . . . 6 |
|||
5.4. Deleting . . . . . . . . . . . . . . . . . . . . . . 6 |
|||
5.5. Disk Operations . . . . . . . . . . . . . . . . . . . 7 |
|||
5.6. File Commands . . . . . . . . . . . . . . . . . . . . 7 |
|||
5.7. Find, Replace . . . . . . . . . . . . . . . . . . . . 7 |
|||
5.8. Header . . . . . . . . . . . . . . . . . . . . . . . 8 |
|||
5.9. Information . . . . . . . . . . . . . . . . . . . . . 8 |
|||
5.10. Insert Mode . . . . . . . . . . . . . . . . . . . . 9 |
|||
5.11. Line Spacing . . . . . . . . . . . . . . . . . . . . 9 |
|||
5.12. Margins . . . . . . . . . . . . . . . . . . . . . . 9 |
|||
5.13. Pagination . . . . . . . . . . . . . . . . . . . . . 9 |
|||
5.14. Place Markers and Line Queue . . . . . . . . . . . . 10 |
|||
5.15. Printer Codes . . . . . . . . . . . . . . . . . . . 10 |
|||
5.16. Printing . . . . . . . . . . . . . . . . . . . . . . 11 |
|||
5.17. Ruler Line . . . . . . . . . . . . . . . . . . . . . 12 |
|||
5.18. Tabs . . . . . . . . . . . . . . . . . . . . . . . . 12 |
|||
5.19. Undelete . . . . . . . . . . . . . . . . . . . . . . 12 |
|||
5.20. Upper/Lower Case . . . . . . . . . . . . . . . . . . 13 |
|||
5.21. Window and Screen . . . . . . . . . . . . . . . . . 13 |
|||
5.22. Wordwrap, Reformat . . . . . . . . . . . . . . . . . 13 |
|||
6. Macros. . . . . . . . . . . . . . . . . . . . . . . . . 14 |
|||
6.1. Macro . . . . . . . . . . . . . . . . . . . . . . . . 14 |
|||
6.2. Macro Key . . . . . . . . . . . . . . . . . . . . . . 15 |
|||
6.3. Macro Programming . . . . . . . . . . . . . . . . . . 15 |
|||
|
|||
|
|||
|
|||
|
|||
|
|||
7. General Information. . . . . . . . . . . . . . . . . . 16 |
|||
7.1. Disk Space. . . . . . . . . . . . . . . . . . . . . . 16 |
|||
7.2. Error Messages. . . . . . . . . . . . . . . . . . . . 17 |
|||
7.3. File Modes. . . . . . . . . . . . . . . . . . . . . . 17 |
|||
7.4. Hyphenation . . . . . . . . . . . . . . . . . . . . . 18 |
|||
7.5. Interruption. . . . . . . . . . . . . . . . . . . . . 18 |
|||
7.6. Prompts. . . . . . . . . . . . . . . . . . . . . . . 18 |
|||
7.7. WordStar Compatibility. . . . . . . . . . . . . . . . 19 |
|||
8. Disclaimer. . . . . . . . . . . . . . . . . . . . . . . 20 |
|||
|
|||
@ -0,0 +1,8 @@ |
|||
Update to Z System Display Editor, a small, fast editor for assembly |
|||
language and light word processing. Z System required for optimal |
|||
performance; also works with CP/M 2.2 and CP/M Plus. This version |
|||
adds hardware video handling, auto-return to file position under |
|||
ZCPR, WordStar-like ruler line, cursor on/off, and generally |
|||
F-A-S-T-E-R performance. Ten little bugs also fixed. See ZDE10.LBR |
|||
for full documentation. 26 Aug 89 by Carson Wilson. |
|||
|
|||
@ -0,0 +1,241 @@ |
|||
|
|||
New in ZDE |
|||
|
|||
Z-System Display Editor |
|||
|
|||
Version 1.3 26 Aug 89 |
|||
|
|||
|
|||
ZDE and its documentation adapted with permission from Eric |
|||
Meyer's VDE version 2.66, and are now copyright 1989 by Carson |
|||
Wilson, all rights reserved. They may not be circulated in any |
|||
incomplete or modified form without the written permission of |
|||
Carson Wilson. Any commercial use of ZDE, defined as any |
|||
situation where the duplicator receives revenue by duplicating |
|||
or distributing ZDE by itself or in conjunction with any |
|||
hardware or software product, is expressly prohibited unless |
|||
authorized in writing by Carson Wilson. |
|||
|
|||
|
|||
This file describes changes to ZDE since version 1.0. I have |
|||
decided not to release a revision of the documents while ZDE is |
|||
still in active development. For now, please obtain ZDE10.DOC |
|||
and ZDENSTAL.DOC from ZDE10.LBR, available on Antelope Freeway |
|||
and many other remote CP/M systems. Except for the changes |
|||
detailed below, these files provide a thorough explanation of |
|||
how to use and install ZDE. Alternatively, send a contribution |
|||
of $6 or more to support further work on ZDE, and I will mail |
|||
you a high quality printed manual. See section 4 of this file |
|||
for details. |
|||
|
|||
|
|||
- CONTENTS - |
|||
|
|||
1. FUNCTIONAL ENHANCMENTS. |
|||
1.1. Hardware Codes for Faster Scrolling. |
|||
1.2. ZCPR Auto-Return to Previous Position. |
|||
1.3. WordStar-like Ruler line. |
|||
1.4. ZCPR-like Option Lead-in Character. |
|||
1.5. Cursor Dance Eliminated. |
|||
1.6. Other Minor Enhancments. |
|||
2. BUGS FIXED. |
|||
3. INSTALLATION. |
|||
4. FOR MORE INFORMATION. |
|||
|
|||
|
|||
1. FUNCTIONAL ENHANCEMENTS. |
|||
|
|||
1.1. Hardware Codes for Faster Scrolling. |
|||
|
|||
ZDE now uses "hardware" video scrolling in its delete line (^Y) |
|||
command, if your terminal has a delete line capability (see |
|||
ZDENSTAL's Terminal Installation). If hardware insert line is |
|||
available, hardware scrolling is also implemented in the insert |
|||
line (^N) command when used at the beginning of a line. For most |
|||
terminals these are considerably faster than repainting all or |
|||
part of the screen, especially if more than one line is being |
|||
inserted or deleted. |
|||
|
|||
On many ASCII terminals a pause is needed after giving a hardware |
|||
scroll string so that the screen can catch up with the keyboard. |
|||
As distributed the same value of 38 hex is used for both |
|||
horizontal and vertical scrolls. To determine the optimal setting |
|||
for your terminal, load a large text file and execute "scroll up" |
|||
or "scroll down" (^W or ^Z) continuously. If your terminal beeps |
|||
at you or if garbage characters appear you probably need to |
|||
install a larger "Horizontal & vertical scroll delay" value with |
|||
ZDENSTAL. |
|||
|
|||
1.2. ZCPR Auto-Return to Previous Position. |
|||
|
|||
ZDE now loads ZCPR's user-defined message bytes 0 and 1 (if |
|||
available) with the absolute line number of your position in a |
|||
file on exit. This allows you to exit to ZCPR, perform some other |
|||
commands, then return to the same line in your file using the ^QQ |
|||
command. You can also use this feature to jump to the equivalent |
|||
line in another file. Since the line number is absolute, it does |
|||
not vary with page length or file mode settings. |
|||
|
|||
1.3. WordStar-like Ruler line. |
|||
|
|||
New in this version is the appearance of ZDE's ASCII/WordStar mode |
|||
ruler line. As with WordStar and NewWord, the left margin is now |
|||
marked with "L", the right margin with "R", and soft tabs with |
|||
"!". The appearance of ZDE's Non-Document mode ruler line remains |
|||
unchanged. |
|||
|
|||
1.4. ZCPR-like Option Lead-in Character. |
|||
|
|||
ZDE now accepts ZCPR's familiar "/" slash character instead of |
|||
CP/M Plus's "[" character as an option signifier. For example, to |
|||
change to non-document mode the command is now "^KN/N" instead of |
|||
"^KN[N". To load a file in ASCII mode (for example) the command |
|||
is now "ZDE filename /A". This is more consistent with Z-System |
|||
programs as well as the MS-DOS version of VDE. It's also a lot |
|||
easier to find the slash character (at least on my keyboard)! |
|||
|
|||
ZDE allows you to "quote" the slash character in filenames in the |
|||
same way you quote it in ZDE find/replace strings, by doubling the |
|||
slash to give a literal slash. So for example the command "^KN |
|||
12//12//89.FIL" will change the current filename to |
|||
"12/12/89.FIL," and "ZDE ////MYFILE" loads //MYFILE for editing. |
|||
|
|||
1.5. Cursor Dance Eliminated. |
|||
|
|||
Several users mentioned that ZDE's cursor often seemed to "dance" |
|||
for no apparent reason. Actually, this was due to the fact that |
|||
ZDE repaints the screen somewhat more often than larger word |
|||
processing programs, but in looking through NewWord's User Area |
|||
Listing for version 2.17, I found something I had never noticed |
|||
before. It is possible to install NewWord to turn your cursor off |
|||
and on by putting short routines in the MORPAT area and installing |
|||
jumps to your routines at 77D and 77A hex, respectively. This |
|||
reduces eyestrain by telling NW to turn off your cursor while it |
|||
repaints your screen. |
|||
|
|||
It turns out that it was fairly simple to add a similar routine to |
|||
ZDE, so this version has cursor on/off routines similar to |
|||
NewWord's. To make use of these routines, you must install ZDE |
|||
with the cursor on/off codes for your terminal. ZDENSTAL 1.3 |
|||
allows up to six bytes each for cursor on and cursor off. I have |
|||
only been able to find codes for a few of the terminals in |
|||
ZDENSTAL's library. If the codes for your terminal are not |
|||
included in ZDENSTAL, perhaps you could leave a short message to |
|||
me describing them (see below for address), and I will include |
|||
them in the next release. |
|||
|
|||
1.6. Other Minor Enhancments. |
|||
|
|||
The cursor now turns off with the ^OZ command, giving a completely |
|||
blank screen if cursor on/off is installed (see 1.5, above). |
|||
|
|||
Version 1.0 repainted the whole screen after copying a block. Now |
|||
ZDE repaints only from the block to the bottom of the screen for |
|||
faster operation in most circumstances. I have also optimized |
|||
ZDE's general screen output routines somewhat for speed, though |
|||
this isn't noticable on terminals operating at less than 38.4 |
|||
kbaud. |
|||
|
|||
File input/output code has also been optimized for slightly |
|||
greater speed. |
|||
|
|||
And, last but not least, "quiet" operations now work up to 300 |
|||
percent faster! Both "quiet" macros and the "*" option of |
|||
find/replace boast greatly increased speed due to improved program |
|||
logic. |
|||
|
|||
|
|||
2. BUGS FIXED. |
|||
|
|||
If you did a backwards find/replace with ZDE 1.0 and responded to |
|||
the "Y/N" prompt with "*", the screen stayed off until you gave an |
|||
illegal command. The screen now comes back when replacement is |
|||
complete. |
|||
|
|||
ZCPR's GO restart now works after exitting when ZDE's window (^OW) |
|||
is active. Previously restarting with GO caused ZDE to limited |
|||
the number of lines of display available by 1/2. |
|||
|
|||
I fixed a bug with block markers failing to scroll the entire |
|||
display if entered in the last screen column. This was apparently |
|||
introduced when I made block marker displays more efficient in ZDE |
|||
1.0. |
|||
|
|||
If the cursor is to the left of the left margin, block markers now |
|||
move the cursor to the left margin instead of marking the blank |
|||
space between cursor and left margin as part of the block. |
|||
|
|||
For greater safety, ZDE now checks for free memory space before |
|||
adding a block marker with ^KK or ^KB. |
|||
|
|||
Place markers no longer cause words to "wrap" to the next line |
|||
when wordwrap is active. |
|||
|
|||
I fixed a minor bug ZDE 1.0 introduced to the ^OR command. Typing |
|||
^OR in non-document mode no longer produces the strange result of |
|||
setting the right margin to column seven. |
|||
|
|||
A display bug which occurred when the cursor was in column one of |
|||
a virtual screen with a tab to its left has been fixed. |
|||
|
|||
Previously, if only a drive letter was given in response to the |
|||
^KF command's "Dir:" prompt, ZDE searched user zero of the |
|||
specified drive, no matter what the current user number was. ZDE |
|||
now searches for files at the current user number of the specified |
|||
drive in these circumstances. |
|||
|
|||
The installed "output filter limit" was allowing one character |
|||
higher than the limit to be sent to the screen. Now only |
|||
characters equal to or less than the limit are sent. |
|||
|
|||
|
|||
3. INSTALLATION. |
|||
|
|||
You MUST use ZDENSTAL 1.3 to install this version of ZDE. Older |
|||
.ZDK and .ZDP files will still work; due to extra installation |
|||
codes, older .ZDE files will not work with this version. |
|||
|
|||
Version 1.0 of ZDENSTAL skipped the last few bytes of .ZDK key |
|||
overlay files, preventing a full 512-byte .ZDK key file overlay |
|||
from being installed. ZDENSTAL now installs the full 512 bytes. |
|||
|
|||
ZDENSTAL now allows four instead of just two default file types. |
|||
|
|||
Several new terminal definitions have been added to ZDENSTAL, as |
|||
well as some additional terminal codes (see 1.5, above). |
|||
|
|||
|
|||
4. FOR MORE INFORMATION. |
|||
|
|||
Finally, let me take this opportunity to thank the community of |
|||
users without whose efforts this version of ZDE would be far less |
|||
than what it is. Most of the above improvements and many of the |
|||
bugs fixed in this version result from comments and insights by |
|||
ZDE enthusiasts from around the country. Please let me know your |
|||
thoughts on this most recent version. |
|||
|
|||
Besides writing computer programs and working on a degree in |
|||
political science, I operate the Antelope Freeway Remote Access |
|||
Systems for CFOG, Chicago's First Osborne Group. These dual |
|||
remote systems are available at the same number, 312/764-5162, |
|||
Chicago. Antelope 1 covers CP/M and Z System, while Antelope 2 is |
|||
dedicated to MS-DOS support. The best way to contact me is |
|||
through this board. Registration is free. If you are not a |
|||
registered member, you can leave me a note as part of your |
|||
application. |
|||
|
|||
Alternatively, my mailing address is: |
|||
|
|||
1359 W. Greenleaf, #1D |
|||
Chicago, IL 60626 |
|||
USA |
|||
|
|||
As I mentioned above, I don't plan to reissue the ZDE manuals with |
|||
the library while ZDE is still in development. For those who wish |
|||
an updated manual and/or wish to support ZDE, I offer instead a |
|||
pre-printed User's Manual and Installation Guide with Table of |
|||
Contents and Index for a contribution of $6 or more, postpaid. |
|||
The manual is printed in handsome proportional type on both sides |
|||
of 8.5 x 11 inch sheets and punched for a three-hole ring binder. |
|||
My costs for printing and mailing are about $3. |
|||
|
|||
Binary file not shown.
@ -0,0 +1,25 @@ |
|||
ZDE16.DIR: |
|||
Files in ZDE16.LBR, 01 June 90 by Carson Wilson: |
|||
|
|||
Filename Purpose |
|||
------------ --------------------------------------- |
|||
SAMPKEY.DZC Sample key file for use with ZDENSTAL. |
|||
SAMPKEY.ZDK |
|||
SAMPKEY.ZDT |
|||
|
|||
ZDE16.CZM ZDE itself. |
|||
|
|||
ZDE16.DZR This file. |
|||
|
|||
ZDE16.FOR Short RCP/M description of ZDE. |
|||
|
|||
ZDE16.NZW New in ZDE version 1.6. |
|||
|
|||
ZDENST16.CZM Installer for ZDE version 1.6. |
|||
|
|||
ZDEPROP.DZC Proportional formatting support files. |
|||
ZDEPROP.ZZ0 |
|||
|
|||
ZDKCOM13.DZC Key compiler for ZDENSTAL. |
|||
ZDKCOM13.CZM |
|||
|
|||
Binary file not shown.
@ -0,0 +1,8 @@ |
|||
Z System Display Editor, version 1.6. A small, fast, powerful |
|||
WordStar-type text editor for all CP/M and compatible systems with |
|||
the Z80 processor. In some ways superior to its big brother VDE, |
|||
this version of ZDE adds fully functional Auto-Indent capabilities, |
|||
Proportional Formatting, Auto-Recall of last response to prompts, |
|||
Global Find/Replace, Return to Previous Position (^QP) and more to |
|||
what many felt was already the best editor available for CP/M. |
|||
|
|||
@ -0,0 +1,498 @@ |
|||
|
|||
New in ZDE |
|||
|
|||
Z-System Display Editor |
|||
|
|||
Version 1.6 02 Jun 90 |
|||
|
|||
ZDE is copyright 1990 by Carson Wilson, all rights reserved. |
|||
You use ZDE at your own risk. The author accepts no liability |
|||
for any damages resulting from its use or misuse. The files in |
|||
this library may not be circulated in any incomplete or |
|||
modified form without the written permission of Carson Wilson. |
|||
Any commercial use of ZDE, defined as any situation where the |
|||
duplicator receives revenue by duplicating or distributing ZDE |
|||
by itself or in conjunction with any hardware or software |
|||
product, is expressly prohibited unless authorized in writing |
|||
by Carson Wilson. |
|||
|
|||
This file describes changes to ZDE since version 1.3. I have |
|||
decided not to release document revisions while ZDE is still in |
|||
active development. For now, please obtain ZDE10.DOC and |
|||
ZDENSTAL.DOC from ZDE10.LBR, and ZDE13.NEW from ZDE13.LBR, |
|||
available on Antelope Freeway and many other remote CP/M |
|||
systems. Except for the changes detailed below, these text |
|||
files provide a thorough explanation of how to use and install |
|||
ZDE. Alternatively, send a contribution to support further |
|||
work on ZDE, and I will mail you a high quality, up-to-date |
|||
printed manual for ZDE version 1.6. See section 6.3 of this |
|||
file for details. |
|||
|
|||
|
|||
- CONTENTS - |
|||
|
|||
1. FUNCTIONAL ENHANCEMENTS. |
|||
1.1. Proportional Formatting. |
|||
1.2. Last Entry Recall. |
|||
1.3. Enhanced Operation Under CP/M Plus and ZSDOS. |
|||
1.4. Control-U now Aborts "Delete To" Function. |
|||
1.5. Fully Operational Auto-Indent (^OA). |
|||
1.6. Chain to ZCPR Error Handler. |
|||
1.7. Return to Previous Position Command (^QP). |
|||
1.8. Global Find/Replace Option. |
|||
1.9. Semicolons are now Characters in Nondocuments. |
|||
|
|||
2. BUGS FIXED. |
|||
2.1. More Robust Space Calculation. |
|||
2.2. ZCPR Line Queue Bug Fixed. |
|||
2.3. Other Minor Nuisances Corrected. |
|||
|
|||
3. INSTALLATION. |
|||
3.1. New in ZDENSTAL Version 1.6. |
|||
|
|||
4. USAGE HINTS. |
|||
4.1. Saving Macros. |
|||
4.2. Creating a Smaller ZDE. |
|||
4.3. Using GET and GO with ZDE. |
|||
|
|||
5. DEVELOPMENT HISTORY. |
|||
|
|||
6. FURTHER INFORMATION. |
|||
6.1. About Z System. |
|||
6.2. About the Author. |
|||
6.3. Pre-Printed Manuals. |
|||
|
|||
|
|||
1. FUNCTIONAL ENHANCEMENTS. |
|||
|
|||
1.1. Proportional Formatting. |
|||
|
|||
ZDE can now format your text for use with proportional printer |
|||
fonts! See the files ZDEPROP.DOC and ZDEPROP.Z80 (included in |
|||
ZDE16.LBR) for full details. |
|||
|
|||
1.2. Last Entry Recall. |
|||
|
|||
The following commands (among others) cause ZDE to prompt |
|||
you for information: |
|||
|
|||
COMMAND PROMPT |
|||
^KD "Load:" |
|||
^KE "Erase:" |
|||
^KN "Name:" |
|||
^KL "Load:" |
|||
^KR "Read:" |
|||
^QF "Find:" |
|||
^QA "Find:" and "Change to:" |
|||
ESC-M "Macro:" |
|||
|
|||
You can often save typing time and prevent errors by using |
|||
control-R or your right arrow key [as installed] to Recall your |
|||
last response to any of the above prompts. For example, to read |
|||
in a file and then erase it, you could enter "^KR, <filename>, |
|||
RETURN" followed by "^KE, ^R, RETURN". The ^R command will |
|||
automatically recalls the filename you entered in response to the |
|||
"Read:" prompt. The Find, Replace, and Macro prompts work in a |
|||
similar manner. ^R Recalls your entire response; right arrow |
|||
recalls your last response one character at a time to allow |
|||
further editing. |
|||
|
|||
The Recall keys can also be used to recall the last used macro, |
|||
even if it wasn't entered manually. |
|||
|
|||
1.3. Enhanced Operation Under CP/M Plus and Z3PLUS. |
|||
|
|||
ZDE takes advantage of advanced BDOS error handling to provide |
|||
slightly faster file output under CP/M Plus and Z3PLUS. In |
|||
addition, file Create stamps are now preserved under CP/M Plus |
|||
based systems as well as ZSDOS and ZDDOS systems. |
|||
|
|||
1.4. Control-U now Aborts "Delete To" Function. |
|||
|
|||
Control-U can now be used to abort a "Delete To" (^QT) operation. |
|||
Previously, ZDE would attempt to delete up to the next literal ^U |
|||
character in the file, often causing frustration. |
|||
|
|||
1.5. Fully Operational Auto-Indent (^OA). |
|||
|
|||
Auto-Indent is useful for typing outlines, structured program |
|||
source code, and other text where the "left margin" varies. When |
|||
the Insert (^V) toggle is on, Auto-Indent aligns the left margin |
|||
with that of the previous line. When Insert is off, it causes |
|||
the RETURN key to act differently: RETURN advances the cursor |
|||
past any indentation when moving through a file. |
|||
|
|||
When a new line is begun either by wordwrap or reformat (see |
|||
below) or by hitting RETURN with Insert on, Auto-Indent indents |
|||
the following line or lines to equal the previous one. It does |
|||
this by counting the number of spaces or Hard TABs (whichever |
|||
came first) before the text of the previous line, and indenting, |
|||
wrapping, or reformatting using this number of spaces or Hard |
|||
TABs. This entails certain possible conflicts, most of which ZDE |
|||
itself automatically prevents: |
|||
|
|||
First, if you mix Hard TABs and spaces when indenting a line, AI |
|||
may give strange results, as it will count and use the first |
|||
character only. For example, if your line is indented as |
|||
<TAB><TAB><SPACE>, AI will indent the next line with <TAB><TAB> |
|||
only. |
|||
|
|||
To avoid conflicts, enabling AI sets the left margin to 1, and |
|||
setting the left margin greater than 1 disables AI. Also, Double |
|||
Spacing (^O S) is disabled by Auto-Indent, and Auto-Indent |
|||
disables Double Spacing. |
|||
|
|||
Auto-indent status also now defaults to ON in Nondocument mode, |
|||
and OFF otherwise. |
|||
|
|||
1.6. Chain to ZCPR Error Handler. |
|||
|
|||
ZDE 1.6 will chain to the installed Error Handler under ZCPR 3.4 |
|||
with error #12 (TPA overflow) if there was not enough memory for |
|||
ZDE to edit the file you specified on the command line. ZDE does |
|||
this because the flow of logic in a multiple command line |
|||
sometimes dictates that the editor complete its task before |
|||
succeeding commands are carried out. For example, I use the |
|||
a multiple command alias similar to the following |
|||
|
|||
ZDE file;echo erase;if in;era file;else;mv file newdir:;fi |
|||
|
|||
to process modem capture files. After processing each file with |
|||
ZDE I generally want either to erase it (if it contained nothing |
|||
worth saving) or move it to another directory. But on occasion |
|||
the capture file is too large to process with ZDE. If the script |
|||
were allowed to proceed, it would force me either to erase the |
|||
capture file or move it elsewhere, neither of which would be |
|||
appropriate if I hadn't even looked at its contents yet. |
|||
|
|||
This is where Z System's error handler comes it handy: it |
|||
provides a means of dealing with an offending command line before |
|||
unwanted commands cause harm. When ZDE chains to the error |
|||
handler, I can _edit_ commands beginning with ZDE's invocation, |
|||
either removing unwanted commands or inserting further commands |
|||
as the situation may dictate (it is also possible to abort the |
|||
command or multiple command script altogether). In the above |
|||
case, I would revise my command line to the following: |
|||
|
|||
NW file;echo erase;if in;era file;else;mv file newdir:;fi |
|||
|
|||
By substituting the ZDE command with NW I have invoked NewWord |
|||
for this instance only of the command, which in turn will edit |
|||
the larger file. |
|||
|
|||
Without question the finest ZCPR error handler now available is |
|||
Rob Friefeld's ZERR. There are even provisions within ZERR for |
|||
automatically editing LSH scripts and for automatically chaining |
|||
to transient versions when resident (RCP, CCP) commands fail; all |
|||
of this is described in ZERR13.LBR. |
|||
|
|||
1.7. Return to Previous Position Command (^QP). |
|||
|
|||
This function is basically the same as the WordStar command: |
|||
hitting ^Q-P takes you to the position the cursor was at before |
|||
the previous command (including the ^QP command itself - try |
|||
it!). For instance, the sequence "^B, ^Q-P" reformats beginning |
|||
with the current line then restores the cursor to its original |
|||
position within the paragraph. ^Q-P is also useful for moving |
|||
long distances within a file without losing one's place: for |
|||
example you can move to the top of the file with ^Q-R, then come |
|||
back with ^Q-P. |
|||
|
|||
Within Macros, the previous cursor location is preserved: ^Q-P |
|||
will always return you to your place in the text BEFORE you |
|||
invoked the Macro. This not only allows you to resume editing at |
|||
the same location after using Macros; you can also build one or |
|||
more ^Q-P commands into the Macro itself. See SAMPKEY.* files |
|||
for one example; I'm sure there are lots of other ways to use |
|||
^Q-P within a Macro. Thanks to Howard Schwartz for keeping on my |
|||
case about this feature until I finally discovered an easy way to |
|||
implement it. |
|||
|
|||
|
|||
1.8. Global Find/Replace Option. |
|||
|
|||
Besides "B" (backwards search) and "C" (case-sensitive search), |
|||
ZDE now sports a THIRD find/replace option: "G" for Global |
|||
search. ZDE normally begins your (backward or forward) search at |
|||
the current cursor location. Specifying "G" causes ZDE to start |
|||
at the BEGINNING of the file when searching forward for strings, |
|||
or at the END when searching backwards. Otherwise, the search or |
|||
replace command proceeds exactly as it does normally. The "G" |
|||
option is used in the same way as the other options, by enclosing |
|||
it in slashes as a prefix to the string being searched for (e.g., |
|||
to find "Carson" globally, enter "/gc/Carson" in response to |
|||
^Q-F's "Find: " prompt). |
|||
|
|||
1.9. Semicolons are now Characters in Nondocuments. |
|||
|
|||
ZDE now counts the ";" (semicolon) character as a normal |
|||
character in "N" mode, whereas it counts the semicolon as a |
|||
punctuation mark in the "W" and "A" modes. This is mainly of |
|||
interest to assembly language programmers, as the semicolon is |
|||
often used alone to mark the beginnings of comments in source |
|||
code. Treating the semicolon as a normal character in "N" files |
|||
simply makes it easier to manipulate assembly language comments. |
|||
Thanks to Rob Friefeld for his thoughts on this. |
|||
|
|||
|
|||
2. BUGS FIXED. |
|||
|
|||
2.1. More Robust Space Calculation. |
|||
|
|||
ZDE's calculation of memory space remaining is now more robust. |
|||
In past versions of ZDE (and VDE), certain editing commands could |
|||
cause a crash when only a few bytes of free memory were |
|||
available (thanks to Rob Friefeld). |
|||
|
|||
2.2. ZCPR Line Queue Bug Fixed. |
|||
|
|||
The ^QQ (go to next line in ZCPR queue) command of previous |
|||
versions of ZDE failed if ZCPR's 16-byte user-defined buffer was |
|||
filled. Version 1.6 fixes this problem, properly returning to |
|||
the first line in the queue after the last value in has been |
|||
reached. This allows Turbo Pascal-like interactive programming |
|||
of Z80 assembly language when used under Z System with Al |
|||
Hawley's ZMAC Z80 Macro Compiler ($50 including ZML and ZMLIB; |
|||
contact Al Hawley at Ladera Z-Node, 213/670-9465 (modem), Ladera |
|||
Heights, CA). |
|||
|
|||
2.3. Other Minor Nuisances Corrected. |
|||
|
|||
ZDE now turns alternate video off when placing the cursor at the |
|||
string to change during ^QA prompts. |
|||
|
|||
A bug which allowed an extra character or hyphen on the last line |
|||
of a paragraph if the line's length was one character beyond the |
|||
right margin has been fixed (thanks to Larry Schnitger for |
|||
spotting these). |
|||
|
|||
A bug which occurred if you set the block end marker to the last |
|||
byte in the file then did a block delete has been fixed (thanks |
|||
to Ben Cohen for finding this). |
|||
|
|||
One or more bug(s) which occurred while printing have been |
|||
cleared up. ZDE should now always give a correct left margin |
|||
with or without a page header or top margin. The printout is |
|||
also slightly faster when left and top margins are used together. |
|||
|
|||
ZDE now always finds strings located exactly at the end of a |
|||
file. |
|||
|
|||
When searching with the /c/ option, erroneous results occurred if |
|||
a non-matching string of the same length as the search string |
|||
beginning with the same first character as the search string was |
|||
located at the very end of a file. This has been fixed. |
|||
|
|||
Fixed minor bug in proportional formatting that caused repeated |
|||
^B commands to give inconsistent results under some |
|||
circumstances. |
|||
|
|||
Fixed bug which set margins spuriously if an illegal number was |
|||
entered. ZDE also now disallows setting margins to zero, which |
|||
caused formatting problems. |
|||
|
|||
^B (reformat) no longer absorbs following commands, allowing ^B |
|||
to be embedded in key redefinitions with SmartKey, etc. |
|||
|
|||
|
|||
3. INSTALLATION. |
|||
|
|||
You MUST use ZDENSTAL 1.6 to install this version of ZDE. Older |
|||
ZDK and .ZDP files will still work. Due to extra installation |
|||
codes, .ZDE files created with version 1.0 of ZDE will not work |
|||
with this version of ZDENSTAL. |
|||
|
|||
3.1. New in ZDENSTAL Version 1.6. |
|||
|
|||
The proportional formatting (^OJ) toggle can be disabled with |
|||
ZDENSTAL to allow use of ZDE's proportional spacing table as a |
|||
patch area. When proportional spacing is disabled, an additional |
|||
96 bytes of space is released for custom user patching. ZDENSTAL |
|||
also allows you to set the proportional formatting toggle to ON |
|||
or OFF at startup [this can also be toggled while operating ZDE]. |
|||
|
|||
ZDENSTAL's "R" option now restores ZDE's proportional spacing |
|||
table to its default (as distributed) values. |
|||
|
|||
ZDENSTAL's "F" option now gives the locations of all FIVE key |
|||
definition tables (former versions left out the ESC- table). The |
|||
"F" option also gives the location of ZDE's proportional spacing |
|||
table for use when patching ZDE. |
|||
|
|||
The Osborne 1 and Vixen terminal definitions are now separate due |
|||
to different screen width requirements (thanks to Ben Cohen for |
|||
sorting this out). |
|||
|
|||
ZDENSTAL previously would overwrite .ZDK and .ZDP files with the |
|||
wrong information if the .ZDK or .ZDP file had been archived (bit |
|||
7 of filetype character 3 set). This problem has been corrected |
|||
in version 1.6. |
|||
|
|||
Some ZDENSTAL messages have been improved. |
|||
|
|||
|
|||
4. USAGE HINTS. |
|||
|
|||
The following are just some miscellania that I have picked up |
|||
from using and working on ZDE. |
|||
|
|||
4.1. Saving Macros to Disk. |
|||
|
|||
Under Z System version 3.4, it is possible to "save your work" |
|||
after creating a working Macro. First, be sure to save your new |
|||
Macros as Macro Keys using ZDE's ESC-# command (see ZDE Manual). |
|||
Then exit ZDE and type |
|||
|
|||
POKE 310 02 50;ZSAVE 310-490 filename.ZDK |
|||
|
|||
You have just used Z System's type-4 SAVE program to create a new |
|||
.ZDK file, which can now be examined and installed permanently |
|||
into ZDE with ZDENSTAL, or further revised using ZDKCOM. [NOTE: |
|||
the addresses and values given above will work for ZDE version |
|||
1.6, but may change with future versions of ZDE.] |
|||
|
|||
4.2. Creating a Smaller ZDE. |
|||
|
|||
If you are SURE you will never want to enable the Help Menus, you |
|||
can create a slightly smaller copy of ZDE. First use ZDENSTAL to |
|||
disable ZDE's Help Menus. Then issue the Z System command, |
|||
|
|||
GET 100 ZDE.COM;ZSAVE 100-3E7F filename.COM |
|||
|
|||
This creates a copy of ZDE that is about 1 kilobyte smaller than |
|||
the distributed package, and loads somewhat faster on slower |
|||
systems. This procedure is specific to ZDE 1.6; do NOT assume |
|||
that it will work on future versions. |
|||
|
|||
4.3. Using GET and GO with ZDE. |
|||
|
|||
Some users have discovered that the Z System GET and GO commands |
|||
can be used to extend ZDE's versatility or save disk space. |
|||
Since the .ZDE, .ZDP, and .ZDK files used by ZDENSTAL are simply |
|||
binary images of various portions of ZDE, you can achieve the |
|||
versatility of having several copies of ZDE without the added |
|||
disk overhead by using Z System commands that "install" one or |
|||
more of ZDENSTAL's files on the fly. |
|||
|
|||
For example, if you used ZDE with a particular terminal most of |
|||
the time, but occasionally switched to another terminal that was |
|||
incompatible with the first one, you might want to create a Z |
|||
System Alias which would overlay the default copy of ZDE with |
|||
your second terminal's characteristics at startup. You could |
|||
achieve this by first using ZDENSTAL to configure ZDE for your |
|||
second terminal, saving the terminal's characteristics into a |
|||
.ZDE file (see the ZDE Manual for details on this). You would |
|||
then ZDE for your normal terminal, and write an Alias to |
|||
auto-install this copy of ZDE for your occasional terminal on the |
|||
fly: |
|||
|
|||
GET 100 ZDE.COM;GET 180 term2.ZDE;GO $* |
|||
|
|||
This command loads the file term2.ZDE over ZDE before proceeding, |
|||
providing a temporary copy of ZDE that works with your second |
|||
terminal. |
|||
|
|||
This approach can also be used to generate "virtual" copies of |
|||
ZDE with different printer codes and Macro Key definitions. The |
|||
addresses of the various overlays for ZDE version 1.6 are: |
|||
|
|||
180 hex - Terminal codes (.ZDE files) |
|||
1F0 hex - Printer codes (.ZDP files) |
|||
310 hex - Macro Keys (.ZDK files) |
|||
|
|||
[These addresses may well change in future versions of ZDE.] |
|||
|
|||
Obviously, this involves some "homework:" if you get the |
|||
addresses wrong or use an incompatible .ZDx file (from a previous |
|||
version of ZDE, for example), you will likely cause yourself |
|||
grief. For these reasons I generally recommend simply creating |
|||
multiple copies of ZDE. But under some circumstances (e.g., |
|||
laptop computer with limited disk or ROM space) this approach may |
|||
be quite rewarding. |
|||
|
|||
|
|||
5. DEVELOPMENT HISTORY. |
|||
|
|||
ZDE is a descendant of Eric Meyer's famous VDE (Video Display |
|||
Editor) program for CP/M. In 1988, Eric produced his final |
|||
version of VDE for CP/M (2.66). Eric now maintains VDE for |
|||
MS-DOS only; ZDE continues VDE's evolution on Z80 systems. ZDE |
|||
removes many of the CP/M VDE's defects and adds such features as |
|||
support for ZCPR, ZSDOS, and CP/M Plus, improved terminal and |
|||
disk I/O performance, proportional formatting, file datestamp |
|||
support, and improved installation. Meanwhile, the MS-DOS |
|||
version of VDE has continued to evolve, now boasting multiple |
|||
file buffers, auto-save, auto-number, and much more. VDE for |
|||
MS-DOS is available on computer bulletin boards (including |
|||
Antelope Freeway; see below) as VDE152.ZIP. |
|||
|
|||
|
|||
6. FURTHER INFORMATION. |
|||
|
|||
6.1. About Z System. |
|||
|
|||
If you are using CP/M equipment, you have probably heard of Z |
|||
System. Basically this is a downward compatible replacement for |
|||
the system software distributed with Z80 CP/M equipment. By |
|||
utilizing Z80 opcodes and advanced design techniques, the authors |
|||
of Z System have expanded the versatility of the CP/M operating |
|||
system far beyond its original limitations. To learn more about |
|||
Z System, log into the bulletin board listed below, or contact |
|||
one of the following: |
|||
|
|||
Plu*Perfect Systems Sage Microsystems East |
|||
410 23rd St. 1435 Centre St. |
|||
Santa Monica, CA 90402 Newton Centre, MA 02159-2469 |
|||
(213)-393-6105 (eves.) (617)-965-3552 (9am-11pm) |
|||
|
|||
6.2. About the Author |
|||
|
|||
First, let me take this opportunity to thank the community of |
|||
users without whose support this version of ZDE would not have |
|||
been possible. You have made ZDE what it is through your |
|||
generous contributions of time and/or money. Without those who |
|||
appreciate (and criticize) my work I doubt I could justify the |
|||
time and energy I've spent on ZDE. In addition, many of the |
|||
improvements and bug fixes in version 1.6 result directly from |
|||
specific comments and insights by users. Please continue to |
|||
share your thoughts and experiences with ZDE; I'm listening. |
|||
|
|||
I am a doctoral student trying to keep from starving while |
|||
working on my dissertation in Political Science at Loyola |
|||
University of Chicago. I am a coauthor of ZSDOS, a commercial |
|||
replacement for the BDOS portion of CP/M, and have authored |
|||
numerous CP/M and Z System programs. My interests include |
|||
computer programming, telecommunications, the Soviet Union, |
|||
Political Theory, and bicycling (not necessarily in that order). |
|||
I am also looking for part- or full-time work. To this end I am |
|||
skilled in political analysis, know the Russian language and the |
|||
Z80, C, BASIC, and Pascal computer languages, and have |
|||
comprehensive knowledge of CP/M and Z System and working |
|||
knowledge of Unix and MS-DOS. If you know of a gainful opening |
|||
in the computer field, I would like to hear from you. |
|||
|
|||
Among other things I operate the Antelope Freeway Remote Access |
|||
Systems for CFOG, Chicago's First Osborne Group. These dual |
|||
remote systems are available at the same number, 312/764-5162, |
|||
Chicago. Antelope 1 covers CP/M and Z System while Antelope 2 is |
|||
dedicated to MS-DOS support. The best way to contact me is |
|||
through this board. Registration is free. If you are not a |
|||
registered member, you can leave me a note as part of your |
|||
application. |
|||
|
|||
Alternatively, my mailing address is: |
|||
|
|||
1359 W. Greenleaf, #1D |
|||
Chicago, IL 60626 |
|||
USA |
|||
|
|||
6.3. Pre-Printed Manuals. |
|||
|
|||
As I mentioned above, I don't plan to reissue the ZDE manuals |
|||
with the library while ZDE is still in development. For those |
|||
who wish an updated manual and/or wish to support ZDE, I offer |
|||
instead a pre-printed 40-page User's Manual and Installation |
|||
Guide with Table of Contents and Index, postpaid, for those who |
|||
make contributions of $6 or more to support further development |
|||
of ZDE. |
|||
|
|||
Binary file not shown.
@ -0,0 +1,139 @@ |
|||
ZDEPROP.DOC |
|||
Proportional Spacing with ZDE |
|||
June 2, 1990 |
|||
Carson Wilson |
|||
|
|||
1. INTRODUCTION. |
|||
2. USING ZDE'S PROPORTIONAL FORMATTING FEATURE |
|||
3. INSTALLATION AND CUSTOMIZATION. |
|||
|
|||
|
|||
1. INTRODUCTION. |
|||
|
|||
ZDE version 1.6 incorporates an elemental proportional formatting |
|||
feature. This option is useful only to those whose printers have |
|||
proportional spacing capabilities. Proportional formatting allows |
|||
you to format ragged right text properly for proportional output. |
|||
Centering and right justification of proportional text are not |
|||
available. |
|||
|
|||
|
|||
2. USING ZDE'S PROPORTIONAL FORMATTING FEATURE |
|||
|
|||
Proportionally spaced printing gives a more professional look, |
|||
allowing more characters to be printed on a line without |
|||
crowding. This is because less space is allocated to narrow |
|||
characters like "i" and more to wide characters like "M." Most |
|||
computer printers do NOT allow proportional spacing; only laser |
|||
printers, some daisy-wheel equipment, and newer dot-matrix |
|||
printers have this ability. Typically, there is a special set of |
|||
instructions which when sent to the printer, cause it to use |
|||
proportional spacing rather than monospacing. On some models |
|||
(the Silver Reed SR550 for example), DIP switches also control |
|||
this feature. |
|||
|
|||
ZDE does not itself perform proportional spaced printing; it |
|||
simply allows you to format your text for use with a printer that |
|||
has this capability. You must instruct your printer to space |
|||
proportionally before sending text to it. If you have tried using |
|||
the proportional capability of your printer, you probably have |
|||
noticed that LINES WITH LOTS OF WIDE CHARACTERS IN THEM |
|||
print out much wider than lines comprised of narrow characters. |
|||
ZDE 1.6 allows you to compensate for this by counting the width |
|||
of each character when it formats a paragraph (^B command), and |
|||
wrapping each line when its width count reaches the equivalent |
|||
of the current right margin setting. |
|||
|
|||
The ^OJ command toggles this feature on and off [the default may |
|||
also be installed with ZDENSTAL]. When proportional spacing is |
|||
active, the legend "PS" appears in ZDE's status line (this is |
|||
overwritten by "MR" when the margins are released). |
|||
Proportional spacing occurs only during the ^B reformat command, |
|||
not during wordwrap, so to format a document proportionally, you |
|||
must use ^B at the beginning of each paragraph after you key it |
|||
in. Still, the results are well worth the extra trouble, especially |
|||
for material that will be reproduced. |
|||
|
|||
|
|||
3. INSTALLATION AND CUSTOMIZATION. |
|||
|
|||
ZDE comes preconfigured to format text for proportional spacing |
|||
with Epson's new LQ510 dot matrix printer. Since most printers |
|||
allocate roughly the same ratios of space to the various |
|||
characters, there is a good chance you won't need to install ZDE |
|||
for your printer. This file has been formatted for proportional |
|||
output by ZDE; try printing it proportionally to see the results. |
|||
|
|||
If you should decide to change ZDE's proportional spacing to |
|||
match your printer, you can patch ZDE's offset values for |
|||
individual characters. The offsets are stored in a sequential |
|||
ASCII table whose location is given by ZDENSTAL's "F" option. |
|||
The table consists of positive and negative (2's compliment) byte |
|||
values, one for each character beginning with " " and going |
|||
through "~". As distributed, all of the values are either -12, -6, |
|||
0, +6, or +12. The negative numbers are expressed as (256+n), |
|||
where n is the negative number. So for example, -6 is expressed |
|||
as (256+(-6)) or 250 (FA hex). |
|||
|
|||
ZDE uses its ASCII table as follows. When reformatting a line, |
|||
ZDE counts each character as (30+table value)/30 of a column |
|||
wide. So if the offset is zero, the character is one column wide |
|||
(30/30 = 1) and ZDE increments the current column by one. If |
|||
the character's offset is -6, it counts as only (30+(-6)/30) or |
|||
24/30 columns wide, and ZDE increments the current column by |
|||
only 24/30. If the character's offset is +12, it counts as 42/30 |
|||
columns wide, and so on. When a full column is "lost" due to |
|||
characters with negative offsets, ZDE adds the next character to |
|||
the line without incrementing the column count. Similarly, when |
|||
enough "extra" columns are counted to equal a full character, ZDE |
|||
increments its column count without actually adding another |
|||
character to the line. |
|||
|
|||
To see the effects of this, try reformatting a paragraph or two, |
|||
first with PS on, then with it off. Lines of wide characters are |
|||
shortened on screen, while lines of narrow characters are allowed |
|||
to extend beyond the right margin. When the text is printed |
|||
proportionally, your printer reverses the process. Lines of wide |
|||
characters are lengthened and lines of narrow characters are |
|||
shortened, the net result being proportionally spaced text with an |
|||
even right margin. |
|||
|
|||
If your printer's proportional output is not properly compensated |
|||
for by ZDE, it is possible to install another offset table within |
|||
ZDE to suit your needs. The current table's address is given by |
|||
ZDENSTAL's "F" option. To find the location of a character's |
|||
offset, add its ASCII value to ZDE's table address and subtract |
|||
32. For example, the ASCII value for "A" is 65, so the location of |
|||
"A"'s offset is (table address+65-32) or (table address+33). |
|||
|
|||
You may adjust a character's offset to any value between -34 and |
|||
+35 decimal, but keep in mind that offsets if less than -29 may |
|||
result in lines that _never_ reformat since characters with |
|||
offsets of -30 or less take up no virtual space or less! To |
|||
calculate the proportional ratios used by your printer, it is best |
|||
to print out a line of thirty of each character in proportional |
|||
mode and compare the length of each line to the others. Most |
|||
characters should result in lines of roughly the same length; this |
|||
is your "base" length, and you should set the offsets of these |
|||
characters in ZDE to 00. Other lines will probably fall into four |
|||
or so other lengths; hopefully these lengths will correspond to an |
|||
even xx/30ths of the "base" length. To get the proper offset |
|||
value, just subtract the number of characters equal in length to |
|||
a line of "base" characters from 30. For example, if only 18 |
|||
capital "M"'s take up the same length as 30 base characters, the |
|||
offset for "M" is 30-18 or +12. If it takes 42 "i"'s to equal the |
|||
length of 30 base characters, the offset for "i" is 30-42 or -12. |
|||
|
|||
Once you have determined the offsets in 30ths of each |
|||
character's width from the base length, just plug these values |
|||
into ZDE's proportional table. You can use a patcher to alter a |
|||
few characters. For extensive modification, I have provided the |
|||
assembly language file ZDEPROP.Z80 which can be assembled to a |
|||
.HEX file overlay file for ZDE. Before assembling ZDEPROP.HEX, |
|||
you must edit the file and set the equate TABLE to the current |
|||
address of ZDE's proportional spacing table as given by |
|||
ZDENSTAL. Then overlay ZDE with ZDEPROP.HEX using MLOAD, |
|||
SID, or DDT. |
|||
|
|||
- End of ZDEPROP.DOC - |
|||
|
|||
@ -0,0 +1,119 @@ |
|||
; |
|||
; File: ZDEPROP.Z80 - Default proportional width table for ZDE. |
|||
; Author: Carson Wilson |
|||
; Date: 02 Jun 90 |
|||
; Notes: Assembles to a .HEX file which overlays ZDE's native table. |
|||
|
|||
; EQUATES |
|||
|
|||
TABLE equ ????h ; Change "????" to the value given by ZDENSTAL |
|||
; ..for "proportional table." |
|||
; |
|||
ORG TABLE |
|||
|
|||
; Offset Corresponding character |
|||
|
|||
db 0 ; space |
|||
db -12 ; ! |
|||
db 0 ; " |
|||
db 0 ; # |
|||
db 0 ; $ |
|||
db 6 ; % |
|||
db 6 ; & |
|||
db -12 ; ' |
|||
db -6 ; ( |
|||
db -6 ; ) |
|||
db 0 ; * |
|||
db 0 ; + |
|||
db -12 ; , |
|||
db 0 ; - |
|||
db -12 ; . |
|||
db 0 ; / |
|||
; |
|||
db 0 ; 0 |
|||
db 0 ; 1 |
|||
db 0 ; 2 |
|||
db 0 ; 3 |
|||
db 0 ; 4 |
|||
db 0 ; 5 |
|||
db 0 ; 6 |
|||
db 0 ; 7 |
|||
db 0 ; 8 |
|||
db 0 ; 9 |
|||
; |
|||
db -12 ; : |
|||
db -12 ; ; |
|||
db 0 ; < |
|||
db 0 ; = |
|||
db 0 ; > |
|||
db 0 ; ? |
|||
; |
|||
db 6 ; @ |
|||
db 6 ; A |
|||
db 6 ; B |
|||
db 6 ; C |
|||
db 6 ; D |
|||
db 6 ; E |
|||
db 6 ; F |
|||
db 6 ; G |
|||
db 6 ; H |
|||
db -6 ; I |
|||
db 0 ; J |
|||
db 6 ; K |
|||
db 6 ; L |
|||
db 12 ; M |
|||
db 6 ; N |
|||
db 6 ; O |
|||
db 6 ; P |
|||
db 6 ; Q |
|||
db 6 ; R |
|||
db 6 ; S |
|||
db 6 ; T |
|||
db 12 ; U |
|||
db 6 ; V |
|||
db 12 ; W |
|||
db 6 ; X |
|||
db 6 ; Y |
|||
db 0 ; Z |
|||
db -6 ; [ |
|||
db 0 ; \ |
|||
db -6 ; ] |
|||
db 0 ; ^ |
|||
db 0 ; _ |
|||
db -12 ; ` |
|||
; |
|||
db 0 ; a |
|||
db 6 ; b |
|||
db 0 ; c |
|||
db 6 ; d |
|||
db 0 ; e |
|||
db -6 ; f |
|||
db 6 ; g |
|||
db 6 ; h |
|||
db -12 ; i |
|||
db -6 ; j |
|||
db 6 ; k |
|||
db -12 ; l |
|||
db 12 ; m |
|||
db 6 ; n |
|||
db 0 ; o |
|||
db 6 ; p |
|||
db 6 ; q |
|||
db 0 ; r |
|||
db 0 ; s |
|||
db -6 ; t |
|||
db 6 ; u |
|||
db 6 ; v |
|||
db 12 ; w |
|||
db 0 ; x |
|||
db 6 ; y |
|||
db 0 ; z |
|||
db -6 ; { |
|||
db -12 ; | |
|||
db -6 ; } |
|||
db 0 ; ~ |
|||
|
|||
end |
|||
|
|||
; End ZDEPROP.Z80 |
|||
|
|||
Binary file not shown.
@ -0,0 +1,209 @@ |
|||
|
|||
ZDKCOM |
|||
|
|||
Key File Compiler for ZDE |
|||
|
|||
Version 1.3 01 Jun 90 |
|||
|
|||
ZDKCOM and its documentation are adapted with permission from |
|||
VDKCOM12.LBR, by Fred Haines, Glendale Littera RCPM/QBBS, 818 |
|||
956-6164. VDKCOM version 1.2 is copyright 1988 by Fred Haines, |
|||
and is released by the author to the CP/M community for all |
|||
reasonable noncommercial purposes. For the Z80 source code to |
|||
ZDKCOM, see ZDKCOM13.LBR. |
|||
|
|||
|
|||
CONTENTS |
|||
|
|||
1. How to Use ZDKCOM. |
|||
2. Programmer's Note. |
|||
|
|||
|
|||
1. How to Use ZDKCOM. |
|||
|
|||
ZDKCOM compiles an ASCII text file into a *.ZDK file of key |
|||
macros which ZDENSTAL will install in ZDE. It alsos convert an |
|||
existing ZDK file into a text file with the extension ZDT. It |
|||
allows you to create, edit, and re-edit complicated key macros |
|||
with a full-featured word processor - ZDE itself - instead of the |
|||
backspace-only line editor in ZDENSTAL. The syntax is: |
|||
|
|||
ZDKCOM <ufn>.ZDT |
|||
converts text file to ZDK overlay |
|||
|
|||
ZDKCOM <ufn>.ZDK |
|||
converts overlay to ZDT text file |
|||
|
|||
Use ZDE in NONDOCUMENT mode to type a file that looks like |
|||
what you see when you use the K option of ZDENSTAL, substituting |
|||
lower case "n" or "q" for the No Repeat and Quiet option |
|||
indicators <N> and <Q>: |
|||
|
|||
qThis line would be for key 0 in Quiet mode.^M |
|||
nThis line would be for key 1 in No Repeat mode.^M |
|||
|
|||
This line would be key 3, with key 2 unassigned. |
|||
n<This line would appear in angle brackets.>^M^M^M |
|||
The line above, key 4, prints with two blank lines following it. |
|||
q"This is in quotes, but no carriage return at the end." |
|||
"This line is ^P^BMacro Key 7^P^B with embedded boldface codes."^M |
|||
q^VThis line turns insert on before printing the line.^A^A^A^A_^F^D_^M |
|||
n <Key 9 not installed>^A^A^A^A |
|||
|
|||
...and so on. Lines correspond to the number keys in 0 to 9 |
|||
order, with blank lines for unassigned keys. Do NOT embed control |
|||
codes. Type everything in ASCII. For instance, to underline, |
|||
type out '^P^Swords underlined^P^S'. It's a good idea to make |
|||
hard carriage returns visible by toggling them on with the ^OD |
|||
command. ZDKCOM accepts trailing spaces as part of the macro, |
|||
even though you can't see them, so, if you don't want them, make |
|||
sure each line is terminated by a hard carriage return. |
|||
Individual key macro strings may not exceed 127 bytes in the |
|||
ZDK file, though they may in the ZDT text file, since ASCII |
|||
representations of single-byte control codes require two bytes, |
|||
and option flags and slashes don't contribute to the length of the |
|||
string. |
|||
The total of all strings may not exceed 498 output bytes. |
|||
This is two bytes less than allowed by ZDE and ZDENSTAL, but, |
|||
under the program's present logic, it would require an inordinate |
|||
amount of code to make those last two bytes available. If you |
|||
really need them, add them to the ZDK file with ZPATCH or any |
|||
other patcher, locate the last string-length byte, and add 2 (in |
|||
hex) to it. |
|||
For a quick demo, remove the leading spaces from the lines |
|||
below, mark them as a block, and write them out to <ufn>.ZDT. Run |
|||
ZDKCOM <ufn>.ZDT. Then load the resulting ZDK file into ZDE with |
|||
the command ZDENSTAL ZDE <ufn>.ZDK. |
|||
|
|||
q^C^C^C^E^E^E^E^E^[^E |
|||
q^[b^[0^Qs^X^[=^M1^[= 1^S^V ^D^[!0^[1^Qb^B^Ku |
|||
^[=^M0^V^I^V^B^G^[![^[0^X |
|||
^[=^M0^T^B^N^[0^X |
|||
q^P^[^P^I^P^K^P^[9 |
|||
q^V^KrA0:LH.FMT^M |
|||
q^G^G^G^G^X |
|||
q<not installed>^A^A^S |
|||
q<not installed>^A^A^S |
|||
q^KrHEADER^M |
|||
|
|||
Key macro 0 measures off one full page if the top margin is 0 and |
|||
the page length is 58 lines. Adjust for different page lengths by |
|||
adding or subtracting ^E's. I use this macro to move from line 1 |
|||
of a page to line 1 of the next page. I then use key macro 9 to |
|||
read in a page header from a separate file that contains nothing |
|||
but the properly spaced header text with a # in place of the page |
|||
number. I search for # with a ^Qf and replace it with the |
|||
appropriate page numbers. |
|||
This happens so quickly on a 9 mhz SB180 with hard disk that |
|||
it is virtually unnoticeable, but there is a faster way to do it. |
|||
Just make up a header at the top of the first page, or, if you |
|||
want to start page headers only on page two, at the foot of the |
|||
file, and mark it as a block. Use key macro 0 to move from the |
|||
top line of a page to the top line of the next, and copy the |
|||
header into place with the ^KC command. Don't forget to erase the |
|||
original of the header at the foot of the file when you get there. |
|||
Key macro 1 softens and reforms a paragraph by removing the |
|||
hard carriage returns from the ends of each line. |
|||
Key macro 2 changes a document in flush left block format |
|||
(like this one) to indented paragraph form, and key macro 3 |
|||
changes it back again. |
|||
Key macro 4 embeds my DIABLO 1610-compatible printer's code |
|||
for setting a left margin in column 11 (^K=0Bh) in the document. |
|||
If I want another margin I add or subtract from 0Bh and overwrite |
|||
the ^K with the appropriate control character. You may well be |
|||
able to substitute your own printer's set left margin code for |
|||
this one. |
|||
Key macro 5 reads in a previously prepared letterhead stored |
|||
as LH.FMT on drive/user A0. |
|||
Key macro 6 removes four spaces or characters from the |
|||
beginning of each line, used to remove line numbers from the |
|||
beginnings of messages in modem capture files. |
|||
|
|||
|
|||
2. Programmer's Note. |
|||
|
|||
A ZDK file is a data structure four records long. The first |
|||
two bytes are an ID number which ZDENSTAL checks to ensure that it |
|||
is working with the correct version. The current number, 0250h, |
|||
is valid for several recent versions of ZDE. |
|||
These two bytes are followed by up to ten strings, each |
|||
preceded by a string-length byte which ZDE uses to index the |
|||
string's location. Each string is limited by the size of a buffer |
|||
in ZDE to 127 bytes. |
|||
An empty string is indicated by a string-length byte of 00h. |
|||
After the last byte of the last string, the remainder of the 512 |
|||
bytes are filled with 00h. |
|||
It is a peculiarity of ZDKCOM that it needs to write two null |
|||
bytes at the end of the file, which means that it will accept only |
|||
498 bytes for the total length of all strings (512, less two ID |
|||
bytes, less 10 string-length bytes, less these two more) rather |
|||
than the 500 that ZDE and ZDENSTAL allow. |
|||
When you look at the key macro buffer of ZDE using the K |
|||
option of ZDENSTAL, you see something that looks like this: |
|||
|
|||
<0><Q>This line would be for key 0 in Quiet mode.^M |
|||
<1><N>This line would be for key 1 in No Repeat mode.^M |
|||
<2><> |
|||
<3>This line would be key 3, with key 2 unassigned. |
|||
<4><N><This line would appear in angle brackets.>^M^M^M |
|||
<5>The line above, key 4, prints with two blank lines following it. |
|||
<6><Q>"This is in quotes, but no carriage return at the end." |
|||
<7>"This line is ^P^BMacro Key 7^P^B with embedded boldface codes."^M |
|||
<8><> |
|||
<9><> |
|||
|
|||
The numbers down the side and the option indicators <N>, <Q>, and |
|||
<> (no option) are supplied by ZDENSTAL. The ZDT text file |
|||
version of the same macro keys would omit the string numbers and |
|||
no option indicators, and convert the <N> and <Q> to simple lower |
|||
case 'n' and 'q'. If you need lower case 'n' or 'q' as the first |
|||
character of a key macro, just precede it with a slash, which will |
|||
be ignored. |
|||
ZDKCOM recognizes blank lines as unassigned keys. These |
|||
produce an "error" message when invoked by ZDE. |
|||
ZDE recognizes a No Repeat option if the the high bit is set |
|||
on the first byte of the macro string after the length byte, and a |
|||
Quiet option if the high bit is set on both of the first two bytes |
|||
of the string. |
|||
The translation procedure from text to overlay requires: |
|||
|
|||
Enter two-byte ID string 02h 50h in output file. |
|||
|
|||
Enter 00h to save a place for a string length byte. |
|||
|
|||
Check for "n" or "q" as first three bytes of new string and add |
|||
80h to the next byte or next two bytes input as required. |
|||
|
|||
Read in the rest of the string byte by byte and output each byte |
|||
to the output file. If "^" appears in the string, drop it and |
|||
subtract 40h from next byte to make it into a real control |
|||
character. If "/" appears, ignore it and print the next |
|||
character literally. "/^" prints "^" rather than turn the |
|||
character following the carat into a control code, and "//" |
|||
prints a single slash. A single input slash is ignored. |
|||
|
|||
When the CRLF pair is encountered in the input text file, |
|||
convert it to a 00h place marker for the length of the next |
|||
string. Get the number of bytes output in the last string and |
|||
write it to the position of the string-length byte at the head |
|||
of the preceding string. |
|||
|
|||
When the text file's ^Z EOF is encountered, fill the remainder |
|||
of the total 512 bytes with 00h and close the files. |
|||
|
|||
When converting ZDK overlays to ZDT text files, the procedure is |
|||
more or less reversed. ZDKCOM converts the string length bytes to |
|||
CRLF pairs, the control code bytes to two-byte ASCII strings '^c', |
|||
and finishes off the file when all strings are accounted for by |
|||
inserting an EOF ^Z. |
|||
In addition, ZDKCOM has error checking for file opening and |
|||
closing and for individual and overall string length, and it |
|||
reports activity to keep the user from thinking the program has |
|||
hung, though the counters on the screen are otherwise meaningless. |
|||
The structure of the four-sector ZDK file in CP/M is so |
|||
similar to the eight-sector MS/DOS version that you can use |
|||
ZDKCOM, along with a patcher, to create a VDK file for |
|||
installation in VDE12, the MS/DOS version of ZDE. Make up the ZDT |
|||
file as you would for CP/M, then patch the second ID byte from 50h |
|||
to 60h and add four records of nulls. |
|||
|
|||
@ -0,0 +1,69 @@ |
|||
title WordStar 4.0 Video Attributes Driver |
|||
|
|||
strngout equ 0283h |
|||
|
|||
esc equ 1bh |
|||
dim equ 1 |
|||
blink equ 2 |
|||
invert equ 4 |
|||
uline equ 8 |
|||
|
|||
aseg |
|||
org 03c1h |
|||
|
|||
vidatt: |
|||
xor a |
|||
ld hl,funtbl |
|||
ld b,8 |
|||
getloop: |
|||
rr c |
|||
jr nc,getnext |
|||
or a,(hl) |
|||
getnext: |
|||
inc hl |
|||
djnz getloop |
|||
; |
|||
ld hl,string+2 ; attribute #1 on/off indicator |
|||
push hl |
|||
ld b,4 |
|||
ld de,'?!' ; ? = attribute off, ! = attribute on |
|||
setloop: |
|||
rra |
|||
jr nc,attroff |
|||
ld (hl),e ; attribute on |
|||
jr setnext |
|||
attroff: |
|||
ld (hl),d ; attribute off |
|||
setnext: |
|||
inc hl |
|||
inc hl |
|||
inc hl ; advance to next on/off indicator |
|||
djnz setloop |
|||
; |
|||
pop hl ; hl --> dim on/off |
|||
ld a,d ; attribute off |
|||
cp (hl) ; dim off? |
|||
jr nz,setdim |
|||
ld a,e ; attribute on |
|||
setdim: |
|||
ld (hl),a |
|||
ld hl,string |
|||
jp strngout ; ws string routine |
|||
; |
|||
; |
|||
funtbl: |
|||
defb dim ; strike out |
|||
defb invert or blink ; warnings & errors |
|||
defb invert ; block |
|||
defb uline ; underline |
|||
defb blink ; subscript |
|||
defb blink or uline ; superscript |
|||
defb invert ; menu, headline, bold, double |
|||
defb invert or uline ; italics, RET, backspace |
|||
; |
|||
string: |
|||
defb 12,esc,' 2',esc,' 3',esc,' 4',esc,' 5' |
|||
; |
|||
finis equ $ |
|||
end |
|||
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -0,0 +1,880 @@ |
|||
--THE README FILE-- |
|||
------------------------ |
|||
|
|||
README contains late-breaking news and tips about WordStar, |
|||
and information about printers. |
|||
|
|||
|
|||
THE DISKS THAT CAME IN YOUR PACKAGE |
|||
----------------------------------- |
|||
|
|||
The file HOMONYMS.TXT is included on the Speller disk |
|||
contrary to what is listed in Appendix D. |
|||
|
|||
|
|||
INSTALLATION |
|||
------------ |
|||
|
|||
WINSTALL and WSCHANGE |
|||
|
|||
WordStar has two installation programs: |
|||
|
|||
o WINSTALL contains the basic choices to install WordStar. |
|||
It is recommended for all users. |
|||
|
|||
Be sure and install your valid disk drives since WordStar |
|||
running under CP/M cannot recover from attempts to access non- |
|||
existent disk drives. |
|||
|
|||
o WSCHANGE contains every installation and customization |
|||
choice. It is designed for advanced users and users who |
|||
want to customize WordStar after they're familiar with it. |
|||
Use the menu listing below for a directory of the menus |
|||
in WSCHANGE. |
|||
|
|||
Directory of WSCHANGE Menus |
|||
|
|||
The chart below shows the organization of menus in WSCHANGE. |
|||
Print it out and refer to it as you customize WordStar. |
|||
|
|||
Main Installation Menu |
|||
|
|||
A Console |
|||
A Monitor |
|||
A Monitor selection |
|||
B Monitor name |
|||
C Screen sizing |
|||
B Function keys |
|||
C Monitor patches |
|||
A Special characters |
|||
B Cursor control |
|||
C Screen control |
|||
D Keyboard patches |
|||
A Function keys |
|||
B Save function keys |
|||
E Interface patches |
|||
A Console busy handshaking |
|||
B Special I/O subroutines |
|||
B Printer |
|||
A Printer choices |
|||
A Printer selection |
|||
B Printer name |
|||
C Default printer driver |
|||
B Printer driver library |
|||
A Select library file |
|||
B Create smaller library |
|||
C Add new printer driver |
|||
D Change printer driver data |
|||
C WS printer patches |
|||
A Custom print controls, printer initialization |
|||
|
|||
NOTE: Disregard the "CUSTOM & SIMPLE Controls Save CUSTOM/SIMPLE |
|||
Controls" option shown. This is not available from this menu. |
|||
|
|||
D Printing defaults |
|||
E Printer interface |
|||
A Printer port selection |
|||
B Printer busy handshaking |
|||
C Printer subroutines |
|||
C Computer |
|||
A Disk drives |
|||
A Valid disk drives |
|||
B Maximum valid user number |
|||
C Delay disk access if typing |
|||
B Operating system |
|||
A Single-user system |
|||
B Multi-user MP/M |
|||
C Multi-user Turbo DOS |
|||
D ZCPR3 |
|||
C Memory usage |
|||
D WordStar files |
|||
E Directory display |
|||
F Computer patches |
|||
D WordStar |
|||
A Page layout |
|||
A Page sizing & margins |
|||
B Headers & footers |
|||
C Tabs |
|||
B Editing settings |
|||
A Edit screen & help level |
|||
B Typing |
|||
C Paragraph alignment |
|||
D Blocks |
|||
E Erase & unerase |
|||
F Lines & characters |
|||
G Find & replace |
|||
H WordStar 3.3 compatibility |
|||
I Printing defaults |
|||
C Other features |
|||
A Spelling checks |
|||
B Nondocument mode |
|||
C Indexing |
|||
D Shorthand (key macros) |
|||
E Merge printing |
|||
F Miscellaneous |
|||
E Patching |
|||
A Auto patcher |
|||
B Save settings |
|||
C Reset all settings |
|||
|
|||
MEMORY USAGE |
|||
------------ |
|||
|
|||
WordStar requires a minimum TPA size of 50 kbytes to run |
|||
using the factory defaults. The TPA is the amount of memory |
|||
available in your computer for use by programs that have a |
|||
file type of COM. To see how big the TPA is in your computer, |
|||
press the question mark key (?) at the Opening Menu. |
|||
|
|||
The amount of memory required by WordStar can be reduced by |
|||
approximately 3 kbytes if necessary. Use the WSCHANGE program |
|||
to select the minimum memory configuration option. The menu |
|||
will show you what capabilities are being reduced. |
|||
|
|||
WordStar uses a general-purpose buffer for a variety of |
|||
tasks. WordStar allocates memory to this buffer for editing, |
|||
for merge printing, and at the Opening Menu (see BFSIZE in |
|||
PATCH.LST). The buffer used for editing is usually the most |
|||
sensitive to a reduced TPA size. (You may be able to use the |
|||
Opening Menu and print, but there may be insufficient memory |
|||
for editing.) |
|||
|
|||
The merge print buffer is used only to hold merge print |
|||
variable names and data. Increase it if you run out of memory |
|||
while merge printing. |
|||
|
|||
The Opening Menu buffer is used primarily to hold the file |
|||
directory, and for miscellaneous tasks. |
|||
|
|||
|
|||
LOW-MEMORY INDICATOR IN STATUS LINE |
|||
----------------------------------- |
|||
|
|||
If the Low-Memory indicator appears in the status line, it |
|||
means that WordStar was unable to complete some function. |
|||
The most common symptoms are: the line number in the |
|||
status line is wrong, or a paragraph alignment could not be |
|||
completed. You may correct the line counter by saving your |
|||
file, exiting WordStar, and re-loading your file. To correct |
|||
the paragraph alignment, move your cursor to the point where |
|||
paragraph alignment stopped, and then press ^B again. |
|||
|
|||
The reason this comes up is that WordStar was not able to fit |
|||
a big enough chunk of text into memory at one time. |
|||
|
|||
When you first begin editing, WordStar uses the value from |
|||
EDSIZE in the user area to determine the minimum amount |
|||
of memory required for a page of text. The default |
|||
is set for approximately a 55 line by 66 column page. If |
|||
your page size is routinely larger than this, you may want |
|||
to increase EDSIZE. Multiply the number of lines by the |
|||
number of columns, and divide by 128. |
|||
|
|||
If the Low-Memory indicator comes on while printing, it is due |
|||
to either the same reasons as for editing, or there is |
|||
insufficient memory to print the text proportionally spaced. |
|||
The amount of memory required depends on which printer |
|||
driver you are using. If you aren't using the .PS ON dot |
|||
command to turn proportional spacing on in your document, |
|||
low memory won't be a problem. Also, WordStar uses more |
|||
memory for merge printing than it does for regular printing |
|||
(around 2.5 kbytes more). |
|||
|
|||
The Low-Memory indicator will also appear when a full disk error |
|||
is encountered during editing. Treat the disk-full error as you |
|||
would normally. |
|||
|
|||
|
|||
RAM-RESIDENT PROGRAMS |
|||
--------------------- |
|||
|
|||
RAM-resident programs, such as SmartKey, reduce the amount of |
|||
working memory (TPA) that WordStar can use. The new features in |
|||
WordStar, such as shorthand, may reduce the need for these |
|||
RAM-resident programs, thus freeing memory for WordStar. |
|||
|
|||
|
|||
ZCPR3 SUPPORT |
|||
------------- |
|||
|
|||
In order to enable the ZCPR facilities within WordStar, the user |
|||
must use the Z3INS utility provided with ZCPR to install the |
|||
address of the ZCPR "environment" into WordStar. The environment |
|||
contains information that WordStar uses to support ZCPR-specific |
|||
functions. |
|||
|
|||
Generally, the user should log onto the drive containing the file |
|||
WS.COM, and issue the command: |
|||
|
|||
Z3INS SYS.ENV WS.COM |
|||
|
|||
The user should also run either WINSTALL or WSCHANGE to further |
|||
install WordStar for ZCPR. However, this is not mandatory because |
|||
the only thing that happens is that the WordStar sign-on says |
|||
"ZCPR3," and the LGLUSR location in the user area is changed for a |
|||
maximum user number of 31. (The normal default for LGLUSR is 15.) |
|||
|
|||
Once the user has installed WordStar for use with ZCPR, the user |
|||
will be able to use the following ZCPR features: |
|||
|
|||
- A named directory may be used when logging onto a new drive/user. |
|||
|
|||
- A named directory may be used instead of a drive/user as part |
|||
of any file name. |
|||
|
|||
- The drive/user always appears above file directories. (For CP/M |
|||
only the drive letter is shown if the user number is zero.) |
|||
|
|||
- The directory name also appears above the directory if one has |
|||
been defined for the currently logged drive/user. |
|||
|
|||
- If WordStar does not find its OVR files on the current drive and |
|||
user, it will search the drives and user numbers in the ZCPR |
|||
search path rather than using its standard search pattern. |
|||
|
|||
- WordStar installs itself as a ZCPR "shell" process which lets the |
|||
user enter any legal ZCPR command when running a program. (CP/M |
|||
can only run programs that are COM files.) |
|||
|
|||
|
|||
OSBORNE USERS |
|||
------------- |
|||
|
|||
The command to change a hard carriage return to a soft carriage |
|||
return (document mode) or to turn Auto-indent ON (nondocument |
|||
mode) does not function on the Osborne because of a limitation |
|||
in its BIOS. The following patch can be applied to change the |
|||
command from ^^ to ^- (Ctrl-Hyphen): |
|||
|
|||
Using DDT or SID in the file WSMSGS.OVR: |
|||
|
|||
At 02DA replace 1E with a 1D |
|||
At 02EF replace 1E with a 1D |
|||
At 0359 replace 1E with a 1D |
|||
At 06B2 replace 1E with a 1D |
|||
At 06C9 replace 1E with a 1D |
|||
|
|||
At the system prompt type SAVE 53 WSMSGS.OVR |
|||
|
|||
For more information on how to use SID or DDT, see your CP/M |
|||
reference guide. As always, be sure and apply the patch to a |
|||
COPY of the file. |
|||
|
|||
|
|||
INSTRUCTIONS FOR TWO FLOPPY DISK COMPUTERS |
|||
------------------------------------------ |
|||
|
|||
Do not remove the Program disk while you are using WordStar. |
|||
|
|||
The Printer Driver Library file (WSPRINT.OVR) on the WordStar |
|||
program disk is much smaller than the Printer Driver Library |
|||
file contained on the disk labeled PRINTER. Be sure to read the |
|||
section in "Starting" that discusses the printer library file. |
|||
|
|||
|
|||
RUN A PROGRAM |
|||
------------- |
|||
|
|||
Once you press R you can type the drive and user number for the |
|||
program you want to run. You may run only .COM files. CCP commands, |
|||
such as DIR cannot be used. |
|||
|
|||
|
|||
INDEXING |
|||
-------- |
|||
|
|||
Using StarIndex |
|||
|
|||
StarIndex 1.01 works with files created with this release of |
|||
WordStar. |
|||
|
|||
"Can't Use That Printer" Message |
|||
|
|||
When WordStar creates an index or table of contents, it uses |
|||
the printer drivers $INDEX and $TOC. If you created a smaller |
|||
WSPRINT.OVR file, you may have left these drivers out. To |
|||
return them to the file, copy the original WSPRINT.OVR file |
|||
onto your disk. When you create a smaller file again, be sure |
|||
to save these drivers. See Appendix C in the WordStar manual |
|||
for a list of other drivers to save. |
|||
|
|||
|
|||
SPELL CHECKING |
|||
-------------- |
|||
|
|||
Dual floppy disk users: |
|||
|
|||
Unless you have sufficient room on your working WordStar program |
|||
disk for the files TW.COM, SPELL.COM, MARKFIX.COM, REVIEW.COM and |
|||
MAINDICT.CMP you will not be able to run a spell check from the |
|||
Opening Menu. You will need to exit WordStar and replace the |
|||
working WordStar program disk with the dictionary disk you created |
|||
during installation. This disk should contain the files listed |
|||
above. Make sure the disk in drive B has the file you want to |
|||
spell-check. |
|||
|
|||
Follow the directions for running a spell check in The WORD Plus |
|||
manual. |
|||
|
|||
|
|||
UPGRADING FROM A PREVIOUS RELEASE |
|||
--------------------------------- |
|||
|
|||
This release of WordStar contains many new features and commands. |
|||
See the "What's New" booklet for a complete list. The following |
|||
changes came in too late to be included in the documentation. |
|||
|
|||
Printer Patches |
|||
|
|||
Previous versions of WordStar treat most dot matrix printers |
|||
and other non-daisy wheel printers as a DRAFT printer with a |
|||
few patchable items. Because of this, many users have used |
|||
these patches to be able to use certain features of their |
|||
printers. Sometimes the patches have been quite extensive, and |
|||
some users have many files that count on them. |
|||
|
|||
The printer drivers of WordStar Release 4, on the other hand, |
|||
are very powerful. Almost every driver recognizes all the print |
|||
controls and all the dot commands. In fact, if a document is |
|||
written to be printed on one kind of printer, it is likely that |
|||
it will also print fine on some other printer. |
|||
|
|||
However, if you want to use your existing files with WordStar |
|||
4, and those files rely on the user area being patched in a |
|||
special way, you can probably do so by moving the patches into |
|||
WordStar 4, and using the CUSTOM or SIMPLE printer driver. |
|||
|
|||
On the INSTALL disk is a program called MOVEPRN.COM that |
|||
copies the printer driver portion of the previous release's |
|||
user area into files that can be installed into Release 4 with |
|||
the "auto patcher" feature. |
|||
|
|||
Copy the program MOVEPRN.COM onto the disk containing the |
|||
WS.COM file for the previous version. Type |
|||
|
|||
MOVEPRN WS.COM FILE1.PAT FILE2.PAT |
|||
|
|||
MOVEPRN extracts the proper portions of the user area and |
|||
writes them into two files that may then be used with the "auto |
|||
patcher" feature of WSCHANGE. |
|||
|
|||
FILE1.PAT is to be used with the general patching menu |
|||
(Choose E "Patching" on the WSCHANGE Main Menu, then A "Auto |
|||
Patcher"). FILE2.PAT should be used to install strings first |
|||
into the SIMPLE driver, and then into the CUSTOM driver (choose |
|||
B "Printer" on the WSCHANGE Main Menu, then B "Printer driver |
|||
library", D "Change printer driver data" and D "Driver auto |
|||
patcher"). |
|||
|
|||
Test print your document first with the SIMPLE driver, and then |
|||
with the CUSTOM driver to see which one produces the most |
|||
satisfactory results. |
|||
|
|||
Also read Appendix C for more information on using the Auto |
|||
Patcher. |
|||
|
|||
|
|||
Hanging Indents |
|||
|
|||
For WordStar Professional Release 4, MailMerge reformats indented |
|||
text created with ^OG to the current margins. If you want the text |
|||
to remain indented, use embedded ruler lines or the .RM, .LM, |
|||
and .PM commands. See the "Reference Guide" for more information. |
|||
|
|||
Pressing ^OG to wrap back to the first tab on the ruler line after |
|||
having reached the last tab works the same way it did in previous |
|||
versions of WordStar, contrary to what is stated in the manual. |
|||
|
|||
|
|||
TERMINALS |
|||
--------- |
|||
|
|||
WordStar comes installed for an "idealized" special terminal. |
|||
WINSTALL and WSCHANGE allow you to install many terminals by |
|||
name, thus allowing WordStar to take advantage of the special |
|||
features that the terminal might support, such as underlining |
|||
or the function keys. |
|||
|
|||
Use either WINSTALL or WSCHANGE to pick your specific terminal |
|||
or computer screen from the Monitor menu. If your terminal |
|||
isn't on the menu, it probably emulates one of those that is |
|||
there. Look in your terminal documentation to find out. |
|||
|
|||
After you install WordStar for the proper terminal, run |
|||
WordStar and open the file PRINT.TST to see which attributes |
|||
(such as bold and underline) work on your screen. |
|||
WordStar will highlight the following in some way... |
|||
|
|||
Bold (^PB) |
|||
Underline (^PS) |
|||
Strike-out (^PX) |
|||
Subscript (^PV) |
|||
Superscript (^PT) |
|||
Doublestrike (^PD) |
|||
Italics (^PY) |
|||
Blocks (^KB, ^KK) |
|||
Error messages |
|||
|
|||
Most of the time, normal text will be shown in dim intensity, |
|||
and highlighted text will be shown in bright intensity. You |
|||
may have to use a brightness and/or contrast knob to adjust |
|||
your screen the first time you use WordStar this way. |
|||
|
|||
If your dim intensity is too dim to see well, and you can't |
|||
adjust it, you can change the BRITE flag to ON using WSCHANGE. |
|||
This will invert bright and dim in your text, so that regular |
|||
text is displayed bright, and highlighted text will be |
|||
displayed as dim. However, text in the menus is not affected. |
|||
|
|||
|
|||
DISPLAY PROBLEMS WITH TERMINALS |
|||
------------------------------- |
|||
|
|||
Once you have installed WordStar for the proper terminal, you |
|||
may still experience display problems. |
|||
|
|||
If text from the previous screen remains after WordStar |
|||
displays a new screenful of text, the most likely cause is |
|||
cursor wrap. Basically, WordStar must know what happens to the |
|||
cursor when a character is displayed at the rightmost position |
|||
of the screen. It can either remain at the right edge, or it |
|||
can wrap to the beginning of the next line. The WRAP flag in |
|||
WordStar must be set either on or off to correspond to the |
|||
way the terminal works. (It is generally set for the |
|||
terminal's factory default, but the default can usually be |
|||
changed using the terminal's setup mode.) |
|||
|
|||
Another possible cause for display problems is your terminal's |
|||
incomplete emulation of some other terminal. The most |
|||
common differences are... |
|||
|
|||
Line insert (LININS), line delete (LINDEL), |
|||
Erase to end of screen (ERAEOS), |
|||
Erase to end of line (ERAEOL), |
|||
And, erase screen (ERASCR). |
|||
|
|||
Look in the manual for your terminal and use WSCHANGE to see |
|||
if the control sequences match. |
|||
|
|||
|
|||
PRINTERS |
|||
-------- |
|||
|
|||
WHAT'S IN THIS SECTION |
|||
|
|||
This section contains the following information: |
|||
|
|||
Choosing a Printer |
|||
Setting Up Your Printer |
|||
Printer Drivers |
|||
Proportional Printing |
|||
Laser Printers |
|||
Information on Specific Printers |
|||
|
|||
CHOOSING A PRINTER |
|||
|
|||
WordStar is ready to work with over 100 printers. The printer you |
|||
choose during installation becomes your default printer. However, |
|||
when you print a document, you can choose any other printer. To |
|||
choose a default printer, follow these steps: |
|||
|
|||
1. Look at the Printer Information brochure that came in your |
|||
package. The first chart shows the printers listed on the |
|||
Printer Selection Menus. If your printer is on the menu, |
|||
simply choose it during installation. |
|||
|
|||
2. If your printer isn't listed on the menu, it may work like a |
|||
printer that is. Refer to the second chart in the Printer |
|||
Information brochure for a list of printers that work like |
|||
printers on the menu. When WordStar asks you to choose a |
|||
printer, choose the printer that works like yours. |
|||
|
|||
3. If neither chart lists your printer, choose Typewriter Printer |
|||
(if your printer can backspace) or Draft Printer (if it can't). |
|||
These choices may not take advantage of all your printer's |
|||
features, but they will work with almost any printer. |
|||
|
|||
Note: If you choose Draft or Typewriter, you can modify custom |
|||
print controls and printer initialization. |
|||
|
|||
If you want to make more modifications to take advantage of your |
|||
printer's feature, choose the Custom or Simple drivers, then use |
|||
the WS Printer Patches section of WSCHANGE to tell WordStar the |
|||
codes for your printer. Refer to your printer manual for these |
|||
codes. Some printers work better with the Custom driver and some |
|||
with the Simple driver. Try using both and see which works better |
|||
with your printer. See the "Reference Guide" for more information. |
|||
|
|||
SETTING UP YOUR PRINTER |
|||
|
|||
Choosing a Printer Port |
|||
|
|||
Each printer is connected to a printer port at the back of |
|||
the computer. WordStar looks for printers on the LST: port. |
|||
If your printer is connected to a different port, use |
|||
WSCHANGE to tell WordStar the correct port. |
|||
|
|||
Testing Your Printer Connection |
|||
|
|||
At the operating system prompt, type "PIP LST:=READ.ME." This |
|||
file should be printed by your printer. If it is not, your printer |
|||
may be connected to a different port. See your computer reference |
|||
manual, and the section on the STAT command in your CP/M |
|||
reference manual for more information. |
|||
|
|||
|
|||
PRINTER DRIVERS |
|||
|
|||
The WSPRINT.OVR file on the Printers disk contains a printer |
|||
driver for each printer on the Printer Selection Menu. The printer |
|||
driver for a printer contains all the codes WordStar needs to work |
|||
with that printer. |
|||
|
|||
Each printer driver has a short name. If you choose a printer when |
|||
you print a document, you see the names of the printer drivers, not |
|||
the names of the printers. |
|||
|
|||
PROPORTIONAL PRINTING |
|||
|
|||
WordStar supports proportional printing on a number of printers. |
|||
To turn on proportional printing, either install WordStar to |
|||
default to proportional printing, or place a ".PS on" command |
|||
in your document. At print time, WordStar selects the |
|||
appropriate proportional font based on the character width |
|||
(.CW) currently in effect. |
|||
|
|||
The specific printer descriptions later in this section show |
|||
recommended character widths for proportional typefaces. |
|||
These widths are for a normal mix of upper- and lowercase |
|||
letters. If you have many words or phrases all in uppercase |
|||
or if you want your text less densely printed, choose a larger |
|||
character width. |
|||
|
|||
While WordStar mostly sets character widths based on the |
|||
proportional-width table in the driver, on the more advanced |
|||
daisy wheel printers, WordStar uses the printer's proportional- |
|||
spacing mode. WordStar determines how much white space is needed |
|||
to right-justify the line based on its own proportional width |
|||
tables. If the table values don't match the wheel installed, |
|||
WordStar won't be able to justify the line correctly. |
|||
|
|||
WordStar sends standard ASCII characters; if a proportional wheel |
|||
uses a different spoke mapping, set up the printer to handle this. |
|||
|
|||
LASER PRINTERS |
|||
|
|||
WordStar supports laser printer features such as font changes |
|||
and proportional spacing. |
|||
|
|||
WordStar supports several laser printers: the Canon LPB-8 A1 & A2; |
|||
the Hewlett-Packard LaserJet, LaserJet+, and LaserJet 500+; |
|||
and the Ricoh LP4080. Refer to the "Specific Printer |
|||
Information" section of this file for information on these |
|||
printers. General notes about using laser printers are given below. |
|||
|
|||
Paper Size and Margins |
|||
|
|||
Laser printers come with preset page margins. You need to |
|||
compensate for these margins by changing page length in your |
|||
WordStar documents. The chart below shows the recommended |
|||
settings for 8 1/2 X 11 inch paper for both portrait and landscape |
|||
orientations. These settings allow 55 lines of text for portrait |
|||
orientation and 40 lines of text for landscape orientation (at 6 |
|||
lines per inch). They also allow for a footer of up to 3 lines |
|||
and a one-line header. If you use multiple-line headers, adjust |
|||
the top margin accordingly. |
|||
|
|||
Dot Default Portrait Landscape |
|||
Setting Command Value Orientation Orientation |
|||
------- ------- ------- ----------- ----------- |
|||
page length .PL 66 62 47 |
|||
top margin .MT 3 2 2 |
|||
bottom margin .MB 8 5 5 |
|||
header margin .HM 2 1 1 |
|||
footer margin .FM 2 2 2 |
|||
|
|||
If the laser printer is your primary printer, you can use WSCHANGE |
|||
to make these settings the defaults. |
|||
|
|||
Because laser printers leave small margins at the left and right |
|||
sides of the page, you may want to use a smaller page offset |
|||
setting (the default is .PO 8). |
|||
|
|||
Form Feeds |
|||
|
|||
When you print with a laser printer, answer Y for yes to the "Use |
|||
form feeds (Y/N)?" prompt at print time. (The default is NO.) If |
|||
the laser printer is your primary printer, you can use WSCHANGE to |
|||
change the default to yes. |
|||
|
|||
WordStar Commands for Font Selection |
|||
|
|||
The WordStar dot commands and print control commands listed below |
|||
determine the fonts used for printing a document. |
|||
|
|||
.PR .PR OR=L selects landscape orientation; .PR OR=P (or just |
|||
.PR OR) selects portrait orientation (the default). If |
|||
either of these commands appears after the first printing |
|||
line on a page, the orientation will not change until the |
|||
following page. |
|||
|
|||
.PS .PS ON selects proportionally spaced characters; .PS OFF |
|||
(the default) selects fixed-spaced characters. |
|||
|
|||
.CW The character-width setting (.CW followed by the width in |
|||
120ths of an inch) determines the character pitch and font |
|||
selected for fixed-width printing. For proportional fonts, it |
|||
determines the point size and proportional-width table |
|||
selected. |
|||
|
|||
.LQ .LQ ON selects near letter quality print (if supported by |
|||
your printer). LQ OFF selects draft quality print. Default |
|||
is ON. |
|||
|
|||
^PY The italic print control toggles between normal and italic |
|||
characters when the appropriate italic font is available. |
|||
|
|||
^PB The boldface print control toggles between normal and bold |
|||
characters when the appropriate bold font is available. |
|||
|
|||
^PD The double strike print control used with the laser printers |
|||
toggles overprinting with a horizontal offset of 1/120" |
|||
between the two character images. This allows a bold effect |
|||
where no bold font is available. |
|||
|
|||
^PA ^PA turns alternate pitch on. Use .CW to assign different |
|||
character widths to normal pitch (see ^PN below) and alternate |
|||
pitch so that each pitch accesses a different font. You can |
|||
then change fonts by switching between the two pitches. This |
|||
is the only way to use two fonts on the same line. |
|||
(See "Character width" and "Pitch" in the "Reference Guide.") |
|||
|
|||
^PN ^PN turns normal pitch on. You can use it with ^PA as |
|||
described above. |
|||
|
|||
^P@ When working with columns, if you use alternate and normal |
|||
pitch for two fonts, or if you use proportional spacing, you |
|||
may need to use ^P@ to make sure the columns line up. |
|||
Remember that the column position set with ^P@ is determined |
|||
by the normal pitch character width. (See "Columns" and |
|||
"Proportional spacing" in the "Reference Guide." |
|||
|
|||
INFORMATION ON SPECIFIC PRINTERS |
|||
|
|||
This section describes the capabilities of each printer listed on |
|||
the Printer Selection Menu. The printers are listed in alphabetical |
|||
order (except for the generic printers such as "Draft," |
|||
"Typewriter," "Custom," "Simple," and the various print-to-disk |
|||
options, which are listed first). |
|||
|
|||
There is a chart for each printer explaining how features work and |
|||
listing any special notes about the printer. Each printer is |
|||
described in the following format: |
|||
|
|||
PRINTER NAME ----- Driver: (short name) |
|||
|
|||
^PY Effect of italics/ribbon color print control |
|||
^PT/V Subscript/superscript information |
|||
.CW Information on available character widths and fonts. The |
|||
chart shows the .CW, .LQ, and .PS settings required to use |
|||
different fonts. |
|||
|
|||
.LQ OFF .LQ ON .PS ON Font Name |
|||
------- ------ ------ --------- |
|||
.cw val .cw val recommended value (range) font 1 |
|||
.cw val .cw val recommended value (range) font 2 |
|||
|
|||
.UL Continuous-underline information (if restrictions) |
|||
.UJ Microspace-justification information (if restrictions) |
|||
|
|||
N/A means a command has no effect on this printer. |
|||
|
|||
NOTES Switch settings, special features, anomalies. |
|||
|
|||
DRAFT PRINTER (nonbackspacing) ----- Driver: DRAFT |
|||
|
|||
^PD Overprints the line twice |
|||
^PB Overprints the line three times |
|||
^PS Overprints the underscore character in a separate pass |
|||
^PT/V Prints super/subscripts with a full line between |
|||
super/subscript and text |
|||
.LH Sets line height only in multiples of full lines |
|||
.CW N/A |
|||
.PS N/A |
|||
.LQ N/A |
|||
.UJ N/A |
|||
|
|||
NOTES This driver works with any printer that doesn't automatically |
|||
perform a line feed when it receives a carriage return command. All |
|||
overprinting is done by returning the carriage and passing over the |
|||
line again. |
|||
|
|||
TYPEWRITER PRINTER (backspacing) ----- Driver: TYPEWR |
|||
|
|||
^PD Backspaces and overprints each character twice |
|||
^PB Backspaces and overprints each character three times |
|||
^PS Backspaces and overprints the underscore character |
|||
^PT/V Prints super/subscripts with a full line between |
|||
super/subscript and text |
|||
.LH Sets line height only in multiples of full lines |
|||
.CW N/A |
|||
.PS N/A |
|||
.LQ N/A |
|||
.UJ N/A |
|||
|
|||
NOTES This driver works with any printer that doesn't automatically |
|||
perform a line feed when a it receives a carriage return command, |
|||
and responds to a backspace character. Overprinting is done by |
|||
backspacing. |
|||
|
|||
AUTO LINE FEED PRINTER (backspacing) ----- Driver: AUTOLF |
|||
|
|||
^PD Backspaces and overprints each character twice |
|||
^PB Backspaces and overprints each character three times |
|||
^PS Backspaces and overprints the underscore character |
|||
^PT/V Prints super/subscripts with a full line between |
|||
super/subscript and text |
|||
.LH Sets line height only in multiples of full lines |
|||
.CW N/A |
|||
.PS N/A |
|||
.LQ N/A |
|||
.UJ N/A |
|||
|
|||
NOTES This driver works with any printer that automatically |
|||
performs a line feed when it receives a carriage return character, |
|||
and responds to a backspace command. Overprinting is done by |
|||
backspacing. |
|||
|
|||
SIMPLE CUSTOMIZABLE PRINTERS ----- Driver: SIMPLE |
|||
|
|||
All print controls cause control strings (on and off) in |
|||
the user area to be sent to the printer. These strings |
|||
are used by both the SIMPLE and CUSTOM drivers. They can |
|||
be installed with the WSCHANGE program. |
|||
|
|||
.LQ Controlled by user area strings |
|||
.PS Controlled by user area strings |
|||
.CW N/A |
|||
.UJ N/A |
|||
.LH N/A |
|||
|
|||
NOTES This printer driver prints the line in one pass, sending |
|||
control strings from the user area to select print enhancements. |
|||
|
|||
CUSTOMIZABLE PRINTERS ----- Driver: CUSTOM |
|||
|
|||
All print controls cause control strings (on and off) in |
|||
the user area to be sent to the printer. These strings |
|||
are used by both the SIMPLE and CUSTOM drivers. They can |
|||
be installed with the WSCHANGE program. |
|||
|
|||
.LQ ON/OFF controlled by user area strings |
|||
.PS ON/OFF controlled by user area strings |
|||
.LH Sets line height only in multiples of full lines |
|||
.UJ N/A |
|||
.CW N/A |
|||
|
|||
NOTES This driver prints the line in multiple passes, sending |
|||
control strings from the user area to select print enhancements. |
|||
|
|||
PREVIEW TO DISK ----- Driver: PRVIEW |
|||
|
|||
This driver prints documents to the PREVIEW.WS file to allow |
|||
you to preview the format and appearance of a document before |
|||
printing. Headers, footers, and pagination are shown correctly |
|||
and print controls remain in the file to display onscreen |
|||
attributes. Dot commands are not printed. |
|||
|
|||
PRINT TO DISK WITHOUT PRINT CONTROLS ----- Driver: ASCII |
|||
|
|||
This driver prints to the ASCII.WS file, stripping headers and |
|||
footers, high bits, and print controls. |
|||
|
|||
PRINT TO DISK WITHOUT HEADERS AND FOOTERS ----- Driver: XTRACT |
|||
|
|||
This driver prints to the XTRACT.WS disk file, stripping headers |
|||
and footers, but preserving high bits and print controls. |
|||
|
|||
ANADEX 9500A, 9500B ----- Driver: 9500 |
|||
|
|||
^PY N/A |
|||
^PT/V Even superscript roll |
|||
|
|||
.CW .CW Font name |
|||
--- --------- |
|||
9 13.3 cpi |
|||
10 12 cpi |
|||
12 10 cpi |
|||
18 6.7 cpi |
|||
20 6 cpi |
|||
24 5 cpi |
|||
|
|||
.LH 1/24" resolution, use even values |
|||
.UJ This printer has no incremental horizontal positioning |
|||
.PS N/A |
|||
.LQ N/A |
|||
|
|||
ANADEX 9501B, INTEQ 5100B ----- Driver: 9501B |
|||
|
|||
^PY N/A |
|||
^PT/V Even superscript roll |
|||
|
|||
.CW .CW Font name |
|||
--- --------- |
|||
7 16.7 cpi |
|||
8 15 cpi |
|||
10 12.5 cpi |
|||
12 10 cpi |
|||
14 8.3 cpi |
|||
16 7.5 cpi |
|||
20 6.2 cpi |
|||
24 5 cpi |
|||
|
|||
.LH 1/24" resolution, use even values |
|||
.UJ This printer has no incremental horizontal positioning |
|||
.PS N/A |
|||
.LQ N/A |
|||
|
|||
C. ITOH STARWRITER 1550 AND 8510 ----- Driver: C1550 |
|||
|
|||
^PY N/A |
|||
^PT/V Prints full-size characters with roll |
|||
|
|||
.CW .CW Font Name |
|||
--- --------- |
|||
7 compressed |
|||
10 elite |
|||
12 pica |
|||
14 expanded compressed |
|||
20 expanded elite |
|||
24 expanded pica |
|||
|
|||
.LQ N/A |
|||
.PS N/A |
|||
.UL Continuous underlining suppresses microspace justification |
|||
|
|||
C. ITOH F10 STARWRITER ----- Driver: QUME |
|||
|
|||
See Diablo 630, 1610, 1620 Daisy Wheel. |
|||
|
|||
Note: Proportional printing was tested with a Theme 10 wheel. |
|||
|
|||
CANON LBP-8A1 AND LBP-8A2 LASER PRINTER ----- Driver: LBP8 |
|||
|
|||
^PY Selects italics if appropriate font installed |
|||
^PT/V Prints full-size characters with roll |
|||
.PS .PS |
|||
.CW OFF ON Font Name |
|||
--- -- --------- |
|||
6 - 20 cpi |
|||
8 - 15 cpi |
|||
9 - 13.3 cpi |
|||
10 - 12 cpi (elite) |
|||
12 - 10 cpi |
|||
20 - 6 cpi |
|||
24 - 5 cpi |
|||
16 - 7.5 cpi |
|||
- 7 (0-8) Garland 8 point |
|||
- 10 (9-11) Garland 12 point |
|||
- 14 (12-17) Expanded 8 point |
|||
- 20 (18-30) Expand |
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -0,0 +1,43 @@ |
|||
11 Dec 88 |
|||
|
|||
Some changes have been made to COPY since the manual was written. |
|||
Comparison of dates with Existence testing ON has been changed to |
|||
use the Creation date when no Modified date exists, and print |
|||
"Undated" when neither exists, yet both source and destination |
|||
disks support file date stamping. Additionally, the /X option |
|||
has been re-defined, and a new /R option has been added to |
|||
Version 1.4. Please replace Paragraph 4.1.2.9 on page 55 of your |
|||
ZSDOS manual with the following two paragraphs describing the new |
|||
options. |
|||
|
|||
|
|||
4.1.2.9.1 ERASE SOURCE FILE AFTER COPY. |
|||
|
|||
When you want to "move" a file from one area to another, the "X" |
|||
option may be used. This option causes a file or group of files |
|||
to be copied in the manner described by the default or specified |
|||
options, but after the copy and optional verify, the source file |
|||
or files are erased. You will be notified that the file has been |
|||
erased by the status "(X)" being printed on your console. To |
|||
minimize the possibility of deleting a good file when errors |
|||
exist in the copy, the Verify option should always be active, |
|||
either by default, or specified. When Verify is active, any |
|||
errors detected will disable the "X" option for that file so that |
|||
a good source file will not be deleted. The "X" option has no |
|||
configurable value, and is always assumed to be "Off" requiring |
|||
the option in the command line list to be effective. |
|||
|
|||
|
|||
4.1.2.9.2 COPY ONLY FILES WHICH EXIST (REPLACE). |
|||
|
|||
Occasionally, you may wish to update selected files to a destina- |
|||
tion in a simpler manner than naming each file, or using the |
|||
Inspect option. The "R" (Replace) option, when active, tells |
|||
COPY to transfer only files which exist on the destination direc- |
|||
tory. If the Archive option (A) is added in conjunction with the |
|||
Replace option, only files which have not been archived, AND |
|||
already exist on the destination will be archived. It should be |
|||
noted that the No Replacement (N) option is incompatible with |
|||
both the Replace and Archive options, and is disabled when either |
|||
"R" or "A" are active. |
|||
|
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
@ -0,0 +1,264 @@ |
|||
|
|||
FILEATTR |
|||
Version 1.6 |
|||
|
|||
Gene Pizzetta |
|||
January 18, 1992 |
|||
A ZSDOS utility, copyright (c) 1988 by Carson Wilson. |
|||
|
|||
|
|||
FILEATTR (FA) is a utility that allows rapid settin, resetting, |
|||
or displaying of file attributes under ZSDOS, ZRDOS, and CP/M |
|||
2.2. Several additional features are available under ZCPR3, |
|||
including error flag setting, error handler invocation, an |
|||
enhanced display, and better error detection. |
|||
|
|||
FA will not run under CP/M 3.0 or Z3PLUS. |
|||
|
|||
USAGE: |
|||
|
|||
FILEATTR {dir:}{afn} {{/}options} |
|||
|
|||
If a DIR or DU specification is not given, the current directory |
|||
is assumed (under vanilla CP/M only the drive is significant). |
|||
If no ambiguous or unambiguous filename is given, all files |
|||
("*.*") are matched. |
|||
|
|||
If no attribute options are given, FILEATTR merely displays the |
|||
current state of each file's attributes. Files are displayed in |
|||
the order that they appear in the directory. |
|||
|
|||
Once operation begins, FA cannot be aborted by the user. If a ^C |
|||
is entered at the keyboard, all screen output stops, but file |
|||
attribute operations continue to completion. If that was not the |
|||
case, attributes might be set on some entries for a file and not |
|||
on others. Nevertheless, suppressing screen output speeds things |
|||
up a bit. |
|||
|
|||
OPTIONS: A leading slash is required unless the option list is |
|||
the second parameter on the command line. Options may be |
|||
separated by spaces, commas, or nothing at all. |
|||
|
|||
ATTRIBUTE OPTIONS: These options set (turn on) corresponding |
|||
attributes on files matching the file specification. Attributes |
|||
not specified by an attribute option remain unchanged. |
|||
|
|||
If the option is preceded by a minus ("-") or by an "N", the |
|||
corresponding attribute is reset (turned off). |
|||
|
|||
1 F1. This is a user attribute which has no predefined |
|||
meaning. |
|||
|
|||
P Public (f2). Under ZSDOS, when this attribute is set, |
|||
a file is available from any user area of the disk on |
|||
which it resides. A file cannot be made public if |
|||
another file with the same name exists in any other |
|||
user area on that drive. In that case FA will issue an |
|||
error message and leave the attribute off. |
|||
|
|||
D Inhibit access datestamp (f3). Under ZSDOS, when this |
|||
attribute is set, the file's access datestamp will not |
|||
be updated, which may speed file access slightly. If |
|||
the attribute is turned off, normal access datestamping |
|||
resumes. |
|||
|
|||
4 F4. This is a user attribute which has no predefined |
|||
meaning. |
|||
|
|||
W Wheel protect (f8). Under ZSDOS, when this attribute |
|||
is set, the file becomes read-only when the wheel byte |
|||
is off and cannot be erased. If the wheel byte is on, |
|||
the file can be erased normally. |
|||
|
|||
R Read only (t1). When this attribute is set, the file |
|||
cannot be erased or modified by most programs. |
|||
|
|||
S System (t2). When this attribute is set, the file |
|||
becomes a "hidden" file that will not be found by most |
|||
directory programs or by most well-behaved utilities |
|||
that accept ambiguous filenames. (FA must find system |
|||
files, of course.) |
|||
|
|||
A Archive (t3). When this attribute is set, it signals |
|||
some archival programs that the file has not been |
|||
modified since it was last backed up. If a file is |
|||
modified, ZSDOS and ZRDOS turn this attribute off. |
|||
CP/M does not fully support this attribute, however. |
|||
|
|||
OTHER OPTIONS: These options affect only the screen display. |
|||
|
|||
Q Quiet mode. Console output is suppressed unless there |
|||
is an error. All other operations are performed |
|||
normally. |
|||
|
|||
X Screen paging off. With this option, screen paging is |
|||
turned off. The screen can still be paused by pressing |
|||
any key except ^C. |
|||
|
|||
ERRORS: Under ZCPR3, errors will cause FA to set the program |
|||
error flag and to invoke the error handler. The error flag will |
|||
be set to the following values: |
|||
2 invalid directory specification |
|||
4 miscellaneous (conflicting file, no files on disk) |
|||
10 no matching files found (no error handler) |
|||
18 Disk read-only |
|||
19 Invalid option |
|||
|
|||
For error code 10 (no matching files found), the error flag is |
|||
set, but the error handler is not called. |
|||
|
|||
In addition, under ZCPR 3.3 and above, an invalid directory |
|||
specification will abort FA to the error handler, but no message |
|||
is printed. |
|||
|
|||
The following error messages may be seen: |
|||
|
|||
Conflicting entry, can't set public attribute |
|||
If there are files with the same name in other user areas of |
|||
the disk, the public attribute cannot be set. |
|||
|
|||
No files on disk |
|||
The disk directory is empty. |
|||
|
|||
Bad Option: /o |
|||
The command line option shown is unknown to FILEATTR. |
|||
|
|||
Drive R/O |
|||
The drive is set to read-only by the operating system and |
|||
attributes cannot be changed. |
|||
|
|||
CP/M version 2.x required |
|||
FILEATTR will not run on this system. |
|||
|
|||
BIOS write error near directory sector n |
|||
An error occurred at or near the given directory sector, |
|||
which is expressed as a decimal offset from the beginning of |
|||
the directory. |
|||
|
|||
BIOS set track detected - FA aborting |
|||
A background program is attempting to modify the current |
|||
track setting. The background program must be removeed |
|||
before running FA again. |
|||
|
|||
Not Wheel |
|||
Under ZCPR3 the wheel byte must be set before FILEATTR can |
|||
be run. |
|||
|
|||
CONFIGURATION: While no installation is necessary, all options |
|||
can be set as defaults, if you prefer, using ZCNFG. The |
|||
configuration options are fully explained on the ZCNFG help |
|||
screens. |
|||
|
|||
It is best not to change the name of the configuration file. Its |
|||
special name assures that ZCNFG will always find the correct CFG |
|||
file, even if the name of FA has been changed or if more than one |
|||
version of FA is online. |
|||
|
|||
HISTORY: |
|||
|
|||
Version 1.6 -- April 14, 1991 -- Gene Pizzetta |
|||
Now displays target DU and directory name in summary. Fixed |
|||
bug that caused "GO" to be displayed as program name, if it |
|||
was re-invoked with the GO command. |
|||
|
|||
Version 1.5 -- March 27, 1991 -- Gene Pizzetta |
|||
Now calls CP/M version checking routine (it was there, but |
|||
it wasn't called). Changed error codes: 10, no matching |
|||
files found. "No files on disk" error now gets |
|||
miscellaneous error code (4). Error 10 does not invoke |
|||
error handler. Not released. |
|||
|
|||
Version 1.4 -- March 20, 1991 -- Gene Pizzetta, Howard Goldstein |
|||
Code to check module data byte (S2) was replaced by Howard |
|||
Goldstein's elegant solution which uses a "true" extent |
|||
number: ((data_mod * 32) + extent). Entering a ^C no |
|||
longer really aborts FILEATTR; instead FA immediately prints |
|||
"Wait..." on the screen, turns off paging, turns on quiet |
|||
mode, sets the results flag, and finishes what it was doing. |
|||
All this is to prevent unexpected results when only some of |
|||
a file's directory entries are changed. All errors |
|||
including a conflicting file found during a PUBLIC request, |
|||
now set the program error flag and invoke the error handler |
|||
so an active SUBMIT or ZEX script can be aborted. The error |
|||
flag will have the following values: 2, invalid directory; |
|||
10, no files on disk; 18, disk is read-only; 19, invalid |
|||
option; 4, all other errors. If no matching files are |
|||
found, the program error flag will be set to FFh, but the |
|||
error handler will not be invoked. A few other code changes |
|||
were made, including a check for CP/M-Plus, under which |
|||
FILEATTR will not work. Not released. |
|||
|
|||
Version 1.3 -- February 22, 1991 -- Gene Pizzetta |
|||
Corrected bug that caused faulty operation on large files: |
|||
The module data byte (S2) byte was not being checked, so |
|||
such files appeared 2 or more times in the directory display |
|||
and the public routine was often not finding conflicting |
|||
files. Added configuration byte and command line option (X) |
|||
for screen paging (paging is suppressed in quiet mode). |
|||
Made quiet mode responsive to ZCPR quiet flag and changed Q |
|||
command line option to toggle. Usage screen reflects |
|||
current effect of X and Q toggles. Attribute configuration |
|||
area changed to be compatible with ZCNFG TOGL3 routine. |
|||
Actions of D and ND options reversed so they work the same |
|||
as the others. Added configuration byte for printing |
|||
summary line even in quiet mode, as suggested by Howard |
|||
Goldstein. Removed blank lines from screen display, |
|||
allowing three more filenames to be shown. Removed tabs |
|||
from usage screen so PRINT and PSTR are not needed. |
|||
Eliminated leading zero from user number display. Now |
|||
prints "file" instead of "files" in summary when only 1 |
|||
matching file is found. Ditto for attribute(s) altered. |
|||
|
|||
Version 1.2 -- November 30, 1988 -- Carson Wilson |
|||
Fixed bug of no program name display when FILEATTR's name |
|||
was 8 characters long. |
|||
|
|||
Version 1.1 -- October 30, 1988 -- Carson Wilson |
|||
Now wildcards the command forms "FA d: /options" and "FA d: |
|||
options." |
|||
|
|||
Version 1.0 -- September 26, 1988 -- Carson Wilson |
|||
If a filespec is given, no leading slash is required before |
|||
the options. Link with version 4 libraries. Removed /X |
|||
option--ZSDOS 10T always closes the first extent when a file |
|||
is written to. Changed summary to read "files matched". |
|||
|
|||
Version 0.9 -- July 7, 1988 -- Carson Wilson |
|||
Increased length of search FCB (AMBFIL) by one byte. Set up |
|||
AMBFIL as '?' + 35 binary 0's. ZRDOS and CP/M zero the |
|||
drive byte (FCB+0) during search next calls, so reinitialize |
|||
it to '?' before rescanning the directory. PROGID now |
|||
prints stored name on GO/JUMP. |
|||
|
|||
Version 0.8 -- June 26, 1988 -- Carson Wilson |
|||
Use SYSLIB PRINT for help display. VPRINT does not expand |
|||
tabs. Now traps disk track changes at the BIOS level. |
|||
Allows '-' as well as 'N' for "negate option." Auto- |
|||
wildcards FCB1 for attribute set as well as display. |
|||
|
|||
Version 0.7 -- May 24, 1988 -- Carson Wilson |
|||
Cosmetic changes to help, display. Made public routines |
|||
faster by 1/2 directory scan average. Consolidated file |
|||
attribute setting/resetting routines for efficiency and |
|||
clarity. |
|||
|
|||
Version 0.6 -- May 14, 1988 -- Carson Wilson |
|||
Changed "Publ" to "Publc" and "Priv" to "Privt". Added Q |
|||
and X options, made options installable. Added test for bad |
|||
ZCPR directory & chain to error handler. |
|||
|
|||
Version 0.5 -- May 4, 1988 -- Carson Wilson |
|||
Fixed bug at CHKRO inherited from MAKE.ASM. Uses Bridger |
|||
Mitchell's FRESET to reset disks. Uses ZCPR invocation name |
|||
in signon, help, etc. Added F4 attribute. Now includes all |
|||
valid ZSDOS attributes. Help now fully "smart" under ZCPR. |
|||
Reworked VID3.Z80 and VID4.Z80 from VLIB11 and moved them |
|||
into FA.Z80 (see end of file). Put STNDOUT mode ON by |
|||
default at beginning of each attribute display sequence for |
|||
faster ZCPR displays. |
|||
|
|||
Version 0.4 -- April 27, 1988 -- Carson Wilson |
|||
Tests for matching files at other user areas before setting |
|||
the public attribit. |
|||
|
|||
Version 0.3 -- April 26, 1988 -- Carson Wilson |
|||
@ -0,0 +1,6 @@ |
|||
An update and bug-fix of FILEATTR (FA), a ZSDOS utility that |
|||
allows rapid setting, resetting, or displaying of file attributes |
|||
under ZSDOS, ZRDOS, and CP/M 2.2. Several additional features |
|||
are available under ZCPR3, including error flag setting, error |
|||
handler invocation, and an enhanced display. Version 1.6A adds |
|||
documentation; otherwise, same as 1.6. |
|||
@ -0,0 +1,39 @@ |
|||
|
|||
Option Q -- If the ZCPR quiet flag is set, FILEATTR will always default to |
|||
quiet mode. To make quiet mode the default at all times, even when running |
|||
under CP/M, set this configuration option to "Yes". Whatever is selected |
|||
here can be toggled with the command line "Q" option. |
|||
|
|||
Option X -- A "Yes" will cause FILEATTR to page screen output by default. |
|||
A "No" will default to continuous scrolling. The chosen default can be |
|||
toggled with the command line "X" option. Screen paging is always turned |
|||
off in quiet mode. |
|||
|
|||
Option R -- As distributed, FILEATTR prints nothing to the screen when it |
|||
is operating in quiet mode. If this configuration option is "Yes", the |
|||
results summary line that gives the number of matching files found and the |
|||
number of attributes changed will be printed even in quiet mode. |
|||
|
|||
Option S -- Enter the number of lines on your video display screen. Under |
|||
ZCPR 3.3 and higher, the number of screen lines for paging is obtained from |
|||
the environment descriptor. This configuration parameter is used only if |
|||
running under CP/M. |
|||
|
|||
|
|||
Attribute Configuration Options |
|||
|
|||
As distributed, FILEATTR will not change any file attribute unless |
|||
explicitly commanded to do so by a command line option. To configure |
|||
FILEATTR to turn a file attribute ON or OFF by default, toggle the |
|||
appropriate configuration selection. |
|||
|
|||
For example, to make FILEATTR set all matching files to Public by default, |
|||
change the "Public attribute" setting to "Turn On". Then FILEATTR will set |
|||
the specified files to Public unless the /NP command line option is given |
|||
(which would cause the files to be set to Private). Since there is no |
|||
command which tells FILEATTR not to change an attribute, however, the |
|||
program will now insist on turning the Public attribute either on (default) |
|||
or off (through the /NP option). |
|||
|
|||
Most users will have neither need nor desire to change the configuration |
|||
default as distributed which will "Leave As-Is" all matching files. |
|||
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Some files were not shown because too many files changed in this diff
Loading…
Reference in new issue