Home » Archimedes archive » Acorn User » Acorn User - Shareware Collection (1993).adf » Zap » !Zap/Docs/ReadMe

!Zap/Docs/ReadMe

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » Acorn User - Shareware Collection (1993).adf » Zap
Filename: !Zap/Docs/ReadMe
Read OK: ✔
File size: 1A29 bytes
Load address: 0000
Exec address: 0000
File contents
*************************************************************************
* >ReadMe	Introduction to Zap documentation.			*
*************************************************************************

This file is an 'index' to all the other documentation files in the Docs
directory. All other documentation files begin with the prefix "E-".

This file is split into 2 sections:

	Section A:	How zap works.
	
	Section B:	Writing extension modes.
	
Please read them in this order.

The following abbreviations/notations will be used in the documentation
files:

'\E'	=	The entry conditions for this subroutine are ...
'\X'	=	The exit conditions for this subroutine are ...

The following register conventions will be used:

R8	=	Window block pointer. (See E-Windows for defn)
R9	=	File block pointer. (See E-File for defn)
R10	=	Cursor block pointer. (See E-Cursors for defn)
R11	=	Extension mode's workspace.
R12	=	Zap module's workspace.
R13	=	Full descending stack (1K), bottom = &8000

Thus for example if I write:

\E R8/R9

Then I mean that on entry, the subroutine has R8 pointing to the window
block, and R9 pointing to a file block on some file (the file the call deals
with). See also the files E-Zapcalls and E-Entry for the standard entry/exit
conditions of most Zap calls.

*************************************************************************
* Section A:	How zap works.						*
*************************************************************************

When Zap starts up it initialises a 1K stack, claims fixed size buffers and
initialises an operating system heap. File buffers are stacked on top of the
heap and shifted about as the heap or other files changes size. Thus zap's
memory map can be summarised as:

		TOP	Wimpslot end
			File n
			...
			File 1
			Heap
			Fixed size buffers
		&8000	Processor stack (R13) full descending.
		
To find out how to call zap please see the file E-Zapcalls. All zap calls
will be described by their name beginning "Zap_". The calls Zap_Claim,
Zap_Free, Zap_Ensure should be used to claim blocks from the heap. The call
Zap_SplitBuffer should be used to change the buffer size of a file.

Each file has a corresponding file block giving information about that file.
By convention R9 is used to hold a file block pointer. New file buffers can
be created via Zap_CreateFile, Zap_CreateFileBlk, Zap_InstallFile and can be
deleted via Zap_DeleteFile, Zap_DiscardFile. Files are stored in split buffer
form. Please see E-File for details.

Similarly, each window has a corresponding information block. By convention a
window block pointer is held in R8. Each window block determines uniquely a
file block, giving the file showing in the window. Please see the file
E-windows for details. New editing windows can be created by Zap_CreateFile,
Zap_CreateWindBlk, Zap_InstallFile, Zap_NewView and can be deleted by
Zap_DeleteWindow, Zap_DiscardWindow.

Cursor information blocks are described in the file E-Cursors. Cursor block
pointers are conventionally held in R10. Zap's internal variables can be read
by the call Zap_ReadVar and written by Zap_WriteVar. See the file E-Vars for
details. By using this call you may read the block pointers of the standard
cursor blocks.

Inserting/deleting/replacing data in files is accomplished via the calls
Zap_Command and Zap_DoCommand. The former calls the extension mode to perform
the required action and the latter is the low level call which performs the
action directly. Thus in practice, Zap_Command calls the extension mode which
then calls Zap_DoCommand. In this way the extension mode may alter the action
of all inserts or deletes. For example, text mode uses this to accomplish
wordwrap on all operations. See the file E-Zapcalls and E-Entry for more
details.

Please use the Zap_StartOp/Zap_StopOp structure to concatenate insertions/
deletions. This will give smooth update and will ensure that the operation is
undone with only one press of the undo key.

*************************************************************************
* Section B:	Writing extension modes.				*
*************************************************************************	

Zap extension modes are numbered 0-255. Currently I have only reserved space
for 16 of these (numbered 0-15). A mode consists of a table of entry points
and flags. This should be held in a module so that the code is always 'mapped
in to memory'. Currently defined modes are listed below. Please note that
mode names are CASE SENSITIVE throughout zap.

	0	Text
	1	Byte
	2	Word
	3	Ascii
	4	Code
	5	BASIC
	6	BASTXT
	7-10	-
	11	THROWBACK
	12	TASKWINDOW
	13-15	-
	
Before you start writing an extension mode, you should be familiar with
writing modules (preferably in assembler). In most cases, you will simply
wish to 'doctor' the input/output of one of the currently defined mode entry
points. For example, you may wish to change the typed characters entry point
of the TEXT mode to change `` to a left double quote. This is fairly simple
to do. If, however, you wish to write a full blown mode with, for example,
it's own display format, then you are strongly advised to contact me first.
I will be able to give you more support than these text files, and will be
able to add the new zap calls and entry points that you may require.

To install a new mode you should write a module, which on initialisation
calls Zap_AddMode with a pointer to the mode table. This module should then
be RMLOAD'ed from the !Run file. It should be loaded AFTER the zap module has
been loaded but BEFORE zap starts up via the Zap_Desktop call (see !Run
file). When Zap starts up, it will examine the mode entry point table and
copy it into zap's workspace, converting module offsets to actual addresses
in the process. The call Zap_ReadMode can be used to find the address of both
these tables for any given mode. Hence you can manually alter the mode entry
point of any mode.

The entry point table format is described in the file E-Entry. Please note
that you only have to fill in the first 8 words. In the fourth entry you
specify a BASE MODE. This mode is called instead of yours for all the mode
entry points you don't want to support/change. Hence in most cases you will
set a base mode of 0 (ie TEXT), and set all of the entry points except those
you wish to change to 0.

*************************************************************************
* Section C:	Adding new tables of commands				*
*************************************************************************

Unfortunately you will not be able to add new commands until version 1.00.
This is because I am rewriting the internal command structure to be more
flexible (see 'Changes' file). Sorry!

00000000  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000040  2a 2a 2a 2a 2a 2a 2a 2a  2a 0a 2a 20 3e 52 65 61  |*********.* >Rea|
00000050  64 4d 65 09 49 6e 74 72  6f 64 75 63 74 69 6f 6e  |dMe.Introduction|
00000060  20 74 6f 20 5a 61 70 20  64 6f 63 75 6d 65 6e 74  | to Zap document|
00000070  61 74 69 6f 6e 2e 09 09  09 2a 0a 2a 2a 2a 2a 2a  |ation....*.*****|
00000080  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000000c0  2a 2a 2a 2a 0a 0a 54 68  69 73 20 66 69 6c 65 20  |****..This file |
000000d0  69 73 20 61 6e 20 27 69  6e 64 65 78 27 20 74 6f  |is an 'index' to|
000000e0  20 61 6c 6c 20 74 68 65  20 6f 74 68 65 72 20 64  | all the other d|
000000f0  6f 63 75 6d 65 6e 74 61  74 69 6f 6e 20 66 69 6c  |ocumentation fil|
00000100  65 73 20 69 6e 20 74 68  65 20 44 6f 63 73 0a 64  |es in the Docs.d|
00000110  69 72 65 63 74 6f 72 79  2e 20 41 6c 6c 20 6f 74  |irectory. All ot|
00000120  68 65 72 20 64 6f 63 75  6d 65 6e 74 61 74 69 6f  |her documentatio|
00000130  6e 20 66 69 6c 65 73 20  62 65 67 69 6e 20 77 69  |n files begin wi|
00000140  74 68 20 74 68 65 20 70  72 65 66 69 78 20 22 45  |th the prefix "E|
00000150  2d 22 2e 0a 0a 54 68 69  73 20 66 69 6c 65 20 69  |-"...This file i|
00000160  73 20 73 70 6c 69 74 20  69 6e 74 6f 20 32 20 73  |s split into 2 s|
00000170  65 63 74 69 6f 6e 73 3a  0a 0a 09 53 65 63 74 69  |ections:...Secti|
00000180  6f 6e 20 41 3a 09 48 6f  77 20 7a 61 70 20 77 6f  |on A:.How zap wo|
00000190  72 6b 73 2e 0a 09 0a 09  53 65 63 74 69 6f 6e 20  |rks.....Section |
000001a0  42 3a 09 57 72 69 74 69  6e 67 20 65 78 74 65 6e  |B:.Writing exten|
000001b0  73 69 6f 6e 20 6d 6f 64  65 73 2e 0a 09 0a 50 6c  |sion modes....Pl|
000001c0  65 61 73 65 20 72 65 61  64 20 74 68 65 6d 20 69  |ease read them i|
000001d0  6e 20 74 68 69 73 20 6f  72 64 65 72 2e 0a 0a 54  |n this order...T|
000001e0  68 65 20 66 6f 6c 6c 6f  77 69 6e 67 20 61 62 62  |he following abb|
000001f0  72 65 76 69 61 74 69 6f  6e 73 2f 6e 6f 74 61 74  |reviations/notat|
00000200  69 6f 6e 73 20 77 69 6c  6c 20 62 65 20 75 73 65  |ions will be use|
00000210  64 20 69 6e 20 74 68 65  20 64 6f 63 75 6d 65 6e  |d in the documen|
00000220  74 61 74 69 6f 6e 0a 66  69 6c 65 73 3a 0a 0a 27  |tation.files:..'|
00000230  5c 45 27 09 3d 09 54 68  65 20 65 6e 74 72 79 20  |\E'.=.The entry |
00000240  63 6f 6e 64 69 74 69 6f  6e 73 20 66 6f 72 20 74  |conditions for t|
00000250  68 69 73 20 73 75 62 72  6f 75 74 69 6e 65 20 61  |his subroutine a|
00000260  72 65 20 2e 2e 2e 0a 27  5c 58 27 09 3d 09 54 68  |re ....'\X'.=.Th|
00000270  65 20 65 78 69 74 20 63  6f 6e 64 69 74 69 6f 6e  |e exit condition|
00000280  73 20 66 6f 72 20 74 68  69 73 20 73 75 62 72 6f  |s for this subro|
00000290  75 74 69 6e 65 20 61 72  65 20 2e 2e 2e 0a 0a 54  |utine are .....T|
000002a0  68 65 20 66 6f 6c 6c 6f  77 69 6e 67 20 72 65 67  |he following reg|
000002b0  69 73 74 65 72 20 63 6f  6e 76 65 6e 74 69 6f 6e  |ister convention|
000002c0  73 20 77 69 6c 6c 20 62  65 20 75 73 65 64 3a 0a  |s will be used:.|
000002d0  0a 52 38 09 3d 09 57 69  6e 64 6f 77 20 62 6c 6f  |.R8.=.Window blo|
000002e0  63 6b 20 70 6f 69 6e 74  65 72 2e 20 28 53 65 65  |ck pointer. (See|
000002f0  20 45 2d 57 69 6e 64 6f  77 73 20 66 6f 72 20 64  | E-Windows for d|
00000300  65 66 6e 29 0a 52 39 09  3d 09 46 69 6c 65 20 62  |efn).R9.=.File b|
00000310  6c 6f 63 6b 20 70 6f 69  6e 74 65 72 2e 20 28 53  |lock pointer. (S|
00000320  65 65 20 45 2d 46 69 6c  65 20 66 6f 72 20 64 65  |ee E-File for de|
00000330  66 6e 29 0a 52 31 30 09  3d 09 43 75 72 73 6f 72  |fn).R10.=.Cursor|
00000340  20 62 6c 6f 63 6b 20 70  6f 69 6e 74 65 72 2e 20  | block pointer. |
00000350  28 53 65 65 20 45 2d 43  75 72 73 6f 72 73 20 66  |(See E-Cursors f|
00000360  6f 72 20 64 65 66 6e 29  0a 52 31 31 09 3d 09 45  |or defn).R11.=.E|
00000370  78 74 65 6e 73 69 6f 6e  20 6d 6f 64 65 27 73 20  |xtension mode's |
00000380  77 6f 72 6b 73 70 61 63  65 2e 0a 52 31 32 09 3d  |workspace..R12.=|
00000390  09 5a 61 70 20 6d 6f 64  75 6c 65 27 73 20 77 6f  |.Zap module's wo|
000003a0  72 6b 73 70 61 63 65 2e  0a 52 31 33 09 3d 09 46  |rkspace..R13.=.F|
000003b0  75 6c 6c 20 64 65 73 63  65 6e 64 69 6e 67 20 73  |ull descending s|
000003c0  74 61 63 6b 20 28 31 4b  29 2c 20 62 6f 74 74 6f  |tack (1K), botto|
000003d0  6d 20 3d 20 26 38 30 30  30 0a 0a 54 68 75 73 20  |m = &8000..Thus |
000003e0  66 6f 72 20 65 78 61 6d  70 6c 65 20 69 66 20 49  |for example if I|
000003f0  20 77 72 69 74 65 3a 0a  0a 5c 45 20 52 38 2f 52  | write:..\E R8/R|
00000400  39 0a 0a 54 68 65 6e 20  49 20 6d 65 61 6e 20 74  |9..Then I mean t|
00000410  68 61 74 20 6f 6e 20 65  6e 74 72 79 2c 20 74 68  |hat on entry, th|
00000420  65 20 73 75 62 72 6f 75  74 69 6e 65 20 68 61 73  |e subroutine has|
00000430  20 52 38 20 70 6f 69 6e  74 69 6e 67 20 74 6f 20  | R8 pointing to |
00000440  74 68 65 20 77 69 6e 64  6f 77 0a 62 6c 6f 63 6b  |the window.block|
00000450  2c 20 61 6e 64 20 52 39  20 70 6f 69 6e 74 69 6e  |, and R9 pointin|
00000460  67 20 74 6f 20 61 20 66  69 6c 65 20 62 6c 6f 63  |g to a file bloc|
00000470  6b 20 6f 6e 20 73 6f 6d  65 20 66 69 6c 65 20 28  |k on some file (|
00000480  74 68 65 20 66 69 6c 65  20 74 68 65 20 63 61 6c  |the file the cal|
00000490  6c 20 64 65 61 6c 73 0a  77 69 74 68 29 2e 20 53  |l deals.with). S|
000004a0  65 65 20 61 6c 73 6f 20  74 68 65 20 66 69 6c 65  |ee also the file|
000004b0  73 20 45 2d 5a 61 70 63  61 6c 6c 73 20 61 6e 64  |s E-Zapcalls and|
000004c0  20 45 2d 45 6e 74 72 79  20 66 6f 72 20 74 68 65  | E-Entry for the|
000004d0  20 73 74 61 6e 64 61 72  64 20 65 6e 74 72 79 2f  | standard entry/|
000004e0  65 78 69 74 0a 63 6f 6e  64 69 74 69 6f 6e 73 20  |exit.conditions |
000004f0  6f 66 20 6d 6f 73 74 20  5a 61 70 20 63 61 6c 6c  |of most Zap call|
00000500  73 2e 0a 0a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |s...************|
00000510  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000540  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 0a 2a 20  |*************.* |
00000550  53 65 63 74 69 6f 6e 20  41 3a 09 48 6f 77 20 7a  |Section A:.How z|
00000560  61 70 20 77 6f 72 6b 73  2e 09 09 09 09 09 09 2a  |ap works.......*|
00000570  0a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |.***************|
00000580  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000005b0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 0a 0a 57 68 65 6e  |**********..When|
000005c0  20 5a 61 70 20 73 74 61  72 74 73 20 75 70 20 69  | Zap starts up i|
000005d0  74 20 69 6e 69 74 69 61  6c 69 73 65 73 20 61 20  |t initialises a |
000005e0  31 4b 20 73 74 61 63 6b  2c 20 63 6c 61 69 6d 73  |1K stack, claims|
000005f0  20 66 69 78 65 64 20 73  69 7a 65 20 62 75 66 66  | fixed size buff|
00000600  65 72 73 20 61 6e 64 0a  69 6e 69 74 69 61 6c 69  |ers and.initiali|
00000610  73 65 73 20 61 6e 20 6f  70 65 72 61 74 69 6e 67  |ses an operating|
00000620  20 73 79 73 74 65 6d 20  68 65 61 70 2e 20 46 69  | system heap. Fi|
00000630  6c 65 20 62 75 66 66 65  72 73 20 61 72 65 20 73  |le buffers are s|
00000640  74 61 63 6b 65 64 20 6f  6e 20 74 6f 70 20 6f 66  |tacked on top of|
00000650  20 74 68 65 0a 68 65 61  70 20 61 6e 64 20 73 68  | the.heap and sh|
00000660  69 66 74 65 64 20 61 62  6f 75 74 20 61 73 20 74  |ifted about as t|
00000670  68 65 20 68 65 61 70 20  6f 72 20 6f 74 68 65 72  |he heap or other|
00000680  20 66 69 6c 65 73 20 63  68 61 6e 67 65 73 20 73  | files changes s|
00000690  69 7a 65 2e 20 54 68 75  73 20 7a 61 70 27 73 0a  |ize. Thus zap's.|
000006a0  6d 65 6d 6f 72 79 20 6d  61 70 20 63 61 6e 20 62  |memory map can b|
000006b0  65 20 73 75 6d 6d 61 72  69 73 65 64 20 61 73 3a  |e summarised as:|
000006c0  0a 0a 09 09 54 4f 50 09  57 69 6d 70 73 6c 6f 74  |....TOP.Wimpslot|
000006d0  20 65 6e 64 0a 09 09 09  46 69 6c 65 20 6e 0a 09  | end....File n..|
000006e0  09 09 2e 2e 2e 0a 09 09  09 46 69 6c 65 20 31 0a  |.........File 1.|
000006f0  09 09 09 48 65 61 70 0a  09 09 09 46 69 78 65 64  |...Heap....Fixed|
00000700  20 73 69 7a 65 20 62 75  66 66 65 72 73 0a 09 09  | size buffers...|
00000710  26 38 30 30 30 09 50 72  6f 63 65 73 73 6f 72 20  |&8000.Processor |
00000720  73 74 61 63 6b 20 28 52  31 33 29 20 66 75 6c 6c  |stack (R13) full|
00000730  20 64 65 73 63 65 6e 64  69 6e 67 2e 0a 09 09 0a  | descending.....|
00000740  54 6f 20 66 69 6e 64 20  6f 75 74 20 68 6f 77 20  |To find out how |
00000750  74 6f 20 63 61 6c 6c 20  7a 61 70 20 70 6c 65 61  |to call zap plea|
00000760  73 65 20 73 65 65 20 74  68 65 20 66 69 6c 65 20  |se see the file |
00000770  45 2d 5a 61 70 63 61 6c  6c 73 2e 20 41 6c 6c 20  |E-Zapcalls. All |
00000780  7a 61 70 20 63 61 6c 6c  73 0a 77 69 6c 6c 20 62  |zap calls.will b|
00000790  65 20 64 65 73 63 72 69  62 65 64 20 62 79 20 74  |e described by t|
000007a0  68 65 69 72 20 6e 61 6d  65 20 62 65 67 69 6e 6e  |heir name beginn|
000007b0  69 6e 67 20 22 5a 61 70  5f 22 2e 20 54 68 65 20  |ing "Zap_". The |
000007c0  63 61 6c 6c 73 20 5a 61  70 5f 43 6c 61 69 6d 2c  |calls Zap_Claim,|
000007d0  0a 5a 61 70 5f 46 72 65  65 2c 20 5a 61 70 5f 45  |.Zap_Free, Zap_E|
000007e0  6e 73 75 72 65 20 73 68  6f 75 6c 64 20 62 65 20  |nsure should be |
000007f0  75 73 65 64 20 74 6f 20  63 6c 61 69 6d 20 62 6c  |used to claim bl|
00000800  6f 63 6b 73 20 66 72 6f  6d 20 74 68 65 20 68 65  |ocks from the he|
00000810  61 70 2e 20 54 68 65 20  63 61 6c 6c 0a 5a 61 70  |ap. The call.Zap|
00000820  5f 53 70 6c 69 74 42 75  66 66 65 72 20 73 68 6f  |_SplitBuffer sho|
00000830  75 6c 64 20 62 65 20 75  73 65 64 20 74 6f 20 63  |uld be used to c|
00000840  68 61 6e 67 65 20 74 68  65 20 62 75 66 66 65 72  |hange the buffer|
00000850  20 73 69 7a 65 20 6f 66  20 61 20 66 69 6c 65 2e  | size of a file.|
00000860  0a 0a 45 61 63 68 20 66  69 6c 65 20 68 61 73 20  |..Each file has |
00000870  61 20 63 6f 72 72 65 73  70 6f 6e 64 69 6e 67 20  |a corresponding |
00000880  66 69 6c 65 20 62 6c 6f  63 6b 20 67 69 76 69 6e  |file block givin|
00000890  67 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 61 62  |g information ab|
000008a0  6f 75 74 20 74 68 61 74  20 66 69 6c 65 2e 0a 42  |out that file..B|
000008b0  79 20 63 6f 6e 76 65 6e  74 69 6f 6e 20 52 39 20  |y convention R9 |
000008c0  69 73 20 75 73 65 64 20  74 6f 20 68 6f 6c 64 20  |is used to hold |
000008d0  61 20 66 69 6c 65 20 62  6c 6f 63 6b 20 70 6f 69  |a file block poi|
000008e0  6e 74 65 72 2e 20 4e 65  77 20 66 69 6c 65 20 62  |nter. New file b|
000008f0  75 66 66 65 72 73 20 63  61 6e 0a 62 65 20 63 72  |uffers can.be cr|
00000900  65 61 74 65 64 20 76 69  61 20 5a 61 70 5f 43 72  |eated via Zap_Cr|
00000910  65 61 74 65 46 69 6c 65  2c 20 5a 61 70 5f 43 72  |eateFile, Zap_Cr|
00000920  65 61 74 65 46 69 6c 65  42 6c 6b 2c 20 5a 61 70  |eateFileBlk, Zap|
00000930  5f 49 6e 73 74 61 6c 6c  46 69 6c 65 20 61 6e 64  |_InstallFile and|
00000940  20 63 61 6e 20 62 65 0a  64 65 6c 65 74 65 64 20  | can be.deleted |
00000950  76 69 61 20 5a 61 70 5f  44 65 6c 65 74 65 46 69  |via Zap_DeleteFi|
00000960  6c 65 2c 20 5a 61 70 5f  44 69 73 63 61 72 64 46  |le, Zap_DiscardF|
00000970  69 6c 65 2e 20 46 69 6c  65 73 20 61 72 65 20 73  |ile. Files are s|
00000980  74 6f 72 65 64 20 69 6e  20 73 70 6c 69 74 20 62  |tored in split b|
00000990  75 66 66 65 72 0a 66 6f  72 6d 2e 20 50 6c 65 61  |uffer.form. Plea|
000009a0  73 65 20 73 65 65 20 45  2d 46 69 6c 65 20 66 6f  |se see E-File fo|
000009b0  72 20 64 65 74 61 69 6c  73 2e 0a 0a 53 69 6d 69  |r details...Simi|
000009c0  6c 61 72 6c 79 2c 20 65  61 63 68 20 77 69 6e 64  |larly, each wind|
000009d0  6f 77 20 68 61 73 20 61  20 63 6f 72 72 65 73 70  |ow has a corresp|
000009e0  6f 6e 64 69 6e 67 20 69  6e 66 6f 72 6d 61 74 69  |onding informati|
000009f0  6f 6e 20 62 6c 6f 63 6b  2e 20 42 79 20 63 6f 6e  |on block. By con|
00000a00  76 65 6e 74 69 6f 6e 20  61 0a 77 69 6e 64 6f 77  |vention a.window|
00000a10  20 62 6c 6f 63 6b 20 70  6f 69 6e 74 65 72 20 69  | block pointer i|
00000a20  73 20 68 65 6c 64 20 69  6e 20 52 38 2e 20 45 61  |s held in R8. Ea|
00000a30  63 68 20 77 69 6e 64 6f  77 20 62 6c 6f 63 6b 20  |ch window block |
00000a40  64 65 74 65 72 6d 69 6e  65 73 20 75 6e 69 71 75  |determines uniqu|
00000a50  65 6c 79 20 61 0a 66 69  6c 65 20 62 6c 6f 63 6b  |ely a.file block|
00000a60  2c 20 67 69 76 69 6e 67  20 74 68 65 20 66 69 6c  |, giving the fil|
00000a70  65 20 73 68 6f 77 69 6e  67 20 69 6e 20 74 68 65  |e showing in the|
00000a80  20 77 69 6e 64 6f 77 2e  20 50 6c 65 61 73 65 20  | window. Please |
00000a90  73 65 65 20 74 68 65 20  66 69 6c 65 0a 45 2d 77  |see the file.E-w|
00000aa0  69 6e 64 6f 77 73 20 66  6f 72 20 64 65 74 61 69  |indows for detai|
00000ab0  6c 73 2e 20 4e 65 77 20  65 64 69 74 69 6e 67 20  |ls. New editing |
00000ac0  77 69 6e 64 6f 77 73 20  63 61 6e 20 62 65 20 63  |windows can be c|
00000ad0  72 65 61 74 65 64 20 62  79 20 5a 61 70 5f 43 72  |reated by Zap_Cr|
00000ae0  65 61 74 65 46 69 6c 65  2c 0a 5a 61 70 5f 43 72  |eateFile,.Zap_Cr|
00000af0  65 61 74 65 57 69 6e 64  42 6c 6b 2c 20 5a 61 70  |eateWindBlk, Zap|
00000b00  5f 49 6e 73 74 61 6c 6c  46 69 6c 65 2c 20 5a 61  |_InstallFile, Za|
00000b10  70 5f 4e 65 77 56 69 65  77 20 61 6e 64 20 63 61  |p_NewView and ca|
00000b20  6e 20 62 65 20 64 65 6c  65 74 65 64 20 62 79 0a  |n be deleted by.|
00000b30  5a 61 70 5f 44 65 6c 65  74 65 57 69 6e 64 6f 77  |Zap_DeleteWindow|
00000b40  2c 20 5a 61 70 5f 44 69  73 63 61 72 64 57 69 6e  |, Zap_DiscardWin|
00000b50  64 6f 77 2e 0a 0a 43 75  72 73 6f 72 20 69 6e 66  |dow...Cursor inf|
00000b60  6f 72 6d 61 74 69 6f 6e  20 62 6c 6f 63 6b 73 20  |ormation blocks |
00000b70  61 72 65 20 64 65 73 63  72 69 62 65 64 20 69 6e  |are described in|
00000b80  20 74 68 65 20 66 69 6c  65 20 45 2d 43 75 72 73  | the file E-Curs|
00000b90  6f 72 73 2e 20 43 75 72  73 6f 72 20 62 6c 6f 63  |ors. Cursor bloc|
00000ba0  6b 0a 70 6f 69 6e 74 65  72 73 20 61 72 65 20 63  |k.pointers are c|
00000bb0  6f 6e 76 65 6e 74 69 6f  6e 61 6c 6c 79 20 68 65  |onventionally he|
00000bc0  6c 64 20 69 6e 20 52 31  30 2e 20 5a 61 70 27 73  |ld in R10. Zap's|
00000bd0  20 69 6e 74 65 72 6e 61  6c 20 76 61 72 69 61 62  | internal variab|
00000be0  6c 65 73 20 63 61 6e 20  62 65 20 72 65 61 64 0a  |les can be read.|
00000bf0  62 79 20 74 68 65 20 63  61 6c 6c 20 5a 61 70 5f  |by the call Zap_|
00000c00  52 65 61 64 56 61 72 20  61 6e 64 20 77 72 69 74  |ReadVar and writ|
00000c10  74 65 6e 20 62 79 20 5a  61 70 5f 57 72 69 74 65  |ten by Zap_Write|
00000c20  56 61 72 2e 20 53 65 65  20 74 68 65 20 66 69 6c  |Var. See the fil|
00000c30  65 20 45 2d 56 61 72 73  20 66 6f 72 0a 64 65 74  |e E-Vars for.det|
00000c40  61 69 6c 73 2e 20 42 79  20 75 73 69 6e 67 20 74  |ails. By using t|
00000c50  68 69 73 20 63 61 6c 6c  20 79 6f 75 20 6d 61 79  |his call you may|
00000c60  20 72 65 61 64 20 74 68  65 20 62 6c 6f 63 6b 20  | read the block |
00000c70  70 6f 69 6e 74 65 72 73  20 6f 66 20 74 68 65 20  |pointers of the |
00000c80  73 74 61 6e 64 61 72 64  0a 63 75 72 73 6f 72 20  |standard.cursor |
00000c90  62 6c 6f 63 6b 73 2e 0a  0a 49 6e 73 65 72 74 69  |blocks...Inserti|
00000ca0  6e 67 2f 64 65 6c 65 74  69 6e 67 2f 72 65 70 6c  |ng/deleting/repl|
00000cb0  61 63 69 6e 67 20 64 61  74 61 20 69 6e 20 66 69  |acing data in fi|
00000cc0  6c 65 73 20 69 73 20 61  63 63 6f 6d 70 6c 69 73  |les is accomplis|
00000cd0  68 65 64 20 76 69 61 20  74 68 65 20 63 61 6c 6c  |hed via the call|
00000ce0  73 0a 5a 61 70 5f 43 6f  6d 6d 61 6e 64 20 61 6e  |s.Zap_Command an|
00000cf0  64 20 5a 61 70 5f 44 6f  43 6f 6d 6d 61 6e 64 2e  |d Zap_DoCommand.|
00000d00  20 54 68 65 20 66 6f 72  6d 65 72 20 63 61 6c 6c  | The former call|
00000d10  73 20 74 68 65 20 65 78  74 65 6e 73 69 6f 6e 20  |s the extension |
00000d20  6d 6f 64 65 20 74 6f 20  70 65 72 66 6f 72 6d 0a  |mode to perform.|
00000d30  74 68 65 20 72 65 71 75  69 72 65 64 20 61 63 74  |the required act|
00000d40  69 6f 6e 20 61 6e 64 20  74 68 65 20 6c 61 74 74  |ion and the latt|
00000d50  65 72 20 69 73 20 74 68  65 20 6c 6f 77 20 6c 65  |er is the low le|
00000d60  76 65 6c 20 63 61 6c 6c  20 77 68 69 63 68 20 70  |vel call which p|
00000d70  65 72 66 6f 72 6d 73 20  74 68 65 0a 61 63 74 69  |erforms the.acti|
00000d80  6f 6e 20 64 69 72 65 63  74 6c 79 2e 20 54 68 75  |on directly. Thu|
00000d90  73 20 69 6e 20 70 72 61  63 74 69 63 65 2c 20 5a  |s in practice, Z|
00000da0  61 70 5f 43 6f 6d 6d 61  6e 64 20 63 61 6c 6c 73  |ap_Command calls|
00000db0  20 74 68 65 20 65 78 74  65 6e 73 69 6f 6e 20 6d  | the extension m|
00000dc0  6f 64 65 20 77 68 69 63  68 0a 74 68 65 6e 20 63  |ode which.then c|
00000dd0  61 6c 6c 73 20 5a 61 70  5f 44 6f 43 6f 6d 6d 61  |alls Zap_DoComma|
00000de0  6e 64 2e 20 49 6e 20 74  68 69 73 20 77 61 79 20  |nd. In this way |
00000df0  74 68 65 20 65 78 74 65  6e 73 69 6f 6e 20 6d 6f  |the extension mo|
00000e00  64 65 20 6d 61 79 20 61  6c 74 65 72 20 74 68 65  |de may alter the|
00000e10  20 61 63 74 69 6f 6e 0a  6f 66 20 61 6c 6c 20 69  | action.of all i|
00000e20  6e 73 65 72 74 73 20 6f  72 20 64 65 6c 65 74 65  |nserts or delete|
00000e30  73 2e 20 46 6f 72 20 65  78 61 6d 70 6c 65 2c 20  |s. For example, |
00000e40  74 65 78 74 20 6d 6f 64  65 20 75 73 65 73 20 74  |text mode uses t|
00000e50  68 69 73 20 74 6f 20 61  63 63 6f 6d 70 6c 69 73  |his to accomplis|
00000e60  68 0a 77 6f 72 64 77 72  61 70 20 6f 6e 20 61 6c  |h.wordwrap on al|
00000e70  6c 20 6f 70 65 72 61 74  69 6f 6e 73 2e 20 53 65  |l operations. Se|
00000e80  65 20 74 68 65 20 66 69  6c 65 20 45 2d 5a 61 70  |e the file E-Zap|
00000e90  63 61 6c 6c 73 20 61 6e  64 20 45 2d 45 6e 74 72  |calls and E-Entr|
00000ea0  79 20 66 6f 72 20 6d 6f  72 65 0a 64 65 74 61 69  |y for more.detai|
00000eb0  6c 73 2e 0a 0a 50 6c 65  61 73 65 20 75 73 65 20  |ls...Please use |
00000ec0  74 68 65 20 5a 61 70 5f  53 74 61 72 74 4f 70 2f  |the Zap_StartOp/|
00000ed0  5a 61 70 5f 53 74 6f 70  4f 70 20 73 74 72 75 63  |Zap_StopOp struc|
00000ee0  74 75 72 65 20 74 6f 20  63 6f 6e 63 61 74 65 6e  |ture to concaten|
00000ef0  61 74 65 20 69 6e 73 65  72 74 69 6f 6e 73 2f 0a  |ate insertions/.|
00000f00  64 65 6c 65 74 69 6f 6e  73 2e 20 54 68 69 73 20  |deletions. This |
00000f10  77 69 6c 6c 20 67 69 76  65 20 73 6d 6f 6f 74 68  |will give smooth|
00000f20  20 75 70 64 61 74 65 20  61 6e 64 20 77 69 6c 6c  | update and will|
00000f30  20 65 6e 73 75 72 65 20  74 68 61 74 20 74 68 65  | ensure that the|
00000f40  20 6f 70 65 72 61 74 69  6f 6e 20 69 73 0a 75 6e  | operation is.un|
00000f50  64 6f 6e 65 20 77 69 74  68 20 6f 6e 6c 79 20 6f  |done with only o|
00000f60  6e 65 20 70 72 65 73 73  20 6f 66 20 74 68 65 20  |ne press of the |
00000f70  75 6e 64 6f 20 6b 65 79  2e 0a 0a 2a 2a 2a 2a 2a  |undo key...*****|
00000f80  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00000fc0  2a 2a 2a 2a 0a 2a 20 53  65 63 74 69 6f 6e 20 42  |****.* Section B|
00000fd0  3a 09 57 72 69 74 69 6e  67 20 65 78 74 65 6e 73  |:.Writing extens|
00000fe0  69 6f 6e 20 6d 6f 64 65  73 2e 09 09 09 09 2a 0a  |ion modes.....*.|
00000ff0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001030  2a 2a 2a 2a 2a 2a 2a 2a  2a 09 0a 0a 5a 61 70 20  |*********...Zap |
00001040  65 78 74 65 6e 73 69 6f  6e 20 6d 6f 64 65 73 20  |extension modes |
00001050  61 72 65 20 6e 75 6d 62  65 72 65 64 20 30 2d 32  |are numbered 0-2|
00001060  35 35 2e 20 43 75 72 72  65 6e 74 6c 79 20 49 20  |55. Currently I |
00001070  68 61 76 65 20 6f 6e 6c  79 20 72 65 73 65 72 76  |have only reserv|
00001080  65 64 20 73 70 61 63 65  0a 66 6f 72 20 31 36 20  |ed space.for 16 |
00001090  6f 66 20 74 68 65 73 65  20 28 6e 75 6d 62 65 72  |of these (number|
000010a0  65 64 20 30 2d 31 35 29  2e 20 41 20 6d 6f 64 65  |ed 0-15). A mode|
000010b0  20 63 6f 6e 73 69 73 74  73 20 6f 66 20 61 20 74  | consists of a t|
000010c0  61 62 6c 65 20 6f 66 20  65 6e 74 72 79 20 70 6f  |able of entry po|
000010d0  69 6e 74 73 0a 61 6e 64  20 66 6c 61 67 73 2e 20  |ints.and flags. |
000010e0  54 68 69 73 20 73 68 6f  75 6c 64 20 62 65 20 68  |This should be h|
000010f0  65 6c 64 20 69 6e 20 61  20 6d 6f 64 75 6c 65 20  |eld in a module |
00001100  73 6f 20 74 68 61 74 20  74 68 65 20 63 6f 64 65  |so that the code|
00001110  20 69 73 20 61 6c 77 61  79 73 20 27 6d 61 70 70  | is always 'mapp|
00001120  65 64 0a 69 6e 20 74 6f  20 6d 65 6d 6f 72 79 27  |ed.in to memory'|
00001130  2e 20 43 75 72 72 65 6e  74 6c 79 20 64 65 66 69  |. Currently defi|
00001140  6e 65 64 20 6d 6f 64 65  73 20 61 72 65 20 6c 69  |ned modes are li|
00001150  73 74 65 64 20 62 65 6c  6f 77 2e 20 50 6c 65 61  |sted below. Plea|
00001160  73 65 20 6e 6f 74 65 20  74 68 61 74 0a 6d 6f 64  |se note that.mod|
00001170  65 20 6e 61 6d 65 73 20  61 72 65 20 43 41 53 45  |e names are CASE|
00001180  20 53 45 4e 53 49 54 49  56 45 20 74 68 72 6f 75  | SENSITIVE throu|
00001190  67 68 6f 75 74 20 7a 61  70 2e 0a 0a 09 30 09 54  |ghout zap....0.T|
000011a0  65 78 74 0a 09 31 09 42  79 74 65 0a 09 32 09 57  |ext..1.Byte..2.W|
000011b0  6f 72 64 0a 09 33 09 41  73 63 69 69 0a 09 34 09  |ord..3.Ascii..4.|
000011c0  43 6f 64 65 0a 09 35 09  42 41 53 49 43 0a 09 36  |Code..5.BASIC..6|
000011d0  09 42 41 53 54 58 54 0a  09 37 2d 31 30 09 2d 0a  |.BASTXT..7-10.-.|
000011e0  09 31 31 09 54 48 52 4f  57 42 41 43 4b 0a 09 31  |.11.THROWBACK..1|
000011f0  32 09 54 41 53 4b 57 49  4e 44 4f 57 0a 09 31 33  |2.TASKWINDOW..13|
00001200  2d 31 35 09 2d 0a 09 0a  42 65 66 6f 72 65 20 79  |-15.-...Before y|
00001210  6f 75 20 73 74 61 72 74  20 77 72 69 74 69 6e 67  |ou start writing|
00001220  20 61 6e 20 65 78 74 65  6e 73 69 6f 6e 20 6d 6f  | an extension mo|
00001230  64 65 2c 20 79 6f 75 20  73 68 6f 75 6c 64 20 62  |de, you should b|
00001240  65 20 66 61 6d 69 6c 69  61 72 20 77 69 74 68 0a  |e familiar with.|
00001250  77 72 69 74 69 6e 67 20  6d 6f 64 75 6c 65 73 20  |writing modules |
00001260  28 70 72 65 66 65 72 61  62 6c 79 20 69 6e 20 61  |(preferably in a|
00001270  73 73 65 6d 62 6c 65 72  29 2e 20 49 6e 20 6d 6f  |ssembler). In mo|
00001280  73 74 20 63 61 73 65 73  2c 20 79 6f 75 20 77 69  |st cases, you wi|
00001290  6c 6c 20 73 69 6d 70 6c  79 0a 77 69 73 68 20 74  |ll simply.wish t|
000012a0  6f 20 27 64 6f 63 74 6f  72 27 20 74 68 65 20 69  |o 'doctor' the i|
000012b0  6e 70 75 74 2f 6f 75 74  70 75 74 20 6f 66 20 6f  |nput/output of o|
000012c0  6e 65 20 6f 66 20 74 68  65 20 63 75 72 72 65 6e  |ne of the curren|
000012d0  74 6c 79 20 64 65 66 69  6e 65 64 20 6d 6f 64 65  |tly defined mode|
000012e0  20 65 6e 74 72 79 0a 70  6f 69 6e 74 73 2e 20 46  | entry.points. F|
000012f0  6f 72 20 65 78 61 6d 70  6c 65 2c 20 79 6f 75 20  |or example, you |
00001300  6d 61 79 20 77 69 73 68  20 74 6f 20 63 68 61 6e  |may wish to chan|
00001310  67 65 20 74 68 65 20 74  79 70 65 64 20 63 68 61  |ge the typed cha|
00001320  72 61 63 74 65 72 73 20  65 6e 74 72 79 20 70 6f  |racters entry po|
00001330  69 6e 74 0a 6f 66 20 74  68 65 20 54 45 58 54 20  |int.of the TEXT |
00001340  6d 6f 64 65 20 74 6f 20  63 68 61 6e 67 65 20 60  |mode to change `|
00001350  60 20 74 6f 20 61 20 6c  65 66 74 20 64 6f 75 62  |` to a left doub|
00001360  6c 65 20 71 75 6f 74 65  2e 20 54 68 69 73 20 69  |le quote. This i|
00001370  73 20 66 61 69 72 6c 79  20 73 69 6d 70 6c 65 0a  |s fairly simple.|
00001380  74 6f 20 64 6f 2e 20 49  66 2c 20 68 6f 77 65 76  |to do. If, howev|
00001390  65 72 2c 20 79 6f 75 20  77 69 73 68 20 74 6f 20  |er, you wish to |
000013a0  77 72 69 74 65 20 61 20  66 75 6c 6c 20 62 6c 6f  |write a full blo|
000013b0  77 6e 20 6d 6f 64 65 20  77 69 74 68 2c 20 66 6f  |wn mode with, fo|
000013c0  72 20 65 78 61 6d 70 6c  65 2c 0a 69 74 27 73 20  |r example,.it's |
000013d0  6f 77 6e 20 64 69 73 70  6c 61 79 20 66 6f 72 6d  |own display form|
000013e0  61 74 2c 20 74 68 65 6e  20 79 6f 75 20 61 72 65  |at, then you are|
000013f0  20 73 74 72 6f 6e 67 6c  79 20 61 64 76 69 73 65  | strongly advise|
00001400  64 20 74 6f 20 63 6f 6e  74 61 63 74 20 6d 65 20  |d to contact me |
00001410  66 69 72 73 74 2e 0a 49  20 77 69 6c 6c 20 62 65  |first..I will be|
00001420  20 61 62 6c 65 20 74 6f  20 67 69 76 65 20 79 6f  | able to give yo|
00001430  75 20 6d 6f 72 65 20 73  75 70 70 6f 72 74 20 74  |u more support t|
00001440  68 61 6e 20 74 68 65 73  65 20 74 65 78 74 20 66  |han these text f|
00001450  69 6c 65 73 2c 20 61 6e  64 20 77 69 6c 6c 20 62  |iles, and will b|
00001460  65 0a 61 62 6c 65 20 74  6f 20 61 64 64 20 74 68  |e.able to add th|
00001470  65 20 6e 65 77 20 7a 61  70 20 63 61 6c 6c 73 20  |e new zap calls |
00001480  61 6e 64 20 65 6e 74 72  79 20 70 6f 69 6e 74 73  |and entry points|
00001490  20 74 68 61 74 20 79 6f  75 20 6d 61 79 20 72 65  | that you may re|
000014a0  71 75 69 72 65 2e 0a 0a  54 6f 20 69 6e 73 74 61  |quire...To insta|
000014b0  6c 6c 20 61 20 6e 65 77  20 6d 6f 64 65 20 79 6f  |ll a new mode yo|
000014c0  75 20 73 68 6f 75 6c 64  20 77 72 69 74 65 20 61  |u should write a|
000014d0  20 6d 6f 64 75 6c 65 2c  20 77 68 69 63 68 20 6f  | module, which o|
000014e0  6e 20 69 6e 69 74 69 61  6c 69 73 61 74 69 6f 6e  |n initialisation|
000014f0  0a 63 61 6c 6c 73 20 5a  61 70 5f 41 64 64 4d 6f  |.calls Zap_AddMo|
00001500  64 65 20 77 69 74 68 20  61 20 70 6f 69 6e 74 65  |de with a pointe|
00001510  72 20 74 6f 20 74 68 65  20 6d 6f 64 65 20 74 61  |r to the mode ta|
00001520  62 6c 65 2e 20 54 68 69  73 20 6d 6f 64 75 6c 65  |ble. This module|
00001530  20 73 68 6f 75 6c 64 20  74 68 65 6e 0a 62 65 20  | should then.be |
00001540  52 4d 4c 4f 41 44 27 65  64 20 66 72 6f 6d 20 74  |RMLOAD'ed from t|
00001550  68 65 20 21 52 75 6e 20  66 69 6c 65 2e 20 49 74  |he !Run file. It|
00001560  20 73 68 6f 75 6c 64 20  62 65 20 6c 6f 61 64 65  | should be loade|
00001570  64 20 41 46 54 45 52 20  74 68 65 20 7a 61 70 20  |d AFTER the zap |
00001580  6d 6f 64 75 6c 65 20 68  61 73 0a 62 65 65 6e 20  |module has.been |
00001590  6c 6f 61 64 65 64 20 62  75 74 20 42 45 46 4f 52  |loaded but BEFOR|
000015a0  45 20 7a 61 70 20 73 74  61 72 74 73 20 75 70 20  |E zap starts up |
000015b0  76 69 61 20 74 68 65 20  5a 61 70 5f 44 65 73 6b  |via the Zap_Desk|
000015c0  74 6f 70 20 63 61 6c 6c  20 28 73 65 65 20 21 52  |top call (see !R|
000015d0  75 6e 0a 66 69 6c 65 29  2e 20 57 68 65 6e 20 5a  |un.file). When Z|
000015e0  61 70 20 73 74 61 72 74  73 20 75 70 2c 20 69 74  |ap starts up, it|
000015f0  20 77 69 6c 6c 20 65 78  61 6d 69 6e 65 20 74 68  | will examine th|
00001600  65 20 6d 6f 64 65 20 65  6e 74 72 79 20 70 6f 69  |e mode entry poi|
00001610  6e 74 20 74 61 62 6c 65  20 61 6e 64 0a 63 6f 70  |nt table and.cop|
00001620  79 20 69 74 20 69 6e 74  6f 20 7a 61 70 27 73 20  |y it into zap's |
00001630  77 6f 72 6b 73 70 61 63  65 2c 20 63 6f 6e 76 65  |workspace, conve|
00001640  72 74 69 6e 67 20 6d 6f  64 75 6c 65 20 6f 66 66  |rting module off|
00001650  73 65 74 73 20 74 6f 20  61 63 74 75 61 6c 20 61  |sets to actual a|
00001660  64 64 72 65 73 73 65 73  0a 69 6e 20 74 68 65 20  |ddresses.in the |
00001670  70 72 6f 63 65 73 73 2e  20 54 68 65 20 63 61 6c  |process. The cal|
00001680  6c 20 5a 61 70 5f 52 65  61 64 4d 6f 64 65 20 63  |l Zap_ReadMode c|
00001690  61 6e 20 62 65 20 75 73  65 64 20 74 6f 20 66 69  |an be used to fi|
000016a0  6e 64 20 74 68 65 20 61  64 64 72 65 73 73 20 6f  |nd the address o|
000016b0  66 20 62 6f 74 68 0a 74  68 65 73 65 20 74 61 62  |f both.these tab|
000016c0  6c 65 73 20 66 6f 72 20  61 6e 79 20 67 69 76 65  |les for any give|
000016d0  6e 20 6d 6f 64 65 2e 20  48 65 6e 63 65 20 79 6f  |n mode. Hence yo|
000016e0  75 20 63 61 6e 20 6d 61  6e 75 61 6c 6c 79 20 61  |u can manually a|
000016f0  6c 74 65 72 20 74 68 65  20 6d 6f 64 65 20 65 6e  |lter the mode en|
00001700  74 72 79 0a 70 6f 69 6e  74 20 6f 66 20 61 6e 79  |try.point of any|
00001710  20 6d 6f 64 65 2e 0a 0a  54 68 65 20 65 6e 74 72  | mode...The entr|
00001720  79 20 70 6f 69 6e 74 20  74 61 62 6c 65 20 66 6f  |y point table fo|
00001730  72 6d 61 74 20 69 73 20  64 65 73 63 72 69 62 65  |rmat is describe|
00001740  64 20 69 6e 20 74 68 65  20 66 69 6c 65 20 45 2d  |d in the file E-|
00001750  45 6e 74 72 79 2e 20 50  6c 65 61 73 65 20 6e 6f  |Entry. Please no|
00001760  74 65 0a 74 68 61 74 20  79 6f 75 20 6f 6e 6c 79  |te.that you only|
00001770  20 68 61 76 65 20 74 6f  20 66 69 6c 6c 20 69 6e  | have to fill in|
00001780  20 74 68 65 20 66 69 72  73 74 20 38 20 77 6f 72  | the first 8 wor|
00001790  64 73 2e 20 49 6e 20 74  68 65 20 66 6f 75 72 74  |ds. In the fourt|
000017a0  68 20 65 6e 74 72 79 20  79 6f 75 0a 73 70 65 63  |h entry you.spec|
000017b0  69 66 79 20 61 20 42 41  53 45 20 4d 4f 44 45 2e  |ify a BASE MODE.|
000017c0  20 54 68 69 73 20 6d 6f  64 65 20 69 73 20 63 61  | This mode is ca|
000017d0  6c 6c 65 64 20 69 6e 73  74 65 61 64 20 6f 66 20  |lled instead of |
000017e0  79 6f 75 72 73 20 66 6f  72 20 61 6c 6c 20 74 68  |yours for all th|
000017f0  65 20 6d 6f 64 65 0a 65  6e 74 72 79 20 70 6f 69  |e mode.entry poi|
00001800  6e 74 73 20 79 6f 75 20  64 6f 6e 27 74 20 77 61  |nts you don't wa|
00001810  6e 74 20 74 6f 20 73 75  70 70 6f 72 74 2f 63 68  |nt to support/ch|
00001820  61 6e 67 65 2e 20 48 65  6e 63 65 20 69 6e 20 6d  |ange. Hence in m|
00001830  6f 73 74 20 63 61 73 65  73 20 79 6f 75 20 77 69  |ost cases you wi|
00001840  6c 6c 0a 73 65 74 20 61  20 62 61 73 65 20 6d 6f  |ll.set a base mo|
00001850  64 65 20 6f 66 20 30 20  28 69 65 20 54 45 58 54  |de of 0 (ie TEXT|
00001860  29 2c 20 61 6e 64 20 73  65 74 20 61 6c 6c 20 6f  |), and set all o|
00001870  66 20 74 68 65 20 65 6e  74 72 79 20 70 6f 69 6e  |f the entry poin|
00001880  74 73 20 65 78 63 65 70  74 20 74 68 6f 73 65 0a  |ts except those.|
00001890  79 6f 75 20 77 69 73 68  20 74 6f 20 63 68 61 6e  |you wish to chan|
000018a0  67 65 20 74 6f 20 30 2e  0a 0a 2a 2a 2a 2a 2a 2a  |ge to 0...******|
000018b0  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
000018f0  2a 2a 2a 0a 2a 20 53 65  63 74 69 6f 6e 20 43 3a  |***.* Section C:|
00001900  09 41 64 64 69 6e 67 20  6e 65 77 20 74 61 62 6c  |.Adding new tabl|
00001910  65 73 20 6f 66 20 63 6f  6d 6d 61 6e 64 73 09 09  |es of commands..|
00001920  09 09 2a 0a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |..*.************|
00001930  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 2a 2a 2a  |****************|
*
00001960  2a 2a 2a 2a 2a 2a 2a 2a  2a 2a 2a 2a 2a 0a 0a 55  |*************..U|
00001970  6e 66 6f 72 74 75 6e 61  74 65 6c 79 20 79 6f 75  |nfortunately you|
00001980  20 77 69 6c 6c 20 6e 6f  74 20 62 65 20 61 62 6c  | will not be abl|
00001990  65 20 74 6f 20 61 64 64  20 6e 65 77 20 63 6f 6d  |e to add new com|
000019a0  6d 61 6e 64 73 20 75 6e  74 69 6c 20 76 65 72 73  |mands until vers|
000019b0  69 6f 6e 20 31 2e 30 30  2e 0a 54 68 69 73 20 69  |ion 1.00..This i|
000019c0  73 20 62 65 63 61 75 73  65 20 49 20 61 6d 20 72  |s because I am r|
000019d0  65 77 72 69 74 69 6e 67  20 74 68 65 20 69 6e 74  |ewriting the int|
000019e0  65 72 6e 61 6c 20 63 6f  6d 6d 61 6e 64 20 73 74  |ernal command st|
000019f0  72 75 63 74 75 72 65 20  74 6f 20 62 65 20 6d 6f  |ructure to be mo|
00001a00  72 65 0a 66 6c 65 78 69  62 6c 65 20 28 73 65 65  |re.flexible (see|
00001a10  20 27 43 68 61 6e 67 65  73 27 20 66 69 6c 65 29  | 'Changes' file)|
00001a20  2e 20 53 6f 72 72 79 21  0a                       |. Sorry!.|
00001a29

© Dominic Ford 2021–2025.

Our privacy policy is here.
Last updated: 01 May 2025, 21:49 UTC
Website designed by .