Home » Archimedes archive » Archimedes World » AW-1994-06-Disc2.adf » Disk2Jun94 » !AWJune94/Goodies/Zap/!Zap/3rdParty/ZapMJEHelp
!AWJune94/Goodies/Zap/!Zap/3rdParty/ZapMJEHelp
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 » Archimedes World » AW-1994-06-Disc2.adf » Disk2Jun94 |
| Filename: | !AWJune94/Goodies/Zap/!Zap/3rdParty/ZapMJEHelp |
| Read OK: | ✔ |
| File size: | 48B4 bytes |
| Load address: | 0000 |
| Exec address: | 0000 |
File contents
ZapMJE 0.51 help file
� Martin Ebourne, 1994
-=-=-=-=-=-=-=-
This software is COPYRIGHT, but has been released as FREEWARE. Please see the
end of this file for conditions of use and distribution.
-=-=-=-=-=-=-=-
Introduction
============
ZapMJE provides several new modes and various other extensions for the Zap
text editor. In brief, these are:
� C, Acorn Assembler and Pascal source editing modes
� Colour, compilation, indenting, bracket matching, function browsers,
next/last function, swap to header, strip spaces at end of lines on save,
improved shift-left and right arrow (previous and next word), tab type
mode specific, and various commenting features for the new modes
(not all features in all modes)
� Support for using StrongHelp directly
� A command to enable keys to have different bindings for different modes
� A command to alter the current selection (the same as Edit's F6)
Mode specific features
==== ======== ========
Colour
------
This is currently available in the C and assembler modes. Pascal will be
implemented one day (when someone has told me or I have figured out the
precise syntax). For C, the colours are as follows:
Foreground : Used for anything which doesn't classify below
Comments : Anything in /* */
Strings : Strings, character constants and include filenames
(ie. anything in "", '' or, after a #include, <>)
Instructions: Reserved words (eg. switch, void)
Preprocessor: Anything on preprocessor lines not under any other category
(including preprocessor keywords such as #define)
Functions : Function name in definitions, calls and macros. Not however,
when used as a pointer
Variables : Any other user defined word, including parameter-less macros
Numbers : Things like 6.5!
The assembler colours are:
Foreground : Used for anything which doesn't classify below
Comments : Anything after ;
Strings : Strings and character constants (ie. anything in "" or '')
Instructions: Anything in the instruction field (first section of line
following whitespace), plus anything else which is part of
the instruction (eg. {, }, !). Also instruction shifts
(eg. ASL)
Operators : Assembler expression operators (eg. :SHL:)
Labels : Anything in the label field (text at very start of line)
Names : Any user defined words in the parameters of an instruction
Numbers : Things like 2_1101
Colouring is automatic, and if you want to switch it off you will have to set
all the foreground colours the same. A problem you are bound to have is
finding enough usable colours to display. In C they are best as all
different (in assembler some of them are very closely related and hence are
best coloured the same), but unfortunately there are only 5 usable colours in
the normal Wimp palette. Hence the defaults include some grey ones. I
recommend you re-define the colours in the palette to make them usable if you
intend to use it seriously.
Compilation
-----------
This is very powerful and is designed to cater for every situation. The way
it operates is as follows (in order):
1. Look for sourcefile.^.^.MakeFile (standard name and location for a
makefile)
2. If it is type Text (FFF) or Makefile (FE1) then pass it round as a message
Data Open for either Make or AMU to pick up on. Note that it is passed round
as type FE1 regardless of whether it is Text or not. This is because a lot of
makefiles are typed to Text, and Make and AMU will not pick these up (but Zap
will!). Also note that for AMU to intercept this message, it needs a
'filetype &FE1;' line inserted into the top section of the description file.
3. If no task claims the message then amu is invoked from the command line in
a task window. The default amu options used are '-desktop -k'. The taskwindow
options used are '-display -quit'.
4. If sourcefile.^.^.MakeFile file is not of type Text or Makefile, then it
is run using Wimp_StartTask. This allows for obey files and the like to be
used, giving absolute flexibility.
5. If sourcefile.^.^.MakeFile file does not exist, then the source file is
compiled/assembled direct. It cannot be passed round as a Wimp message
because it is text, and so cannot be claimed by CC or whatever. Thus it is
compiled/assembled in a task window along the same lines as amu if invoked
above. The options used depend on the mode and are as follows:
C - '-IC: -throwback -LC:o.RISC_OSlib,C:o.stubs -Desktop ^'
Asm - Assembly does not work at the moment. Makefiles are still ok
though
Pascal - '-ranprv -LC:o.Stubs -throwback -desktop ^'
6. There is one last feature to ensure 100% flexibility. If the characters
'/*+�', ';+�' or '(*+�' (depending on mode) are found within the first 1k of
the source file when invoking amu or compilation/assembly directly in a task
window, then the following characters until the next close comment or end
of line are used INSTEAD of the default options string. This means that if
you don't like the default options, you can supply your own. (For instance,
if you include extra libraries or want debug code generated.)
Note that the maximum length for the command issued is 256 characters,
including the filename, commands and the various options. Also, NO
translation is carried out in copying the options. However, when calling
*TaskWindow, the command is placed in quotes - so if any were required in the
options string they would have to be doubled up originally.
There are two commands to invoke compilation; COMPILE which saves and then
compiles (assuming the save was ok), and RUN which compiles without saving
the current file. (These correspond to the equivalent BASIC commands.)
Indenting
---------
This is currently only present in the C mode, and simply puts the requested
number of extra spaces onto the indent for the line following a {, and
aligns }s up with the corresponding {. The indent is set via the C mode
menu, and should have the value 0 to disable the feature.
Bracket matching
------- --------
Currently only the 'as you type' matching is implemented and then only in the
C mode. When you type a close bracket (either ), } or ]) the cursor will jump
to the corresponding open bracket for the time specified in the pause entry
in the C mode menu (in centiseconds). The pause will be truncated if you
carry on typing. To disable it, set the pause to 0 centiseconds.
Function browsers
-------- --------
This feature works on all three modes, and simply provides a browser of all
the function definitions in the source file. C mode correctly copes with old
and new style function definitions, as well as contrived statements such as:
#ifdef __STDC__
int wibble(int wobble)
#else
int wibble(wobble)
int wobble;
#endif
{
...
which are designed to work under both pcc and ANSI compilers. Assembler mode
simply lists all the lines on which labels are defined. This feature is
invoked with the standard command LISTFNS.
Next/last function
---- ---- --------
These work in the same way as the function browser, but place the cursor at
the definition of the next or previous function in the source file. They are
invoked with MJE_NEXTFUNC and MJE_LASTFUNC respectively.
Swap to header
---- -- ------
This moves the input focus onto the corresponding header/source file (ie.
with the same leafname) for the current source/header file (assuming one
exists). It also loads the file if necessary. The corresponding header file
is of the form sourcefile.^.^.h.sourcefile, and the corresponding sourcefile
is of the form headerfile.^.^.x.headerfile where x is c, s or p depending on
mode. This feature is invoked with MJE_SWAPTOHEADER.
Excess space removal
------ ----- -------
This automatically occurs on saving the file, and simply removes any excess
whitespace on the ends of lines. These serve no purpose other than to waste
memory and slow things down, and since they are easily generated with the
auto-indentation, it needs some way of easy removal. This is present only as
a stop-gap until Zap supports it properly.
Previous and next word
-------- --- ---- ----
The previous and next word commands (shift-left & shift-right) of Zap are
intended for use when text editing, and as such only stop after whitespace or
parentheses. This is fine for text, but totally unsuitable for program
editing unless you are liberal with your spaces (I'm not). For instance,
previous/next word would jump right over 'whatever=this+that/something_else;'
which is not very useful. For that reason all three of the extra modes have a
much more powerful implementation as standard. It can be thought of as
working like this:
There are 5 categories of character, classified in descending order as:
5: Newline character
4: Letters and numbers
3: Anything else non-whitespace (ie. symbols)
2: Whitespace (space and tab)
1: Newline character
When you press shift-left or shift-right, the cursor will be moved in that
direction until the classification of the next character (in the direction it
is moving) is greater than that of the current character, upon which it will
stop. Newline appears twice in order to ensure that the cursor will always
stop on each side of it. (ie. at start & end of line).
This probably sounds quite complicated, but it is in actual fact very easy,
and very intuitive to use. As an example, these are the points that the
cursor would stop at:
Line: if((char2=getchar())!=0 && char2!=line_terminator)
Fwd : ^ ^ ^ ^ ^ ^ ^ ^ ^
Back:^ ^ ^ ^ ^ ^ ^ ^ ^
Tab type mode specific
--- ---- ---- --------
A problem with Zap which should be fixed soon is that not enough options are
mode specific. eg. tab type. This is bound to be different for different
modes (eg. column/Unix tab in assembler, Edit tab in C), so these modes
support it as mode specific. Normally this will be fine, but you may notice
that if you switch from text to one of these modes and back to text, the tab
type will have changed. This is because text does not have a setting for it.
Various commenting features
------- ---------- --------
These all work in all three modes and are:
MJE_OPENCOMMENT
This inserts the appropriate open comment text (ie. '/*�', ';�' or '(*�').
MJE_CLOSECOMMENT
Inserts appropriate close comment ('�*/' or '�*)' [none for assembler]).
MJE_IF
Inserts 'pre-processor comment'. ie. uses conditional compilation/assembly
to effectively comment out the stuff ahead.. (Handy if there are comments
around, since you can't nest them in C). Inserts '#if�0\n' or '�[ 1<>0\n'
depending on mode.
MJE_ENDIF
Finishes 'pre-processor comment'. (ie. inserts '#endif\n' or '�]\n'.)
MJE_COMMENTLINE
Comments out line and moves onto next. (ie. inserts '/*�' & '�*/', ';�', or
'(*�' & '�*)' at start and end of line.)
MJE_UNCOMMENTLINE
Reverses above. (ie. removes '/*�' & '�*/', ';�' or '(*�' & '�*)' if
present and moves onto next line)
Non-standard option
--- -------- ------
This will not be very useful to many people, except if they lay their
assembler source out the same way as I do. Basically, if enabled then on
pressing tab you will be advanced to the next 'source column' rather than tab
stop. It only works sensibly with Unix or column tab, and the 'source
columns' are laid out as follows (using Unix tab):
Label ->------->Ins --->Operands ------>------->------->Comment
(ie. 2, 1 and 4 tab stops)
If your source looks like that, then try it, you might like it. If it doesn't
then don't switch it on and no harm done. The only reason it is in there is
because it is easier than disabling it for release. Also, Dominic wanted me
to use the non-standard option in order to justify its existance. I bet he'll
remove it now just to spite me. ;-) This feature is probably only a stop-gap
until Zap supports variable tab stops properly.
Help commands
==== ========
These work in all modes (except tokenised BASIC at the moment).
Together, they provide a more comprehensive interface to StrongHelp than
StrongEd does. :-)
Context sensitive
------- ---------
This provides help on whatever is by the cursor. Currently it only works if
the cursor is on text of some description, but it is subject to improvement
when I have time. It is invoked with the command
MJE_HELPCONTEXT.
Previous
--------
This doesn't work at the moment, though it will do one day. MJE_HELPLAST is
the command, and it will re-produce the last x previous help screens going
back up a stack. (This is more for the native system.)
Topic/keyword
----- -------
This has 3 modes of operation:
The command MJE_HELPTOPIC "text" will look for help on the keyword text. This
is handy to have keys for a main menu, etc.
The command MJE_HELPTOPIC with no parameter will search for help on whatever
is selected, assuming it is in the current window and not too long. (This
allows help on words with symbols in, which MJE_HELPCONTEXT would discard as
irrelevant.)
If it still hasn't worked out what to search for, a minibuffer will be opened
for you to type in the appropriate topic.
General features
======= ========
MJE_IFMODE
----------
This enables you to use keys for different functions in different modes, or
more normally, provide the same function in several modes where one or more
of them doesn't check the mode before performing the function. eg. A mapping
for next function could be:
MJE_NEXTFUNC:MJE_IFMODE "7:C_NEXT_FUNCTION"
This is needed because the C_NEXT_FUNCTION command executes regardless of
mode and would thus mess things up in any of the other modes.
The syntax is:
MJE_IFMODE "Modelist:Commands"
Modelist is a comma separated list of mode numbers for which the commands are
to execute in. You can also use a hyphen for ranges. eg. "1,3-5,7:..." No
other characters, not even spaces are allowed before the colon, apart from
the option of a ! immediately before it. This has the effect of negating
the condition. eg. "0,2,6,8-255!:" is the same as the previous example.
Commands is a list of commands in the normal way.
MJE_ALTERSEL
------------
This works in the same way as Edit's F6. If there is no selection, the
character after the cursor is selected, else the operation is equivalent to
clicking adjust with the mouse. This is very handy if you select something
with the keyboard but get it slightly wrong - it saves you re-selecting the
whole lot. Another essential use is to select a line/several lines with the
following command sequence:
CLEFT:MJE_ALTERSEL:CRIGHT:DOWN:CLEFT:MJE_ALTERSEL
Copyright
=========
The conditions of copying this program and its associated documentation are
the same as those of the main Zap application, except you do not need my
permision to copy it if you have Dominic's.
This software is provided as is with no warranty as to its suitability or
otherwise for any particular task. If it does anything nasty then I want to
know so I can fix it, but I'm not taking any responsibility. (Besides,
there's no point in sueing me since I've got no money.)
Non-release versions of this module (identify themselves as test versions on
*Help ZapMJE) are *NOT* distributable without my express permission. They are
also more likely to fall over. ;-)
Please note that I reserve the right to make alterations to this program, its
operation, documentation, and/or conditions of use without notice in any way
I see fit. Hopefully it will be an improvement.
Acknowledgements
================
Thanks to Dominic for writing Zap and not even charging for it! (Though he's
partly responsible for a rather large amount of damage to my 'phone bill.
:-()
Thanks to Brian Scattergood for writing his Cmode which this originally came
from - it made initial development a lot easier (although I did have to hack
it first :-]). There's even some original (slightly modified) code left!
(Most of the stuff which is C mode only.) This will have to be replaced in
the course of making it work on all modes sooner or later. :-(
Thanks to Mercury for not charging quite as much as BT. (It means I'm just
broke rather than completely bankrupt. :-] Correction: It means it took me
very slightly longer to become completely bankrupt.)
Contacting
==========
I can be contacted through email to mje@soton.ac.uk all year round (faster
response time during term). Alternatively, snail to:
1 Malvern Road
Acocks Green
Birmingham
B27 6EG
Please let me know of any bugs or undocumented features if you ever find any
(and they aren't listed at the end of the file - that's the hard bit!). Also,
ideas for improvement are welcome. A few of my current ideas are:
� A key to generate header files from source
� A really cool native help system of which the details are secret at the
moment... ;-) If you've got any ideas for it however, then now's the time
to let me have them
� A pretty nifty selection mechanism for C & Pascal (possibly even
assembler)
� Colour redraw for Pascal
� Bracket matching correctly on all modes
� Remove any features which aren't listed in this help file
If anybody wants to help me pay off some of the 'phone bill this module has
incurred, then all donations are gratefully accepted at the address above.
(Well you can't blame me for trying, can you!)
Known mis-features
===== === ========
(These are just the important ones :-()
Assembler:
� Assembling with no make file doesn't work
� Function finding cheats (uses search)
C:
� The syntax colouring is slow with large files and multiple views of the
same file, but then when constructs such as:
#inc\
lude /* *\
/ <std\
io.h>
are valid (try it, it works!), its hardly surprising. However, this will
be improved in later versions.
� Problems with function finding:
1) Preprocessor # not at start of line not recognised
2) foo () isn't found
3) It doesn't cope with \ outside of preprocessor
These 'bugs' are due to me not knowing precisely how the C syntax worked
when I wrote it. Unfortunately, the deadline has been very tight & it's
been close to get the colouring work, let alone the function finding
� There are problems with the colouring on constructs such as:
1) _kernel_oserror (foo) ();
2) wibble
#define wobble
(void)
Pascal:
� Function finding cheats (like assembler)
Miscellaneous:
� This is Zap's fault, but swap to header doesn't load file into correct
mode 00000000 5a 61 70 4d 4a 45 20 30 2e 35 31 20 68 65 6c 70 |ZapMJE 0.51 help|
00000010 20 66 69 6c 65 0a a9 20 4d 61 72 74 69 6e 20 45 | file.. Martin E|
00000020 62 6f 75 72 6e 65 2c 20 31 39 39 34 0a 0a 20 20 |bourne, 1994.. |
00000030 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
00000040 20 20 20 20 20 20 20 20 20 20 20 20 2d 3d 2d 3d | -=-=|
00000050 2d 3d 2d 3d 2d 3d 2d 3d 2d 3d 2d 0a 54 68 69 73 |-=-=-=-=-=-.This|
00000060 20 73 6f 66 74 77 61 72 65 20 69 73 20 43 4f 50 | software is COP|
00000070 59 52 49 47 48 54 2c 20 62 75 74 20 68 61 73 20 |YRIGHT, but has |
00000080 62 65 65 6e 20 72 65 6c 65 61 73 65 64 20 61 73 |been released as|
00000090 20 46 52 45 45 57 41 52 45 2e 20 50 6c 65 61 73 | FREEWARE. Pleas|
000000a0 65 20 73 65 65 20 74 68 65 0a 65 6e 64 20 6f 66 |e see the.end of|
000000b0 20 74 68 69 73 20 66 69 6c 65 20 66 6f 72 20 63 | this file for c|
000000c0 6f 6e 64 69 74 69 6f 6e 73 20 6f 66 20 75 73 65 |onditions of use|
000000d0 20 61 6e 64 20 64 69 73 74 72 69 62 75 74 69 6f | and distributio|
000000e0 6e 2e 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 |n.. |
000000f0 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 | |
00000100 20 2d 3d 2d 3d 2d 3d 2d 3d 2d 3d 2d 3d 2d 3d 2d | -=-=-=-=-=-=-=-|
00000110 0a 0a 0a 0a 49 6e 74 72 6f 64 75 63 74 69 6f 6e |....Introduction|
00000120 0a 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 5a |.============..Z|
00000130 61 70 4d 4a 45 20 70 72 6f 76 69 64 65 73 20 73 |apMJE provides s|
00000140 65 76 65 72 61 6c 20 6e 65 77 20 6d 6f 64 65 73 |everal new modes|
00000150 20 61 6e 64 20 76 61 72 69 6f 75 73 20 6f 74 68 | and various oth|
00000160 65 72 20 65 78 74 65 6e 73 69 6f 6e 73 20 66 6f |er extensions fo|
00000170 72 20 74 68 65 20 5a 61 70 0a 74 65 78 74 20 65 |r the Zap.text e|
00000180 64 69 74 6f 72 2e 20 49 6e 20 62 72 69 65 66 2c |ditor. In brief,|
00000190 20 74 68 65 73 65 20 61 72 65 3a 0a 0a 20 20 8f | these are:.. .|
000001a0 20 43 2c 20 41 63 6f 72 6e 20 41 73 73 65 6d 62 | C, Acorn Assemb|
000001b0 6c 65 72 20 61 6e 64 20 50 61 73 63 61 6c 20 73 |ler and Pascal s|
000001c0 6f 75 72 63 65 20 65 64 69 74 69 6e 67 20 6d 6f |ource editing mo|
000001d0 64 65 73 0a 20 20 8f 20 43 6f 6c 6f 75 72 2c 20 |des. . Colour, |
000001e0 63 6f 6d 70 69 6c 61 74 69 6f 6e 2c 20 69 6e 64 |compilation, ind|
000001f0 65 6e 74 69 6e 67 2c 20 62 72 61 63 6b 65 74 20 |enting, bracket |
00000200 6d 61 74 63 68 69 6e 67 2c 20 66 75 6e 63 74 69 |matching, functi|
00000210 6f 6e 20 62 72 6f 77 73 65 72 73 2c 0a 20 20 20 |on browsers,. |
00000220 20 6e 65 78 74 2f 6c 61 73 74 20 66 75 6e 63 74 | next/last funct|
00000230 69 6f 6e 2c 20 73 77 61 70 20 74 6f 20 68 65 61 |ion, swap to hea|
00000240 64 65 72 2c 20 73 74 72 69 70 20 73 70 61 63 65 |der, strip space|
00000250 73 20 61 74 20 65 6e 64 20 6f 66 20 6c 69 6e 65 |s at end of line|
00000260 73 20 6f 6e 20 73 61 76 65 2c 0a 20 20 20 20 69 |s on save,. i|
00000270 6d 70 72 6f 76 65 64 20 73 68 69 66 74 2d 6c 65 |mproved shift-le|
00000280 66 74 20 61 6e 64 20 72 69 67 68 74 20 61 72 72 |ft and right arr|
00000290 6f 77 20 28 70 72 65 76 69 6f 75 73 20 61 6e 64 |ow (previous and|
000002a0 20 6e 65 78 74 20 77 6f 72 64 29 2c 20 74 61 62 | next word), tab|
000002b0 20 74 79 70 65 20 0a 20 20 20 20 6d 6f 64 65 20 | type . mode |
000002c0 73 70 65 63 69 66 69 63 2c 20 61 6e 64 20 76 61 |specific, and va|
000002d0 72 69 6f 75 73 20 63 6f 6d 6d 65 6e 74 69 6e 67 |rious commenting|
000002e0 20 66 65 61 74 75 72 65 73 20 66 6f 72 20 74 68 | features for th|
000002f0 65 20 6e 65 77 20 6d 6f 64 65 73 0a 20 20 20 20 |e new modes. |
00000300 28 6e 6f 74 20 61 6c 6c 20 66 65 61 74 75 72 65 |(not all feature|
00000310 73 20 69 6e 20 61 6c 6c 20 6d 6f 64 65 73 29 0a |s in all modes).|
00000320 20 20 8f 20 53 75 70 70 6f 72 74 20 66 6f 72 20 | . Support for |
00000330 75 73 69 6e 67 20 53 74 72 6f 6e 67 48 65 6c 70 |using StrongHelp|
00000340 20 64 69 72 65 63 74 6c 79 0a 20 20 8f 20 41 20 | directly. . A |
00000350 63 6f 6d 6d 61 6e 64 20 74 6f 20 65 6e 61 62 6c |command to enabl|
00000360 65 20 6b 65 79 73 20 74 6f 20 68 61 76 65 20 64 |e keys to have d|
00000370 69 66 66 65 72 65 6e 74 20 62 69 6e 64 69 6e 67 |ifferent binding|
00000380 73 20 66 6f 72 20 64 69 66 66 65 72 65 6e 74 20 |s for different |
00000390 6d 6f 64 65 73 0a 20 20 8f 20 41 20 63 6f 6d 6d |modes. . A comm|
000003a0 61 6e 64 20 74 6f 20 61 6c 74 65 72 20 74 68 65 |and to alter the|
000003b0 20 63 75 72 72 65 6e 74 20 73 65 6c 65 63 74 69 | current selecti|
000003c0 6f 6e 20 28 74 68 65 20 73 61 6d 65 20 61 73 20 |on (the same as |
000003d0 45 64 69 74 27 73 20 46 36 29 0a 0a 0a 0a 4d 6f |Edit's F6)....Mo|
000003e0 64 65 20 73 70 65 63 69 66 69 63 20 66 65 61 74 |de specific feat|
000003f0 75 72 65 73 0a 3d 3d 3d 3d 20 3d 3d 3d 3d 3d 3d |ures.==== ======|
00000400 3d 3d 20 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 43 6f 6c |== ========..Col|
00000410 6f 75 72 0a 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 |our.------..This|
00000420 20 69 73 20 63 75 72 72 65 6e 74 6c 79 20 61 76 | is currently av|
00000430 61 69 6c 61 62 6c 65 20 69 6e 20 74 68 65 20 43 |ailable in the C|
00000440 20 61 6e 64 20 61 73 73 65 6d 62 6c 65 72 20 6d | and assembler m|
00000450 6f 64 65 73 2e 20 50 61 73 63 61 6c 20 77 69 6c |odes. Pascal wil|
00000460 6c 20 62 65 0a 69 6d 70 6c 65 6d 65 6e 74 65 64 |l be.implemented|
00000470 20 6f 6e 65 20 64 61 79 20 28 77 68 65 6e 20 73 | one day (when s|
00000480 6f 6d 65 6f 6e 65 20 68 61 73 20 74 6f 6c 64 20 |omeone has told |
00000490 6d 65 20 6f 72 20 49 20 68 61 76 65 20 66 69 67 |me or I have fig|
000004a0 75 72 65 64 20 6f 75 74 20 74 68 65 0a 70 72 65 |ured out the.pre|
000004b0 63 69 73 65 20 73 79 6e 74 61 78 29 2e 20 46 6f |cise syntax). Fo|
000004c0 72 20 43 2c 20 74 68 65 20 63 6f 6c 6f 75 72 73 |r C, the colours|
000004d0 20 61 72 65 20 61 73 20 66 6f 6c 6c 6f 77 73 3a | are as follows:|
000004e0 0a 0a 20 20 46 6f 72 65 67 72 6f 75 6e 64 20 20 |.. Foreground |
000004f0 3a 20 55 73 65 64 20 66 6f 72 20 61 6e 79 74 68 |: Used for anyth|
00000500 69 6e 67 20 77 68 69 63 68 20 64 6f 65 73 6e 27 |ing which doesn'|
00000510 74 20 63 6c 61 73 73 69 66 79 20 62 65 6c 6f 77 |t classify below|
00000520 0a 20 20 43 6f 6d 6d 65 6e 74 73 20 20 20 20 3a |. Comments :|
00000530 20 41 6e 79 74 68 69 6e 67 20 69 6e 20 2f 2a 20 | Anything in /* |
00000540 2a 2f 0a 20 20 53 74 72 69 6e 67 73 20 20 20 20 |*/. Strings |
00000550 20 3a 20 53 74 72 69 6e 67 73 2c 20 63 68 61 72 | : Strings, char|
00000560 61 63 74 65 72 20 63 6f 6e 73 74 61 6e 74 73 20 |acter constants |
00000570 61 6e 64 20 69 6e 63 6c 75 64 65 20 66 69 6c 65 |and include file|
00000580 6e 61 6d 65 73 0a 20 20 20 20 20 20 20 20 20 20 |names. |
00000590 20 20 20 20 20 20 28 69 65 2e 20 61 6e 79 74 68 | (ie. anyth|
000005a0 69 6e 67 20 69 6e 20 22 22 2c 20 27 27 20 6f 72 |ing in "", '' or|
000005b0 2c 20 61 66 74 65 72 20 61 20 23 69 6e 63 6c 75 |, after a #inclu|
000005c0 64 65 2c 20 3c 3e 29 0a 20 20 49 6e 73 74 72 75 |de, <>). Instru|
000005d0 63 74 69 6f 6e 73 3a 20 52 65 73 65 72 76 65 64 |ctions: Reserved|
000005e0 20 77 6f 72 64 73 20 28 65 67 2e 20 73 77 69 74 | words (eg. swit|
000005f0 63 68 2c 20 76 6f 69 64 29 0a 20 20 50 72 65 70 |ch, void). Prep|
00000600 72 6f 63 65 73 73 6f 72 3a 20 41 6e 79 74 68 69 |rocessor: Anythi|
00000610 6e 67 20 6f 6e 20 70 72 65 70 72 6f 63 65 73 73 |ng on preprocess|
00000620 6f 72 20 6c 69 6e 65 73 20 6e 6f 74 20 75 6e 64 |or lines not und|
00000630 65 72 20 61 6e 79 20 6f 74 68 65 72 20 63 61 74 |er any other cat|
00000640 65 67 6f 72 79 0a 20 20 20 20 20 20 20 20 20 20 |egory. |
00000650 20 20 20 20 20 20 28 69 6e 63 6c 75 64 69 6e 67 | (including|
00000660 20 70 72 65 70 72 6f 63 65 73 73 6f 72 20 6b 65 | preprocessor ke|
00000670 79 77 6f 72 64 73 20 73 75 63 68 20 61 73 20 23 |ywords such as #|
00000680 64 65 66 69 6e 65 29 0a 20 20 46 75 6e 63 74 69 |define). Functi|
00000690 6f 6e 73 20 20 20 3a 20 46 75 6e 63 74 69 6f 6e |ons : Function|
000006a0 20 6e 61 6d 65 20 69 6e 20 64 65 66 69 6e 69 74 | name in definit|
000006b0 69 6f 6e 73 2c 20 63 61 6c 6c 73 20 61 6e 64 20 |ions, calls and |
000006c0 6d 61 63 72 6f 73 2e 20 4e 6f 74 20 68 6f 77 65 |macros. Not howe|
000006d0 76 65 72 2c 0a 20 20 20 20 20 20 20 20 20 20 20 |ver,. |
000006e0 20 20 20 20 20 77 68 65 6e 20 75 73 65 64 20 61 | when used a|
000006f0 73 20 61 20 70 6f 69 6e 74 65 72 0a 20 20 56 61 |s a pointer. Va|
00000700 72 69 61 62 6c 65 73 20 20 20 3a 20 41 6e 79 20 |riables : Any |
00000710 6f 74 68 65 72 20 75 73 65 72 20 64 65 66 69 6e |other user defin|
00000720 65 64 20 77 6f 72 64 2c 20 69 6e 63 6c 75 64 69 |ed word, includi|
00000730 6e 67 20 70 61 72 61 6d 65 74 65 72 2d 6c 65 73 |ng parameter-les|
00000740 73 20 6d 61 63 72 6f 73 0a 20 20 4e 75 6d 62 65 |s macros. Numbe|
00000750 72 73 20 20 20 20 20 3a 20 54 68 69 6e 67 73 20 |rs : Things |
00000760 6c 69 6b 65 20 36 2e 35 21 0a 0a 54 68 65 20 61 |like 6.5!..The a|
00000770 73 73 65 6d 62 6c 65 72 20 63 6f 6c 6f 75 72 73 |ssembler colours|
00000780 20 61 72 65 3a 0a 0a 20 20 46 6f 72 65 67 72 6f | are:.. Foregro|
00000790 75 6e 64 20 20 3a 20 55 73 65 64 20 66 6f 72 20 |und : Used for |
000007a0 61 6e 79 74 68 69 6e 67 20 77 68 69 63 68 20 64 |anything which d|
000007b0 6f 65 73 6e 27 74 20 63 6c 61 73 73 69 66 79 20 |oesn't classify |
000007c0 62 65 6c 6f 77 0a 20 20 43 6f 6d 6d 65 6e 74 73 |below. Comments|
000007d0 20 20 20 20 3a 20 41 6e 79 74 68 69 6e 67 20 61 | : Anything a|
000007e0 66 74 65 72 20 3b 0a 20 20 53 74 72 69 6e 67 73 |fter ;. Strings|
000007f0 20 20 20 20 20 3a 20 53 74 72 69 6e 67 73 20 61 | : Strings a|
00000800 6e 64 20 63 68 61 72 61 63 74 65 72 20 63 6f 6e |nd character con|
00000810 73 74 61 6e 74 73 20 28 69 65 2e 20 61 6e 79 74 |stants (ie. anyt|
00000820 68 69 6e 67 20 69 6e 20 22 22 20 6f 72 20 27 27 |hing in "" or ''|
00000830 29 0a 20 20 49 6e 73 74 72 75 63 74 69 6f 6e 73 |). Instructions|
00000840 3a 20 41 6e 79 74 68 69 6e 67 20 69 6e 20 74 68 |: Anything in th|
00000850 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 20 66 69 |e instruction fi|
00000860 65 6c 64 20 28 66 69 72 73 74 20 73 65 63 74 69 |eld (first secti|
00000870 6f 6e 20 6f 66 20 6c 69 6e 65 0a 20 20 20 20 20 |on of line. |
00000880 20 20 20 20 20 20 20 20 20 20 20 66 6f 6c 6c 6f | follo|
00000890 77 69 6e 67 20 77 68 69 74 65 73 70 61 63 65 29 |wing whitespace)|
000008a0 2c 20 70 6c 75 73 20 61 6e 79 74 68 69 6e 67 20 |, plus anything |
000008b0 65 6c 73 65 20 77 68 69 63 68 20 69 73 20 70 61 |else which is pa|
000008c0 72 74 20 6f 66 0a 20 20 20 20 20 20 20 20 20 20 |rt of. |
000008d0 20 20 20 20 20 20 74 68 65 20 69 6e 73 74 72 75 | the instru|
000008e0 63 74 69 6f 6e 20 28 65 67 2e 20 7b 2c 20 7d 2c |ction (eg. {, },|
000008f0 20 21 29 2e 20 41 6c 73 6f 20 69 6e 73 74 72 75 | !). Also instru|
00000900 63 74 69 6f 6e 20 73 68 69 66 74 73 0a 20 20 20 |ction shifts. |
00000910 20 20 20 20 20 20 20 20 20 20 20 20 20 28 65 67 | (eg|
00000920 2e 20 41 53 4c 29 0a 20 20 4f 70 65 72 61 74 6f |. ASL). Operato|
00000930 72 73 20 20 20 3a 20 41 73 73 65 6d 62 6c 65 72 |rs : Assembler|
00000940 20 65 78 70 72 65 73 73 69 6f 6e 20 6f 70 65 72 | expression oper|
00000950 61 74 6f 72 73 20 28 65 67 2e 20 3a 53 48 4c 3a |ators (eg. :SHL:|
00000960 29 0a 20 20 4c 61 62 65 6c 73 20 20 20 20 20 20 |). Labels |
00000970 3a 20 41 6e 79 74 68 69 6e 67 20 69 6e 20 74 68 |: Anything in th|
00000980 65 20 6c 61 62 65 6c 20 66 69 65 6c 64 20 28 74 |e label field (t|
00000990 65 78 74 20 61 74 20 76 65 72 79 20 73 74 61 72 |ext at very star|
000009a0 74 20 6f 66 20 6c 69 6e 65 29 0a 20 20 4e 61 6d |t of line). Nam|
000009b0 65 73 20 20 20 20 20 20 20 3a 20 41 6e 79 20 75 |es : Any u|
000009c0 73 65 72 20 64 65 66 69 6e 65 64 20 77 6f 72 64 |ser defined word|
000009d0 73 20 69 6e 20 74 68 65 20 70 61 72 61 6d 65 74 |s in the paramet|
000009e0 65 72 73 20 6f 66 20 61 6e 20 69 6e 73 74 72 75 |ers of an instru|
000009f0 63 74 69 6f 6e 0a 20 20 4e 75 6d 62 65 72 73 20 |ction. Numbers |
00000a00 20 20 20 20 3a 20 54 68 69 6e 67 73 20 6c 69 6b | : Things lik|
00000a10 65 20 32 5f 31 31 30 31 0a 0a 43 6f 6c 6f 75 72 |e 2_1101..Colour|
00000a20 69 6e 67 20 69 73 20 61 75 74 6f 6d 61 74 69 63 |ing is automatic|
00000a30 2c 20 61 6e 64 20 69 66 20 79 6f 75 20 77 61 6e |, and if you wan|
00000a40 74 20 74 6f 20 73 77 69 74 63 68 20 69 74 20 6f |t to switch it o|
00000a50 66 66 20 79 6f 75 20 77 69 6c 6c 20 68 61 76 65 |ff you will have|
00000a60 20 74 6f 20 73 65 74 0a 61 6c 6c 20 74 68 65 20 | to set.all the |
00000a70 66 6f 72 65 67 72 6f 75 6e 64 20 63 6f 6c 6f 75 |foreground colou|
00000a80 72 73 20 74 68 65 20 73 61 6d 65 2e 20 41 20 70 |rs the same. A p|
00000a90 72 6f 62 6c 65 6d 20 79 6f 75 20 61 72 65 20 62 |roblem you are b|
00000aa0 6f 75 6e 64 20 74 6f 20 68 61 76 65 20 69 73 0a |ound to have is.|
00000ab0 66 69 6e 64 69 6e 67 20 65 6e 6f 75 67 68 20 75 |finding enough u|
00000ac0 73 61 62 6c 65 20 63 6f 6c 6f 75 72 73 20 74 6f |sable colours to|
00000ad0 20 64 69 73 70 6c 61 79 2e 20 49 6e 20 43 20 74 | display. In C t|
00000ae0 68 65 79 20 61 72 65 20 62 65 73 74 20 61 73 20 |hey are best as |
00000af0 61 6c 6c 0a 64 69 66 66 65 72 65 6e 74 20 28 69 |all.different (i|
00000b00 6e 20 61 73 73 65 6d 62 6c 65 72 20 73 6f 6d 65 |n assembler some|
00000b10 20 6f 66 20 74 68 65 6d 20 61 72 65 20 76 65 72 | of them are ver|
00000b20 79 20 63 6c 6f 73 65 6c 79 20 72 65 6c 61 74 65 |y closely relate|
00000b30 64 20 61 6e 64 20 68 65 6e 63 65 20 61 72 65 0a |d and hence are.|
00000b40 62 65 73 74 20 63 6f 6c 6f 75 72 65 64 20 74 68 |best coloured th|
00000b50 65 20 73 61 6d 65 29 2c 20 62 75 74 20 75 6e 66 |e same), but unf|
00000b60 6f 72 74 75 6e 61 74 65 6c 79 20 74 68 65 72 65 |ortunately there|
00000b70 20 61 72 65 20 6f 6e 6c 79 20 35 20 75 73 61 62 | are only 5 usab|
00000b80 6c 65 20 63 6f 6c 6f 75 72 73 20 69 6e 0a 74 68 |le colours in.th|
00000b90 65 20 6e 6f 72 6d 61 6c 20 57 69 6d 70 20 70 61 |e normal Wimp pa|
00000ba0 6c 65 74 74 65 2e 20 48 65 6e 63 65 20 74 68 65 |lette. Hence the|
00000bb0 20 64 65 66 61 75 6c 74 73 20 69 6e 63 6c 75 64 | defaults includ|
00000bc0 65 20 73 6f 6d 65 20 67 72 65 79 20 6f 6e 65 73 |e some grey ones|
00000bd0 2e 20 49 0a 72 65 63 6f 6d 6d 65 6e 64 20 79 6f |. I.recommend yo|
00000be0 75 20 72 65 2d 64 65 66 69 6e 65 20 74 68 65 20 |u re-define the |
00000bf0 63 6f 6c 6f 75 72 73 20 69 6e 20 74 68 65 20 70 |colours in the p|
00000c00 61 6c 65 74 74 65 20 74 6f 20 6d 61 6b 65 20 74 |alette to make t|
00000c10 68 65 6d 20 75 73 61 62 6c 65 20 69 66 20 79 6f |hem usable if yo|
00000c20 75 0a 69 6e 74 65 6e 64 20 74 6f 20 75 73 65 20 |u.intend to use |
00000c30 69 74 20 73 65 72 69 6f 75 73 6c 79 2e 0a 0a 0a |it seriously....|
00000c40 43 6f 6d 70 69 6c 61 74 69 6f 6e 0a 2d 2d 2d 2d |Compilation.----|
00000c50 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 69 73 |-------..This is|
00000c60 20 76 65 72 79 20 70 6f 77 65 72 66 75 6c 20 61 | very powerful a|
00000c70 6e 64 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 |nd is designed t|
00000c80 6f 20 63 61 74 65 72 20 66 6f 72 20 65 76 65 72 |o cater for ever|
00000c90 79 20 73 69 74 75 61 74 69 6f 6e 2e 20 54 68 65 |y situation. The|
00000ca0 20 77 61 79 0a 69 74 20 6f 70 65 72 61 74 65 73 | way.it operates|
00000cb0 20 69 73 20 61 73 20 66 6f 6c 6c 6f 77 73 20 28 | is as follows (|
00000cc0 69 6e 20 6f 72 64 65 72 29 3a 0a 0a 31 2e 20 4c |in order):..1. L|
00000cd0 6f 6f 6b 20 66 6f 72 20 73 6f 75 72 63 65 66 69 |ook for sourcefi|
00000ce0 6c 65 2e 5e 2e 5e 2e 4d 61 6b 65 46 69 6c 65 20 |le.^.^.MakeFile |
00000cf0 28 73 74 61 6e 64 61 72 64 20 6e 61 6d 65 20 61 |(standard name a|
00000d00 6e 64 20 6c 6f 63 61 74 69 6f 6e 20 66 6f 72 20 |nd location for |
00000d10 61 0a 6d 61 6b 65 66 69 6c 65 29 0a 0a 32 2e 20 |a.makefile)..2. |
00000d20 49 66 20 69 74 20 69 73 20 74 79 70 65 20 54 65 |If it is type Te|
00000d30 78 74 20 28 46 46 46 29 20 6f 72 20 4d 61 6b 65 |xt (FFF) or Make|
00000d40 66 69 6c 65 20 28 46 45 31 29 20 74 68 65 6e 20 |file (FE1) then |
00000d50 70 61 73 73 20 69 74 20 72 6f 75 6e 64 20 61 73 |pass it round as|
00000d60 20 61 20 6d 65 73 73 61 67 65 0a 44 61 74 61 20 | a message.Data |
00000d70 4f 70 65 6e 20 66 6f 72 20 65 69 74 68 65 72 20 |Open for either |
00000d80 4d 61 6b 65 20 6f 72 20 41 4d 55 20 74 6f 20 70 |Make or AMU to p|
00000d90 69 63 6b 20 75 70 20 6f 6e 2e 20 4e 6f 74 65 20 |ick up on. Note |
00000da0 74 68 61 74 20 69 74 20 69 73 20 70 61 73 73 65 |that it is passe|
00000db0 64 20 72 6f 75 6e 64 0a 61 73 20 74 79 70 65 20 |d round.as type |
00000dc0 46 45 31 20 72 65 67 61 72 64 6c 65 73 73 20 6f |FE1 regardless o|
00000dd0 66 20 77 68 65 74 68 65 72 20 69 74 20 69 73 20 |f whether it is |
00000de0 54 65 78 74 20 6f 72 20 6e 6f 74 2e 20 54 68 69 |Text or not. Thi|
00000df0 73 20 69 73 20 62 65 63 61 75 73 65 20 61 20 6c |s is because a l|
00000e00 6f 74 20 6f 66 0a 6d 61 6b 65 66 69 6c 65 73 20 |ot of.makefiles |
00000e10 61 72 65 20 74 79 70 65 64 20 74 6f 20 54 65 78 |are typed to Tex|
00000e20 74 2c 20 61 6e 64 20 4d 61 6b 65 20 61 6e 64 20 |t, and Make and |
00000e30 41 4d 55 20 77 69 6c 6c 20 6e 6f 74 20 70 69 63 |AMU will not pic|
00000e40 6b 20 74 68 65 73 65 20 75 70 20 28 62 75 74 20 |k these up (but |
00000e50 5a 61 70 0a 77 69 6c 6c 21 29 2e 20 41 6c 73 6f |Zap.will!). Also|
00000e60 20 6e 6f 74 65 20 74 68 61 74 20 66 6f 72 20 41 | note that for A|
00000e70 4d 55 20 74 6f 20 69 6e 74 65 72 63 65 70 74 20 |MU to intercept |
00000e80 74 68 69 73 20 6d 65 73 73 61 67 65 2c 20 69 74 |this message, it|
00000e90 20 6e 65 65 64 73 20 61 0a 27 66 69 6c 65 74 79 | needs a.'filety|
00000ea0 70 65 20 26 46 45 31 3b 27 20 6c 69 6e 65 20 69 |pe &FE1;' line i|
00000eb0 6e 73 65 72 74 65 64 20 69 6e 74 6f 20 74 68 65 |nserted into the|
00000ec0 20 74 6f 70 20 73 65 63 74 69 6f 6e 20 6f 66 20 | top section of |
00000ed0 74 68 65 20 64 65 73 63 72 69 70 74 69 6f 6e 20 |the description |
00000ee0 66 69 6c 65 2e 0a 0a 33 2e 20 49 66 20 6e 6f 20 |file...3. If no |
00000ef0 74 61 73 6b 20 63 6c 61 69 6d 73 20 74 68 65 20 |task claims the |
00000f00 6d 65 73 73 61 67 65 20 74 68 65 6e 20 61 6d 75 |message then amu|
00000f10 20 69 73 20 69 6e 76 6f 6b 65 64 20 66 72 6f 6d | is invoked from|
00000f20 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c 69 6e | the command lin|
00000f30 65 20 69 6e 0a 61 20 74 61 73 6b 20 77 69 6e 64 |e in.a task wind|
00000f40 6f 77 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20 |ow. The default |
00000f50 61 6d 75 20 6f 70 74 69 6f 6e 73 20 75 73 65 64 |amu options used|
00000f60 20 61 72 65 20 27 2d 64 65 73 6b 74 6f 70 20 2d | are '-desktop -|
00000f70 6b 27 2e 20 54 68 65 20 74 61 73 6b 77 69 6e 64 |k'. The taskwind|
00000f80 6f 77 0a 6f 70 74 69 6f 6e 73 20 75 73 65 64 20 |ow.options used |
00000f90 61 72 65 20 27 2d 64 69 73 70 6c 61 79 20 2d 71 |are '-display -q|
00000fa0 75 69 74 27 2e 0a 0a 34 2e 20 49 66 20 73 6f 75 |uit'...4. If sou|
00000fb0 72 63 65 66 69 6c 65 2e 5e 2e 5e 2e 4d 61 6b 65 |rcefile.^.^.Make|
00000fc0 46 69 6c 65 20 66 69 6c 65 20 69 73 20 6e 6f 74 |File file is not|
00000fd0 20 6f 66 20 74 79 70 65 20 54 65 78 74 20 6f 72 | of type Text or|
00000fe0 20 4d 61 6b 65 66 69 6c 65 2c 20 74 68 65 6e 20 | Makefile, then |
00000ff0 69 74 0a 69 73 20 72 75 6e 20 75 73 69 6e 67 20 |it.is run using |
00001000 57 69 6d 70 5f 53 74 61 72 74 54 61 73 6b 2e 20 |Wimp_StartTask. |
00001010 54 68 69 73 20 61 6c 6c 6f 77 73 20 66 6f 72 20 |This allows for |
00001020 6f 62 65 79 20 66 69 6c 65 73 20 61 6e 64 20 74 |obey files and t|
00001030 68 65 20 6c 69 6b 65 20 74 6f 20 62 65 0a 75 73 |he like to be.us|
00001040 65 64 2c 20 67 69 76 69 6e 67 20 61 62 73 6f 6c |ed, giving absol|
00001050 75 74 65 20 66 6c 65 78 69 62 69 6c 69 74 79 2e |ute flexibility.|
00001060 0a 0a 35 2e 20 49 66 20 73 6f 75 72 63 65 66 69 |..5. If sourcefi|
00001070 6c 65 2e 5e 2e 5e 2e 4d 61 6b 65 46 69 6c 65 20 |le.^.^.MakeFile |
00001080 66 69 6c 65 20 64 6f 65 73 20 6e 6f 74 20 65 78 |file does not ex|
00001090 69 73 74 2c 20 74 68 65 6e 20 74 68 65 20 73 6f |ist, then the so|
000010a0 75 72 63 65 20 66 69 6c 65 20 69 73 0a 63 6f 6d |urce file is.com|
000010b0 70 69 6c 65 64 2f 61 73 73 65 6d 62 6c 65 64 20 |piled/assembled |
000010c0 64 69 72 65 63 74 2e 20 49 74 20 63 61 6e 6e 6f |direct. It canno|
000010d0 74 20 62 65 20 70 61 73 73 65 64 20 72 6f 75 6e |t be passed roun|
000010e0 64 20 61 73 20 61 20 57 69 6d 70 20 6d 65 73 73 |d as a Wimp mess|
000010f0 61 67 65 0a 62 65 63 61 75 73 65 20 69 74 20 69 |age.because it i|
00001100 73 20 74 65 78 74 2c 20 61 6e 64 20 73 6f 20 63 |s text, and so c|
00001110 61 6e 6e 6f 74 20 62 65 20 63 6c 61 69 6d 65 64 |annot be claimed|
00001120 20 62 79 20 43 43 20 6f 72 20 77 68 61 74 65 76 | by CC or whatev|
00001130 65 72 2e 20 54 68 75 73 20 69 74 20 69 73 0a 63 |er. Thus it is.c|
00001140 6f 6d 70 69 6c 65 64 2f 61 73 73 65 6d 62 6c 65 |ompiled/assemble|
00001150 64 20 69 6e 20 61 20 74 61 73 6b 20 77 69 6e 64 |d in a task wind|
00001160 6f 77 20 61 6c 6f 6e 67 20 74 68 65 20 73 61 6d |ow along the sam|
00001170 65 20 6c 69 6e 65 73 20 61 73 20 61 6d 75 20 69 |e lines as amu i|
00001180 66 20 69 6e 76 6f 6b 65 64 0a 61 62 6f 76 65 2e |f invoked.above.|
00001190 20 54 68 65 20 6f 70 74 69 6f 6e 73 20 75 73 65 | The options use|
000011a0 64 20 64 65 70 65 6e 64 20 6f 6e 20 74 68 65 20 |d depend on the |
000011b0 6d 6f 64 65 20 61 6e 64 20 61 72 65 20 61 73 20 |mode and are as |
000011c0 66 6f 6c 6c 6f 77 73 3a 0a 0a 20 20 43 20 20 20 |follows:.. C |
000011d0 20 20 20 2d 20 27 2d 49 43 3a 20 2d 74 68 72 6f | - '-IC: -thro|
000011e0 77 62 61 63 6b 20 2d 4c 43 3a 6f 2e 52 49 53 43 |wback -LC:o.RISC|
000011f0 5f 4f 53 6c 69 62 2c 43 3a 6f 2e 73 74 75 62 73 |_OSlib,C:o.stubs|
00001200 20 2d 44 65 73 6b 74 6f 70 20 5e 27 0a 20 20 41 | -Desktop ^'. A|
00001210 73 6d 20 20 20 20 2d 20 41 73 73 65 6d 62 6c 79 |sm - Assembly|
00001220 20 64 6f 65 73 20 6e 6f 74 20 77 6f 72 6b 20 61 | does not work a|
00001230 74 20 74 68 65 20 6d 6f 6d 65 6e 74 2e 20 4d 61 |t the moment. Ma|
00001240 6b 65 66 69 6c 65 73 20 61 72 65 20 73 74 69 6c |kefiles are stil|
00001250 6c 20 6f 6b 0a 20 20 20 20 20 20 20 20 20 20 20 |l ok. |
00001260 74 68 6f 75 67 68 0a 20 20 50 61 73 63 61 6c 20 |though. Pascal |
00001270 2d 20 27 2d 72 61 6e 70 72 76 20 2d 4c 43 3a 6f |- '-ranprv -LC:o|
00001280 2e 53 74 75 62 73 20 2d 74 68 72 6f 77 62 61 63 |.Stubs -throwbac|
00001290 6b 20 2d 64 65 73 6b 74 6f 70 20 5e 27 0a 0a 36 |k -desktop ^'..6|
000012a0 2e 20 54 68 65 72 65 20 69 73 20 6f 6e 65 20 6c |. There is one l|
000012b0 61 73 74 20 66 65 61 74 75 72 65 20 74 6f 20 65 |ast feature to e|
000012c0 6e 73 75 72 65 20 31 30 30 25 20 66 6c 65 78 69 |nsure 100% flexi|
000012d0 62 69 6c 69 74 79 2e 20 49 66 20 74 68 65 20 63 |bility. If the c|
000012e0 68 61 72 61 63 74 65 72 73 0a 27 2f 2a 2b a0 27 |haracters.'/*+.'|
000012f0 2c 20 27 3b 2b a0 27 20 6f 72 20 27 28 2a 2b a0 |, ';+.' or '(*+.|
00001300 27 20 28 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 |' (depending on |
00001310 6d 6f 64 65 29 20 61 72 65 20 66 6f 75 6e 64 20 |mode) are found |
00001320 77 69 74 68 69 6e 20 74 68 65 20 66 69 72 73 74 |within the first|
00001330 20 31 6b 20 6f 66 0a 74 68 65 20 73 6f 75 72 63 | 1k of.the sourc|
00001340 65 20 66 69 6c 65 20 77 68 65 6e 20 69 6e 76 6f |e file when invo|
00001350 6b 69 6e 67 20 61 6d 75 20 6f 72 20 63 6f 6d 70 |king amu or comp|
00001360 69 6c 61 74 69 6f 6e 2f 61 73 73 65 6d 62 6c 79 |ilation/assembly|
00001370 20 64 69 72 65 63 74 6c 79 20 69 6e 20 61 20 74 | directly in a t|
00001380 61 73 6b 0a 77 69 6e 64 6f 77 2c 20 74 68 65 6e |ask.window, then|
00001390 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 63 | the following c|
000013a0 68 61 72 61 63 74 65 72 73 20 75 6e 74 69 6c 20 |haracters until |
000013b0 74 68 65 20 6e 65 78 74 20 63 6c 6f 73 65 20 63 |the next close c|
000013c0 6f 6d 6d 65 6e 74 20 6f 72 20 65 6e 64 0a 6f 66 |omment or end.of|
000013d0 20 6c 69 6e 65 20 61 72 65 20 75 73 65 64 20 49 | line are used I|
000013e0 4e 53 54 45 41 44 20 6f 66 20 74 68 65 20 64 65 |NSTEAD of the de|
000013f0 66 61 75 6c 74 20 6f 70 74 69 6f 6e 73 20 73 74 |fault options st|
00001400 72 69 6e 67 2e 20 54 68 69 73 20 6d 65 61 6e 73 |ring. This means|
00001410 20 74 68 61 74 20 69 66 0a 79 6f 75 20 64 6f 6e | that if.you don|
00001420 27 74 20 6c 69 6b 65 20 74 68 65 20 64 65 66 61 |'t like the defa|
00001430 75 6c 74 20 6f 70 74 69 6f 6e 73 2c 20 79 6f 75 |ult options, you|
00001440 20 63 61 6e 20 73 75 70 70 6c 79 20 79 6f 75 72 | can supply your|
00001450 20 6f 77 6e 2e 20 28 46 6f 72 20 69 6e 73 74 61 | own. (For insta|
00001460 6e 63 65 2c 0a 69 66 20 79 6f 75 20 69 6e 63 6c |nce,.if you incl|
00001470 75 64 65 20 65 78 74 72 61 20 6c 69 62 72 61 72 |ude extra librar|
00001480 69 65 73 20 6f 72 20 77 61 6e 74 20 64 65 62 75 |ies or want debu|
00001490 67 20 63 6f 64 65 20 67 65 6e 65 72 61 74 65 64 |g code generated|
000014a0 2e 29 0a 0a 4e 6f 74 65 20 74 68 61 74 20 74 68 |.)..Note that th|
000014b0 65 20 6d 61 78 69 6d 75 6d 20 6c 65 6e 67 74 68 |e maximum length|
000014c0 20 66 6f 72 20 74 68 65 20 63 6f 6d 6d 61 6e 64 | for the command|
000014d0 20 69 73 73 75 65 64 20 69 73 20 32 35 36 20 63 | issued is 256 c|
000014e0 68 61 72 61 63 74 65 72 73 2c 0a 69 6e 63 6c 75 |haracters,.inclu|
000014f0 64 69 6e 67 20 74 68 65 20 66 69 6c 65 6e 61 6d |ding the filenam|
00001500 65 2c 20 63 6f 6d 6d 61 6e 64 73 20 61 6e 64 20 |e, commands and |
00001510 74 68 65 20 76 61 72 69 6f 75 73 20 6f 70 74 69 |the various opti|
00001520 6f 6e 73 2e 20 41 6c 73 6f 2c 20 4e 4f 0a 74 72 |ons. Also, NO.tr|
00001530 61 6e 73 6c 61 74 69 6f 6e 20 69 73 20 63 61 72 |anslation is car|
00001540 72 69 65 64 20 6f 75 74 20 69 6e 20 63 6f 70 79 |ried out in copy|
00001550 69 6e 67 20 74 68 65 20 6f 70 74 69 6f 6e 73 2e |ing the options.|
00001560 20 48 6f 77 65 76 65 72 2c 20 77 68 65 6e 20 63 | However, when c|
00001570 61 6c 6c 69 6e 67 0a 2a 54 61 73 6b 57 69 6e 64 |alling.*TaskWind|
00001580 6f 77 2c 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 |ow, the command |
00001590 69 73 20 70 6c 61 63 65 64 20 69 6e 20 71 75 6f |is placed in quo|
000015a0 74 65 73 20 2d 20 73 6f 20 69 66 20 61 6e 79 20 |tes - so if any |
000015b0 77 65 72 65 20 72 65 71 75 69 72 65 64 20 69 6e |were required in|
000015c0 20 74 68 65 0a 6f 70 74 69 6f 6e 73 20 73 74 72 | the.options str|
000015d0 69 6e 67 20 74 68 65 79 20 77 6f 75 6c 64 20 68 |ing they would h|
000015e0 61 76 65 20 74 6f 20 62 65 20 64 6f 75 62 6c 65 |ave to be double|
000015f0 64 20 75 70 20 6f 72 69 67 69 6e 61 6c 6c 79 2e |d up originally.|
00001600 0a 0a 0a 54 68 65 72 65 20 61 72 65 20 74 77 6f |...There are two|
00001610 20 63 6f 6d 6d 61 6e 64 73 20 74 6f 20 69 6e 76 | commands to inv|
00001620 6f 6b 65 20 63 6f 6d 70 69 6c 61 74 69 6f 6e 3b |oke compilation;|
00001630 20 43 4f 4d 50 49 4c 45 20 77 68 69 63 68 20 73 | COMPILE which s|
00001640 61 76 65 73 20 61 6e 64 20 74 68 65 6e 0a 63 6f |aves and then.co|
00001650 6d 70 69 6c 65 73 20 28 61 73 73 75 6d 69 6e 67 |mpiles (assuming|
00001660 20 74 68 65 20 73 61 76 65 20 77 61 73 20 6f 6b | the save was ok|
00001670 29 2c 20 61 6e 64 20 52 55 4e 20 77 68 69 63 68 |), and RUN which|
00001680 20 63 6f 6d 70 69 6c 65 73 20 77 69 74 68 6f 75 | compiles withou|
00001690 74 20 73 61 76 69 6e 67 0a 74 68 65 20 63 75 72 |t saving.the cur|
000016a0 72 65 6e 74 20 66 69 6c 65 2e 20 28 54 68 65 73 |rent file. (Thes|
000016b0 65 20 63 6f 72 72 65 73 70 6f 6e 64 20 74 6f 20 |e correspond to |
000016c0 74 68 65 20 65 71 75 69 76 61 6c 65 6e 74 20 42 |the equivalent B|
000016d0 41 53 49 43 20 63 6f 6d 6d 61 6e 64 73 2e 29 0a |ASIC commands.).|
000016e0 0a 0a 49 6e 64 65 6e 74 69 6e 67 0a 2d 2d 2d 2d |..Indenting.----|
000016f0 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 69 73 20 63 |-----..This is c|
00001700 75 72 72 65 6e 74 6c 79 20 6f 6e 6c 79 20 70 72 |urrently only pr|
00001710 65 73 65 6e 74 20 69 6e 20 74 68 65 20 43 20 6d |esent in the C m|
00001720 6f 64 65 2c 20 61 6e 64 20 73 69 6d 70 6c 79 20 |ode, and simply |
00001730 70 75 74 73 20 74 68 65 20 72 65 71 75 65 73 74 |puts the request|
00001740 65 64 0a 6e 75 6d 62 65 72 20 6f 66 20 65 78 74 |ed.number of ext|
00001750 72 61 20 73 70 61 63 65 73 20 6f 6e 74 6f 20 74 |ra spaces onto t|
00001760 68 65 20 69 6e 64 65 6e 74 20 66 6f 72 20 74 68 |he indent for th|
00001770 65 20 6c 69 6e 65 20 66 6f 6c 6c 6f 77 69 6e 67 |e line following|
00001780 20 61 20 7b 2c 20 61 6e 64 0a 61 6c 69 67 6e 73 | a {, and.aligns|
00001790 20 7d 73 20 75 70 20 77 69 74 68 20 74 68 65 20 | }s up with the |
000017a0 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67 20 7b 2e |corresponding {.|
000017b0 20 54 68 65 20 69 6e 64 65 6e 74 20 69 73 20 73 | The indent is s|
000017c0 65 74 20 76 69 61 20 74 68 65 20 43 20 6d 6f 64 |et via the C mod|
000017d0 65 0a 6d 65 6e 75 2c 20 61 6e 64 20 73 68 6f 75 |e.menu, and shou|
000017e0 6c 64 20 68 61 76 65 20 74 68 65 20 76 61 6c 75 |ld have the valu|
000017f0 65 20 30 20 74 6f 20 64 69 73 61 62 6c 65 20 74 |e 0 to disable t|
00001800 68 65 20 66 65 61 74 75 72 65 2e 0a 0a 0a 42 72 |he feature....Br|
00001810 61 63 6b 65 74 20 6d 61 74 63 68 69 6e 67 0a 2d |acket matching.-|
00001820 2d 2d 2d 2d 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 0a |------ --------.|
00001830 0a 43 75 72 72 65 6e 74 6c 79 20 6f 6e 6c 79 20 |.Currently only |
00001840 74 68 65 20 27 61 73 20 79 6f 75 20 74 79 70 65 |the 'as you type|
00001850 27 20 6d 61 74 63 68 69 6e 67 20 69 73 20 69 6d |' matching is im|
00001860 70 6c 65 6d 65 6e 74 65 64 20 61 6e 64 20 74 68 |plemented and th|
00001870 65 6e 20 6f 6e 6c 79 20 69 6e 20 74 68 65 0a 43 |en only in the.C|
00001880 20 6d 6f 64 65 2e 20 57 68 65 6e 20 79 6f 75 20 | mode. When you |
00001890 74 79 70 65 20 61 20 63 6c 6f 73 65 20 62 72 61 |type a close bra|
000018a0 63 6b 65 74 20 28 65 69 74 68 65 72 20 29 2c 20 |cket (either ), |
000018b0 7d 20 6f 72 20 5d 29 20 74 68 65 20 63 75 72 73 |} or ]) the curs|
000018c0 6f 72 20 77 69 6c 6c 20 6a 75 6d 70 0a 74 6f 20 |or will jump.to |
000018d0 74 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e |the correspondin|
000018e0 67 20 6f 70 65 6e 20 62 72 61 63 6b 65 74 20 66 |g open bracket f|
000018f0 6f 72 20 74 68 65 20 74 69 6d 65 20 73 70 65 63 |or the time spec|
00001900 69 66 69 65 64 20 69 6e 20 74 68 65 20 70 61 75 |ified in the pau|
00001910 73 65 20 65 6e 74 72 79 0a 69 6e 20 74 68 65 20 |se entry.in the |
00001920 43 20 6d 6f 64 65 20 6d 65 6e 75 20 28 69 6e 20 |C mode menu (in |
00001930 63 65 6e 74 69 73 65 63 6f 6e 64 73 29 2e 20 54 |centiseconds). T|
00001940 68 65 20 70 61 75 73 65 20 77 69 6c 6c 20 62 65 |he pause will be|
00001950 20 74 72 75 6e 63 61 74 65 64 20 69 66 20 79 6f | truncated if yo|
00001960 75 0a 63 61 72 72 79 20 6f 6e 20 74 79 70 69 6e |u.carry on typin|
00001970 67 2e 20 54 6f 20 64 69 73 61 62 6c 65 20 69 74 |g. To disable it|
00001980 2c 20 73 65 74 20 74 68 65 20 70 61 75 73 65 20 |, set the pause |
00001990 74 6f 20 30 20 63 65 6e 74 69 73 65 63 6f 6e 64 |to 0 centisecond|
000019a0 73 2e 0a 0a 0a 46 75 6e 63 74 69 6f 6e 20 62 72 |s....Function br|
000019b0 6f 77 73 65 72 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 20 |owsers.-------- |
000019c0 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 66 |--------..This f|
000019d0 65 61 74 75 72 65 20 77 6f 72 6b 73 20 6f 6e 20 |eature works on |
000019e0 61 6c 6c 20 74 68 72 65 65 20 6d 6f 64 65 73 2c |all three modes,|
000019f0 20 61 6e 64 20 73 69 6d 70 6c 79 20 70 72 6f 76 | and simply prov|
00001a00 69 64 65 73 20 61 20 62 72 6f 77 73 65 72 20 6f |ides a browser o|
00001a10 66 20 61 6c 6c 0a 74 68 65 20 66 75 6e 63 74 69 |f all.the functi|
00001a20 6f 6e 20 64 65 66 69 6e 69 74 69 6f 6e 73 20 69 |on definitions i|
00001a30 6e 20 74 68 65 20 73 6f 75 72 63 65 20 66 69 6c |n the source fil|
00001a40 65 2e 20 43 20 6d 6f 64 65 20 63 6f 72 72 65 63 |e. C mode correc|
00001a50 74 6c 79 20 63 6f 70 65 73 20 77 69 74 68 20 6f |tly copes with o|
00001a60 6c 64 0a 61 6e 64 20 6e 65 77 20 73 74 79 6c 65 |ld.and new style|
00001a70 20 66 75 6e 63 74 69 6f 6e 20 64 65 66 69 6e 69 | function defini|
00001a80 74 69 6f 6e 73 2c 20 61 73 20 77 65 6c 6c 20 61 |tions, as well a|
00001a90 73 20 63 6f 6e 74 72 69 76 65 64 20 73 74 61 74 |s contrived stat|
00001aa0 65 6d 65 6e 74 73 20 73 75 63 68 20 61 73 3a 0a |ements such as:.|
00001ab0 0a 23 69 66 64 65 66 20 5f 5f 53 54 44 43 5f 5f |.#ifdef __STDC__|
00001ac0 0a 69 6e 74 20 77 69 62 62 6c 65 28 69 6e 74 20 |.int wibble(int |
00001ad0 77 6f 62 62 6c 65 29 0a 23 65 6c 73 65 0a 69 6e |wobble).#else.in|
00001ae0 74 20 77 69 62 62 6c 65 28 77 6f 62 62 6c 65 29 |t wibble(wobble)|
00001af0 0a 69 6e 74 20 77 6f 62 62 6c 65 3b 0a 23 65 6e |.int wobble;.#en|
00001b00 64 69 66 0a 7b 0a 20 20 2e 2e 2e 0a 0a 77 68 69 |dif.{. .....whi|
00001b10 63 68 20 61 72 65 20 64 65 73 69 67 6e 65 64 20 |ch are designed |
00001b20 74 6f 20 77 6f 72 6b 20 75 6e 64 65 72 20 62 6f |to work under bo|
00001b30 74 68 20 70 63 63 20 61 6e 64 20 41 4e 53 49 20 |th pcc and ANSI |
00001b40 63 6f 6d 70 69 6c 65 72 73 2e 20 41 73 73 65 6d |compilers. Assem|
00001b50 62 6c 65 72 20 6d 6f 64 65 0a 73 69 6d 70 6c 79 |bler mode.simply|
00001b60 20 6c 69 73 74 73 20 61 6c 6c 20 74 68 65 20 6c | lists all the l|
00001b70 69 6e 65 73 20 6f 6e 20 77 68 69 63 68 20 6c 61 |ines on which la|
00001b80 62 65 6c 73 20 61 72 65 20 64 65 66 69 6e 65 64 |bels are defined|
00001b90 2e 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 |. This feature i|
00001ba0 73 0a 69 6e 76 6f 6b 65 64 20 77 69 74 68 20 74 |s.invoked with t|
00001bb0 68 65 20 73 74 61 6e 64 61 72 64 20 63 6f 6d 6d |he standard comm|
00001bc0 61 6e 64 20 4c 49 53 54 46 4e 53 2e 0a 0a 0a 4e |and LISTFNS....N|
00001bd0 65 78 74 2f 6c 61 73 74 20 66 75 6e 63 74 69 6f |ext/last functio|
00001be0 6e 0a 2d 2d 2d 2d 20 2d 2d 2d 2d 20 2d 2d 2d 2d |n.---- ---- ----|
00001bf0 2d 2d 2d 2d 0a 0a 54 68 65 73 65 20 77 6f 72 6b |----..These work|
00001c00 20 69 6e 20 74 68 65 20 73 61 6d 65 20 77 61 79 | in the same way|
00001c10 20 61 73 20 74 68 65 20 66 75 6e 63 74 69 6f 6e | as the function|
00001c20 20 62 72 6f 77 73 65 72 2c 20 62 75 74 20 70 6c | browser, but pl|
00001c30 61 63 65 20 74 68 65 20 63 75 72 73 6f 72 20 61 |ace the cursor a|
00001c40 74 0a 74 68 65 20 64 65 66 69 6e 69 74 69 6f 6e |t.the definition|
00001c50 20 6f 66 20 74 68 65 20 6e 65 78 74 20 6f 72 20 | of the next or |
00001c60 70 72 65 76 69 6f 75 73 20 66 75 6e 63 74 69 6f |previous functio|
00001c70 6e 20 69 6e 20 74 68 65 20 73 6f 75 72 63 65 20 |n in the source |
00001c80 66 69 6c 65 2e 20 54 68 65 79 20 61 72 65 0a 69 |file. They are.i|
00001c90 6e 76 6f 6b 65 64 20 77 69 74 68 20 4d 4a 45 5f |nvoked with MJE_|
00001ca0 4e 45 58 54 46 55 4e 43 20 61 6e 64 20 4d 4a 45 |NEXTFUNC and MJE|
00001cb0 5f 4c 41 53 54 46 55 4e 43 20 72 65 73 70 65 63 |_LASTFUNC respec|
00001cc0 74 69 76 65 6c 79 2e 0a 0a 0a 53 77 61 70 20 74 |tively....Swap t|
00001cd0 6f 20 68 65 61 64 65 72 0a 2d 2d 2d 2d 20 2d 2d |o header.---- --|
00001ce0 20 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 6d 6f | ------..This mo|
00001cf0 76 65 73 20 74 68 65 20 69 6e 70 75 74 20 66 6f |ves the input fo|
00001d00 63 75 73 20 6f 6e 74 6f 20 74 68 65 20 63 6f 72 |cus onto the cor|
00001d10 72 65 73 70 6f 6e 64 69 6e 67 20 68 65 61 64 65 |responding heade|
00001d20 72 2f 73 6f 75 72 63 65 20 66 69 6c 65 20 28 69 |r/source file (i|
00001d30 65 2e 0a 77 69 74 68 20 74 68 65 20 73 61 6d 65 |e..with the same|
00001d40 20 6c 65 61 66 6e 61 6d 65 29 20 66 6f 72 20 74 | leafname) for t|
00001d50 68 65 20 63 75 72 72 65 6e 74 20 73 6f 75 72 63 |he current sourc|
00001d60 65 2f 68 65 61 64 65 72 20 66 69 6c 65 20 28 61 |e/header file (a|
00001d70 73 73 75 6d 69 6e 67 20 6f 6e 65 0a 65 78 69 73 |ssuming one.exis|
00001d80 74 73 29 2e 20 49 74 20 61 6c 73 6f 20 6c 6f 61 |ts). It also loa|
00001d90 64 73 20 74 68 65 20 66 69 6c 65 20 69 66 20 6e |ds the file if n|
00001da0 65 63 65 73 73 61 72 79 2e 20 54 68 65 20 63 6f |ecessary. The co|
00001db0 72 72 65 73 70 6f 6e 64 69 6e 67 20 68 65 61 64 |rresponding head|
00001dc0 65 72 20 66 69 6c 65 0a 69 73 20 6f 66 20 74 68 |er file.is of th|
00001dd0 65 20 66 6f 72 6d 20 73 6f 75 72 63 65 66 69 6c |e form sourcefil|
00001de0 65 2e 5e 2e 5e 2e 68 2e 73 6f 75 72 63 65 66 69 |e.^.^.h.sourcefi|
00001df0 6c 65 2c 20 61 6e 64 20 74 68 65 20 63 6f 72 72 |le, and the corr|
00001e00 65 73 70 6f 6e 64 69 6e 67 20 73 6f 75 72 63 65 |esponding source|
00001e10 66 69 6c 65 0a 69 73 20 6f 66 20 74 68 65 20 66 |file.is of the f|
00001e20 6f 72 6d 20 68 65 61 64 65 72 66 69 6c 65 2e 5e |orm headerfile.^|
00001e30 2e 5e 2e 78 2e 68 65 61 64 65 72 66 69 6c 65 20 |.^.x.headerfile |
00001e40 77 68 65 72 65 20 78 20 69 73 20 63 2c 20 73 20 |where x is c, s |
00001e50 6f 72 20 70 20 64 65 70 65 6e 64 69 6e 67 20 6f |or p depending o|
00001e60 6e 0a 6d 6f 64 65 2e 20 54 68 69 73 20 66 65 61 |n.mode. This fea|
00001e70 74 75 72 65 20 69 73 20 69 6e 76 6f 6b 65 64 20 |ture is invoked |
00001e80 77 69 74 68 20 4d 4a 45 5f 53 57 41 50 54 4f 48 |with MJE_SWAPTOH|
00001e90 45 41 44 45 52 2e 0a 0a 0a 45 78 63 65 73 73 20 |EADER....Excess |
00001ea0 73 70 61 63 65 20 72 65 6d 6f 76 61 6c 0a 2d 2d |space removal.--|
00001eb0 2d 2d 2d 2d 20 2d 2d 2d 2d 2d 20 2d 2d 2d 2d 2d |---- ----- -----|
00001ec0 2d 2d 0a 0a 54 68 69 73 20 61 75 74 6f 6d 61 74 |--..This automat|
00001ed0 69 63 61 6c 6c 79 20 6f 63 63 75 72 73 20 6f 6e |ically occurs on|
00001ee0 20 73 61 76 69 6e 67 20 74 68 65 20 66 69 6c 65 | saving the file|
00001ef0 2c 20 61 6e 64 20 73 69 6d 70 6c 79 20 72 65 6d |, and simply rem|
00001f00 6f 76 65 73 20 61 6e 79 20 65 78 63 65 73 73 0a |oves any excess.|
00001f10 77 68 69 74 65 73 70 61 63 65 20 6f 6e 20 74 68 |whitespace on th|
00001f20 65 20 65 6e 64 73 20 6f 66 20 6c 69 6e 65 73 2e |e ends of lines.|
00001f30 20 54 68 65 73 65 20 73 65 72 76 65 20 6e 6f 20 | These serve no |
00001f40 70 75 72 70 6f 73 65 20 6f 74 68 65 72 20 74 68 |purpose other th|
00001f50 61 6e 20 74 6f 20 77 61 73 74 65 0a 6d 65 6d 6f |an to waste.memo|
00001f60 72 79 20 61 6e 64 20 73 6c 6f 77 20 74 68 69 6e |ry and slow thin|
00001f70 67 73 20 64 6f 77 6e 2c 20 61 6e 64 20 73 69 6e |gs down, and sin|
00001f80 63 65 20 74 68 65 79 20 61 72 65 20 65 61 73 69 |ce they are easi|
00001f90 6c 79 20 67 65 6e 65 72 61 74 65 64 20 77 69 74 |ly generated wit|
00001fa0 68 20 74 68 65 0a 61 75 74 6f 2d 69 6e 64 65 6e |h the.auto-inden|
00001fb0 74 61 74 69 6f 6e 2c 20 69 74 20 6e 65 65 64 73 |tation, it needs|
00001fc0 20 73 6f 6d 65 20 77 61 79 20 6f 66 20 65 61 73 | some way of eas|
00001fd0 79 20 72 65 6d 6f 76 61 6c 2e 20 54 68 69 73 20 |y removal. This |
00001fe0 69 73 20 70 72 65 73 65 6e 74 20 6f 6e 6c 79 20 |is present only |
00001ff0 61 73 0a 61 20 73 74 6f 70 2d 67 61 70 20 75 6e |as.a stop-gap un|
00002000 74 69 6c 20 5a 61 70 20 73 75 70 70 6f 72 74 73 |til Zap supports|
00002010 20 69 74 20 70 72 6f 70 65 72 6c 79 2e 0a 0a 0a | it properly....|
00002020 50 72 65 76 69 6f 75 73 20 61 6e 64 20 6e 65 78 |Previous and nex|
00002030 74 20 77 6f 72 64 0a 2d 2d 2d 2d 2d 2d 2d 2d 20 |t word.-------- |
00002040 2d 2d 2d 20 2d 2d 2d 2d 20 2d 2d 2d 2d 0a 0a 54 |--- ---- ----..T|
00002050 68 65 20 70 72 65 76 69 6f 75 73 20 61 6e 64 20 |he previous and |
00002060 6e 65 78 74 20 77 6f 72 64 20 63 6f 6d 6d 61 6e |next word comman|
00002070 64 73 20 28 73 68 69 66 74 2d 6c 65 66 74 20 26 |ds (shift-left &|
00002080 20 73 68 69 66 74 2d 72 69 67 68 74 29 20 6f 66 | shift-right) of|
00002090 20 5a 61 70 20 61 72 65 0a 69 6e 74 65 6e 64 65 | Zap are.intende|
000020a0 64 20 66 6f 72 20 75 73 65 20 77 68 65 6e 20 74 |d for use when t|
000020b0 65 78 74 20 65 64 69 74 69 6e 67 2c 20 61 6e 64 |ext editing, and|
000020c0 20 61 73 20 73 75 63 68 20 6f 6e 6c 79 20 73 74 | as such only st|
000020d0 6f 70 20 61 66 74 65 72 20 77 68 69 74 65 73 70 |op after whitesp|
000020e0 61 63 65 20 6f 72 0a 70 61 72 65 6e 74 68 65 73 |ace or.parenthes|
000020f0 65 73 2e 20 54 68 69 73 20 69 73 20 66 69 6e 65 |es. This is fine|
00002100 20 66 6f 72 20 74 65 78 74 2c 20 62 75 74 20 74 | for text, but t|
00002110 6f 74 61 6c 6c 79 20 75 6e 73 75 69 74 61 62 6c |otally unsuitabl|
00002120 65 20 66 6f 72 20 70 72 6f 67 72 61 6d 0a 65 64 |e for program.ed|
00002130 69 74 69 6e 67 20 75 6e 6c 65 73 73 20 79 6f 75 |iting unless you|
00002140 20 61 72 65 20 6c 69 62 65 72 61 6c 20 77 69 74 | are liberal wit|
00002150 68 20 79 6f 75 72 20 73 70 61 63 65 73 20 28 49 |h your spaces (I|
00002160 27 6d 20 6e 6f 74 29 2e 20 46 6f 72 20 69 6e 73 |'m not). For ins|
00002170 74 61 6e 63 65 2c 0a 70 72 65 76 69 6f 75 73 2f |tance,.previous/|
00002180 6e 65 78 74 20 77 6f 72 64 20 77 6f 75 6c 64 20 |next word would |
00002190 6a 75 6d 70 20 72 69 67 68 74 20 6f 76 65 72 20 |jump right over |
000021a0 27 77 68 61 74 65 76 65 72 3d 74 68 69 73 2b 74 |'whatever=this+t|
000021b0 68 61 74 2f 73 6f 6d 65 74 68 69 6e 67 5f 65 6c |hat/something_el|
000021c0 73 65 3b 27 0a 77 68 69 63 68 20 69 73 20 6e 6f |se;'.which is no|
000021d0 74 20 76 65 72 79 20 75 73 65 66 75 6c 2e 20 46 |t very useful. F|
000021e0 6f 72 20 74 68 61 74 20 72 65 61 73 6f 6e 20 61 |or that reason a|
000021f0 6c 6c 20 74 68 72 65 65 20 6f 66 20 74 68 65 20 |ll three of the |
00002200 65 78 74 72 61 20 6d 6f 64 65 73 20 68 61 76 65 |extra modes have|
00002210 20 61 0a 6d 75 63 68 20 6d 6f 72 65 20 70 6f 77 | a.much more pow|
00002220 65 72 66 75 6c 20 69 6d 70 6c 65 6d 65 6e 74 61 |erful implementa|
00002230 74 69 6f 6e 20 61 73 20 73 74 61 6e 64 61 72 64 |tion as standard|
00002240 2e 20 49 74 20 63 61 6e 20 62 65 20 74 68 6f 75 |. It can be thou|
00002250 67 68 74 20 6f 66 20 61 73 0a 77 6f 72 6b 69 6e |ght of as.workin|
00002260 67 20 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 54 68 |g like this:..Th|
00002270 65 72 65 20 61 72 65 20 35 20 63 61 74 65 67 6f |ere are 5 catego|
00002280 72 69 65 73 20 6f 66 20 63 68 61 72 61 63 74 65 |ries of characte|
00002290 72 2c 20 63 6c 61 73 73 69 66 69 65 64 20 69 6e |r, classified in|
000022a0 20 64 65 73 63 65 6e 64 69 6e 67 20 6f 72 64 65 | descending orde|
000022b0 72 20 61 73 3a 0a 0a 20 20 35 3a 20 4e 65 77 6c |r as:.. 5: Newl|
000022c0 69 6e 65 20 63 68 61 72 61 63 74 65 72 0a 20 20 |ine character. |
000022d0 34 3a 20 4c 65 74 74 65 72 73 20 61 6e 64 20 6e |4: Letters and n|
000022e0 75 6d 62 65 72 73 0a 20 20 33 3a 20 41 6e 79 74 |umbers. 3: Anyt|
000022f0 68 69 6e 67 20 65 6c 73 65 20 6e 6f 6e 2d 77 68 |hing else non-wh|
00002300 69 74 65 73 70 61 63 65 20 28 69 65 2e 20 73 79 |itespace (ie. sy|
00002310 6d 62 6f 6c 73 29 0a 20 20 32 3a 20 57 68 69 74 |mbols). 2: Whit|
00002320 65 73 70 61 63 65 20 28 73 70 61 63 65 20 61 6e |espace (space an|
00002330 64 20 74 61 62 29 0a 20 20 31 3a 20 4e 65 77 6c |d tab). 1: Newl|
00002340 69 6e 65 20 63 68 61 72 61 63 74 65 72 0a 0a 57 |ine character..W|
00002350 68 65 6e 20 79 6f 75 20 70 72 65 73 73 20 73 68 |hen you press sh|
00002360 69 66 74 2d 6c 65 66 74 20 6f 72 20 73 68 69 66 |ift-left or shif|
00002370 74 2d 72 69 67 68 74 2c 20 74 68 65 20 63 75 72 |t-right, the cur|
00002380 73 6f 72 20 77 69 6c 6c 20 62 65 20 6d 6f 76 65 |sor will be move|
00002390 64 20 69 6e 20 74 68 61 74 0a 64 69 72 65 63 74 |d in that.direct|
000023a0 69 6f 6e 20 75 6e 74 69 6c 20 74 68 65 20 63 6c |ion until the cl|
000023b0 61 73 73 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 |assification of |
000023c0 74 68 65 20 6e 65 78 74 20 63 68 61 72 61 63 74 |the next charact|
000023d0 65 72 20 28 69 6e 20 74 68 65 20 64 69 72 65 63 |er (in the direc|
000023e0 74 69 6f 6e 20 69 74 0a 69 73 20 6d 6f 76 69 6e |tion it.is movin|
000023f0 67 29 20 69 73 20 67 72 65 61 74 65 72 20 74 68 |g) is greater th|
00002400 61 6e 20 74 68 61 74 20 6f 66 20 74 68 65 20 63 |an that of the c|
00002410 75 72 72 65 6e 74 20 63 68 61 72 61 63 74 65 72 |urrent character|
00002420 2c 20 75 70 6f 6e 20 77 68 69 63 68 20 69 74 20 |, upon which it |
00002430 77 69 6c 6c 0a 73 74 6f 70 2e 20 4e 65 77 6c 69 |will.stop. Newli|
00002440 6e 65 20 61 70 70 65 61 72 73 20 74 77 69 63 65 |ne appears twice|
00002450 20 69 6e 20 6f 72 64 65 72 20 74 6f 20 65 6e 73 | in order to ens|
00002460 75 72 65 20 74 68 61 74 20 74 68 65 20 63 75 72 |ure that the cur|
00002470 73 6f 72 20 77 69 6c 6c 20 61 6c 77 61 79 73 0a |sor will always.|
00002480 73 74 6f 70 20 6f 6e 20 65 61 63 68 20 73 69 64 |stop on each sid|
00002490 65 20 6f 66 20 69 74 2e 20 28 69 65 2e 20 61 74 |e of it. (ie. at|
000024a0 20 73 74 61 72 74 20 26 20 65 6e 64 20 6f 66 20 | start & end of |
000024b0 6c 69 6e 65 29 2e 0a 0a 54 68 69 73 20 70 72 6f |line)...This pro|
000024c0 62 61 62 6c 79 20 73 6f 75 6e 64 73 20 71 75 69 |bably sounds qui|
000024d0 74 65 20 63 6f 6d 70 6c 69 63 61 74 65 64 2c 20 |te complicated, |
000024e0 62 75 74 20 69 74 20 69 73 20 69 6e 20 61 63 74 |but it is in act|
000024f0 75 61 6c 20 66 61 63 74 20 76 65 72 79 20 65 61 |ual fact very ea|
00002500 73 79 2c 0a 61 6e 64 20 76 65 72 79 20 69 6e 74 |sy,.and very int|
00002510 75 69 74 69 76 65 20 74 6f 20 75 73 65 2e 20 41 |uitive to use. A|
00002520 73 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 68 |s an example, th|
00002530 65 73 65 20 61 72 65 20 74 68 65 20 70 6f 69 6e |ese are the poin|
00002540 74 73 20 74 68 61 74 20 74 68 65 0a 63 75 72 73 |ts that the.curs|
00002550 6f 72 20 77 6f 75 6c 64 20 73 74 6f 70 20 61 74 |or would stop at|
00002560 3a 0a 0a 4c 69 6e 65 3a 20 20 69 66 28 28 63 68 |:..Line: if((ch|
00002570 61 72 32 3d 67 65 74 63 68 61 72 28 29 29 21 3d |ar2=getchar())!=|
00002580 30 20 26 26 20 63 68 61 72 32 21 3d 6c 69 6e 65 |0 && char2!=line|
00002590 5f 74 65 72 6d 69 6e 61 74 6f 72 29 0a 46 77 64 |_terminator).Fwd|
000025a0 20 3a 20 20 5e 20 20 20 5e 20 20 20 20 20 5e 20 | : ^ ^ ^ |
000025b0 20 20 20 20 20 20 20 20 20 20 5e 20 5e 20 20 5e | ^ ^ ^|
000025c0 20 20 20 20 20 20 5e 20 20 20 20 5e 20 20 20 20 | ^ ^ |
000025d0 20 20 20 20 20 20 5e 0a 42 61 63 6b 3a 5e 20 20 | ^.Back:^ |
000025e0 20 5e 20 20 20 20 20 20 5e 20 20 20 20 20 20 20 | ^ ^ |
000025f0 5e 20 20 20 20 20 5e 20 20 5e 20 20 20 20 20 5e |^ ^ ^ ^|
00002600 20 20 20 20 20 5e 20 20 20 20 20 20 20 20 20 20 | ^ |
00002610 5e 0a 0a 0a 54 61 62 20 74 79 70 65 20 6d 6f 64 |^...Tab type mod|
00002620 65 20 73 70 65 63 69 66 69 63 0a 2d 2d 2d 20 2d |e specific.--- -|
00002630 2d 2d 2d 20 2d 2d 2d 2d 20 2d 2d 2d 2d 2d 2d 2d |--- ---- -------|
00002640 2d 0a 0a 41 20 70 72 6f 62 6c 65 6d 20 77 69 74 |-..A problem wit|
00002650 68 20 5a 61 70 20 77 68 69 63 68 20 73 68 6f 75 |h Zap which shou|
00002660 6c 64 20 62 65 20 66 69 78 65 64 20 73 6f 6f 6e |ld be fixed soon|
00002670 20 69 73 20 74 68 61 74 20 6e 6f 74 20 65 6e 6f | is that not eno|
00002680 75 67 68 20 6f 70 74 69 6f 6e 73 20 61 72 65 0a |ugh options are.|
00002690 6d 6f 64 65 20 73 70 65 63 69 66 69 63 2e 20 65 |mode specific. e|
000026a0 67 2e 20 74 61 62 20 74 79 70 65 2e 20 54 68 69 |g. tab type. Thi|
000026b0 73 20 69 73 20 62 6f 75 6e 64 20 74 6f 20 62 65 |s is bound to be|
000026c0 20 64 69 66 66 65 72 65 6e 74 20 66 6f 72 20 64 | different for d|
000026d0 69 66 66 65 72 65 6e 74 0a 6d 6f 64 65 73 20 28 |ifferent.modes (|
000026e0 65 67 2e 20 63 6f 6c 75 6d 6e 2f 55 6e 69 78 20 |eg. column/Unix |
000026f0 74 61 62 20 69 6e 20 61 73 73 65 6d 62 6c 65 72 |tab in assembler|
00002700 2c 20 45 64 69 74 20 74 61 62 20 69 6e 20 43 29 |, Edit tab in C)|
00002710 2c 20 73 6f 20 74 68 65 73 65 20 6d 6f 64 65 73 |, so these modes|
00002720 0a 73 75 70 70 6f 72 74 20 69 74 20 61 73 20 6d |.support it as m|
00002730 6f 64 65 20 73 70 65 63 69 66 69 63 2e 20 4e 6f |ode specific. No|
00002740 72 6d 61 6c 6c 79 20 74 68 69 73 20 77 69 6c 6c |rmally this will|
00002750 20 62 65 20 66 69 6e 65 2c 20 62 75 74 20 79 6f | be fine, but yo|
00002760 75 20 6d 61 79 20 6e 6f 74 69 63 65 0a 74 68 61 |u may notice.tha|
00002770 74 20 69 66 20 79 6f 75 20 73 77 69 74 63 68 20 |t if you switch |
00002780 66 72 6f 6d 20 74 65 78 74 20 74 6f 20 6f 6e 65 |from text to one|
00002790 20 6f 66 20 74 68 65 73 65 20 6d 6f 64 65 73 20 | of these modes |
000027a0 61 6e 64 20 62 61 63 6b 20 74 6f 20 74 65 78 74 |and back to text|
000027b0 2c 20 74 68 65 20 74 61 62 0a 74 79 70 65 20 77 |, the tab.type w|
000027c0 69 6c 6c 20 68 61 76 65 20 63 68 61 6e 67 65 64 |ill have changed|
000027d0 2e 20 54 68 69 73 20 69 73 20 62 65 63 61 75 73 |. This is becaus|
000027e0 65 20 74 65 78 74 20 64 6f 65 73 20 6e 6f 74 20 |e text does not |
000027f0 68 61 76 65 20 61 20 73 65 74 74 69 6e 67 20 66 |have a setting f|
00002800 6f 72 20 69 74 2e 0a 0a 0a 56 61 72 69 6f 75 73 |or it....Various|
00002810 20 63 6f 6d 6d 65 6e 74 69 6e 67 20 66 65 61 74 | commenting feat|
00002820 75 72 65 73 0a 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 2d |ures.------- ---|
00002830 2d 2d 2d 2d 2d 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d |------- --------|
00002840 0a 0a 54 68 65 73 65 20 61 6c 6c 20 77 6f 72 6b |..These all work|
00002850 20 69 6e 20 61 6c 6c 20 74 68 72 65 65 20 6d 6f | in all three mo|
00002860 64 65 73 20 61 6e 64 20 61 72 65 3a 0a 0a 4d 4a |des and are:..MJ|
00002870 45 5f 4f 50 45 4e 43 4f 4d 4d 45 4e 54 0a 20 20 |E_OPENCOMMENT. |
00002880 54 68 69 73 20 69 6e 73 65 72 74 73 20 74 68 65 |This inserts the|
00002890 20 61 70 70 72 6f 70 72 69 61 74 65 20 6f 70 65 | appropriate ope|
000028a0 6e 20 63 6f 6d 6d 65 6e 74 20 74 65 78 74 20 28 |n comment text (|
000028b0 69 65 2e 20 27 2f 2a a0 27 2c 20 27 3b a0 27 20 |ie. '/*.', ';.' |
000028c0 6f 72 20 27 28 2a a0 27 29 2e 0a 0a 4d 4a 45 5f |or '(*.')...MJE_|
000028d0 43 4c 4f 53 45 43 4f 4d 4d 45 4e 54 0a 20 20 49 |CLOSECOMMENT. I|
000028e0 6e 73 65 72 74 73 20 61 70 70 72 6f 70 72 69 61 |nserts appropria|
000028f0 74 65 20 63 6c 6f 73 65 20 63 6f 6d 6d 65 6e 74 |te close comment|
00002900 20 28 27 a0 2a 2f 27 20 6f 72 20 27 a0 2a 29 27 | ('.*/' or '.*)'|
00002910 20 5b 6e 6f 6e 65 20 66 6f 72 20 61 73 73 65 6d | [none for assem|
00002920 62 6c 65 72 5d 29 2e 0a 0a 4d 4a 45 5f 49 46 0a |bler])...MJE_IF.|
00002930 20 20 49 6e 73 65 72 74 73 20 27 70 72 65 2d 70 | Inserts 'pre-p|
00002940 72 6f 63 65 73 73 6f 72 20 63 6f 6d 6d 65 6e 74 |rocessor comment|
00002950 27 2e 20 69 65 2e 20 75 73 65 73 20 63 6f 6e 64 |'. ie. uses cond|
00002960 69 74 69 6f 6e 61 6c 20 63 6f 6d 70 69 6c 61 74 |itional compilat|
00002970 69 6f 6e 2f 61 73 73 65 6d 62 6c 79 0a 74 6f 20 |ion/assembly.to |
00002980 65 66 66 65 63 74 69 76 65 6c 79 20 63 6f 6d 6d |effectively comm|
00002990 65 6e 74 20 6f 75 74 20 74 68 65 20 73 74 75 66 |ent out the stuf|
000029a0 66 20 61 68 65 61 64 2e 2e 20 28 48 61 6e 64 79 |f ahead.. (Handy|
000029b0 20 69 66 20 74 68 65 72 65 20 61 72 65 20 63 6f | if there are co|
000029c0 6d 6d 65 6e 74 73 0a 61 72 6f 75 6e 64 2c 20 73 |mments.around, s|
000029d0 69 6e 63 65 20 79 6f 75 20 63 61 6e 27 74 20 6e |ince you can't n|
000029e0 65 73 74 20 74 68 65 6d 20 69 6e 20 43 29 2e 20 |est them in C). |
000029f0 49 6e 73 65 72 74 73 20 27 23 69 66 a0 30 5c 6e |Inserts '#if.0\n|
00002a00 27 20 6f 72 20 27 a0 5b 20 31 3c 3e 30 5c 6e 27 |' or '.[ 1<>0\n'|
00002a10 0a 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 6d 6f |.depending on mo|
00002a20 64 65 2e 0a 0a 4d 4a 45 5f 45 4e 44 49 46 0a 20 |de...MJE_ENDIF. |
00002a30 20 46 69 6e 69 73 68 65 73 20 27 70 72 65 2d 70 | Finishes 'pre-p|
00002a40 72 6f 63 65 73 73 6f 72 20 63 6f 6d 6d 65 6e 74 |rocessor comment|
00002a50 27 2e 20 28 69 65 2e 20 69 6e 73 65 72 74 73 20 |'. (ie. inserts |
00002a60 27 23 65 6e 64 69 66 5c 6e 27 20 6f 72 20 27 a0 |'#endif\n' or '.|
00002a70 5d 5c 6e 27 2e 29 0a 0a 4d 4a 45 5f 43 4f 4d 4d |]\n'.)..MJE_COMM|
00002a80 45 4e 54 4c 49 4e 45 0a 20 20 43 6f 6d 6d 65 6e |ENTLINE. Commen|
00002a90 74 73 20 6f 75 74 20 6c 69 6e 65 20 61 6e 64 20 |ts out line and |
00002aa0 6d 6f 76 65 73 20 6f 6e 74 6f 20 6e 65 78 74 2e |moves onto next.|
00002ab0 20 28 69 65 2e 20 69 6e 73 65 72 74 73 20 27 2f | (ie. inserts '/|
00002ac0 2a a0 27 20 26 20 27 a0 2a 2f 27 2c 20 27 3b a0 |*.' & '.*/', ';.|
00002ad0 27 2c 20 6f 72 0a 27 28 2a a0 27 20 26 20 27 a0 |', or.'(*.' & '.|
00002ae0 2a 29 27 20 61 74 20 73 74 61 72 74 20 61 6e 64 |*)' at start and|
00002af0 20 65 6e 64 20 6f 66 20 6c 69 6e 65 2e 29 0a 0a | end of line.)..|
00002b00 4d 4a 45 5f 55 4e 43 4f 4d 4d 45 4e 54 4c 49 4e |MJE_UNCOMMENTLIN|
00002b10 45 0a 20 20 52 65 76 65 72 73 65 73 20 61 62 6f |E. Reverses abo|
00002b20 76 65 2e 20 28 69 65 2e 20 72 65 6d 6f 76 65 73 |ve. (ie. removes|
00002b30 20 27 2f 2a a0 27 20 26 20 27 a0 2a 2f 27 2c 20 | '/*.' & '.*/', |
00002b40 27 3b a0 27 20 6f 72 20 27 28 2a a0 27 20 26 20 |';.' or '(*.' & |
00002b50 27 a0 2a 29 27 20 69 66 0a 70 72 65 73 65 6e 74 |'.*)' if.present|
00002b60 20 61 6e 64 20 6d 6f 76 65 73 20 6f 6e 74 6f 20 | and moves onto |
00002b70 6e 65 78 74 20 6c 69 6e 65 29 0a 0a 0a 4e 6f 6e |next line)...Non|
00002b80 2d 73 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e |-standard option|
00002b90 0a 2d 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 20 2d 2d |.--- -------- --|
00002ba0 2d 2d 2d 2d 0a 0a 54 68 69 73 20 77 69 6c 6c 20 |----..This will |
00002bb0 6e 6f 74 20 62 65 20 76 65 72 79 20 75 73 65 66 |not be very usef|
00002bc0 75 6c 20 74 6f 20 6d 61 6e 79 20 70 65 6f 70 6c |ul to many peopl|
00002bd0 65 2c 20 65 78 63 65 70 74 20 69 66 20 74 68 65 |e, except if the|
00002be0 79 20 6c 61 79 20 74 68 65 69 72 0a 61 73 73 65 |y lay their.asse|
00002bf0 6d 62 6c 65 72 20 73 6f 75 72 63 65 20 6f 75 74 |mbler source out|
00002c00 20 74 68 65 20 73 61 6d 65 20 77 61 79 20 61 73 | the same way as|
00002c10 20 49 20 64 6f 2e 20 42 61 73 69 63 61 6c 6c 79 | I do. Basically|
00002c20 2c 20 69 66 20 65 6e 61 62 6c 65 64 20 74 68 65 |, if enabled the|
00002c30 6e 20 6f 6e 0a 70 72 65 73 73 69 6e 67 20 74 61 |n on.pressing ta|
00002c40 62 20 79 6f 75 20 77 69 6c 6c 20 62 65 20 61 64 |b you will be ad|
00002c50 76 61 6e 63 65 64 20 74 6f 20 74 68 65 20 6e 65 |vanced to the ne|
00002c60 78 74 20 27 73 6f 75 72 63 65 20 63 6f 6c 75 6d |xt 'source colum|
00002c70 6e 27 20 72 61 74 68 65 72 20 74 68 61 6e 20 74 |n' rather than t|
00002c80 61 62 0a 73 74 6f 70 2e 20 49 74 20 6f 6e 6c 79 |ab.stop. It only|
00002c90 20 77 6f 72 6b 73 20 73 65 6e 73 69 62 6c 79 20 | works sensibly |
00002ca0 77 69 74 68 20 55 6e 69 78 20 6f 72 20 63 6f 6c |with Unix or col|
00002cb0 75 6d 6e 20 74 61 62 2c 20 61 6e 64 20 74 68 65 |umn tab, and the|
00002cc0 20 27 73 6f 75 72 63 65 0a 63 6f 6c 75 6d 6e 73 | 'source.columns|
00002cd0 27 20 61 72 65 20 6c 61 69 64 20 6f 75 74 20 61 |' are laid out a|
00002ce0 73 20 66 6f 6c 6c 6f 77 73 20 28 75 73 69 6e 67 |s follows (using|
00002cf0 20 55 6e 69 78 20 74 61 62 29 3a 0a 0a 4c 61 62 | Unix tab):..Lab|
00002d00 65 6c 20 2d 3e 2d 2d 2d 2d 2d 2d 2d 3e 49 6e 73 |el ->------->Ins|
00002d10 20 2d 2d 2d 3e 4f 70 65 72 61 6e 64 73 20 2d 2d | --->Operands --|
00002d20 2d 2d 2d 2d 3e 2d 2d 2d 2d 2d 2d 2d 3e 2d 2d 2d |---->------->---|
00002d30 2d 2d 2d 2d 3e 43 6f 6d 6d 65 6e 74 0a 0a 28 69 |---->Comment..(i|
00002d40 65 2e 20 32 2c 20 31 20 61 6e 64 20 34 20 74 61 |e. 2, 1 and 4 ta|
00002d50 62 20 73 74 6f 70 73 29 0a 0a 49 66 20 79 6f 75 |b stops)..If you|
00002d60 72 20 73 6f 75 72 63 65 20 6c 6f 6f 6b 73 20 6c |r source looks l|
00002d70 69 6b 65 20 74 68 61 74 2c 20 74 68 65 6e 20 74 |ike that, then t|
00002d80 72 79 20 69 74 2c 20 79 6f 75 20 6d 69 67 68 74 |ry it, you might|
00002d90 20 6c 69 6b 65 20 69 74 2e 20 49 66 20 69 74 20 | like it. If it |
00002da0 64 6f 65 73 6e 27 74 0a 74 68 65 6e 20 64 6f 6e |doesn't.then don|
00002db0 27 74 20 73 77 69 74 63 68 20 69 74 20 6f 6e 20 |'t switch it on |
00002dc0 61 6e 64 20 6e 6f 20 68 61 72 6d 20 64 6f 6e 65 |and no harm done|
00002dd0 2e 20 54 68 65 20 6f 6e 6c 79 20 72 65 61 73 6f |. The only reaso|
00002de0 6e 20 69 74 20 69 73 20 69 6e 20 74 68 65 72 65 |n it is in there|
00002df0 20 69 73 0a 62 65 63 61 75 73 65 20 69 74 20 69 | is.because it i|
00002e00 73 20 65 61 73 69 65 72 20 74 68 61 6e 20 64 69 |s easier than di|
00002e10 73 61 62 6c 69 6e 67 20 69 74 20 66 6f 72 20 72 |sabling it for r|
00002e20 65 6c 65 61 73 65 2e 20 41 6c 73 6f 2c 20 44 6f |elease. Also, Do|
00002e30 6d 69 6e 69 63 20 77 61 6e 74 65 64 20 6d 65 0a |minic wanted me.|
00002e40 74 6f 20 75 73 65 20 74 68 65 20 6e 6f 6e 2d 73 |to use the non-s|
00002e50 74 61 6e 64 61 72 64 20 6f 70 74 69 6f 6e 20 69 |tandard option i|
00002e60 6e 20 6f 72 64 65 72 20 74 6f 20 6a 75 73 74 69 |n order to justi|
00002e70 66 79 20 69 74 73 20 65 78 69 73 74 61 6e 63 65 |fy its existance|
00002e80 2e 20 49 20 62 65 74 20 68 65 27 6c 6c 0a 72 65 |. I bet he'll.re|
00002e90 6d 6f 76 65 20 69 74 20 6e 6f 77 20 6a 75 73 74 |move it now just|
00002ea0 20 74 6f 20 73 70 69 74 65 20 6d 65 2e 20 3b 2d | to spite me. ;-|
00002eb0 29 20 54 68 69 73 20 66 65 61 74 75 72 65 20 69 |) This feature i|
00002ec0 73 20 70 72 6f 62 61 62 6c 79 20 6f 6e 6c 79 20 |s probably only |
00002ed0 61 20 73 74 6f 70 2d 67 61 70 0a 75 6e 74 69 6c |a stop-gap.until|
00002ee0 20 5a 61 70 20 73 75 70 70 6f 72 74 73 20 76 61 | Zap supports va|
00002ef0 72 69 61 62 6c 65 20 74 61 62 20 73 74 6f 70 73 |riable tab stops|
00002f00 20 70 72 6f 70 65 72 6c 79 2e 0a 0a 0a 0a 48 65 | properly.....He|
00002f10 6c 70 20 63 6f 6d 6d 61 6e 64 73 0a 3d 3d 3d 3d |lp commands.====|
00002f20 20 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 65 73 65 | ========..These|
00002f30 20 77 6f 72 6b 20 69 6e 20 61 6c 6c 20 6d 6f 64 | work in all mod|
00002f40 65 73 20 28 65 78 63 65 70 74 20 74 6f 6b 65 6e |es (except token|
00002f50 69 73 65 64 20 42 41 53 49 43 20 61 74 20 74 68 |ised BASIC at th|
00002f60 65 20 6d 6f 6d 65 6e 74 29 2e 0a 54 6f 67 65 74 |e moment)..Toget|
00002f70 68 65 72 2c 20 74 68 65 79 20 70 72 6f 76 69 64 |her, they provid|
00002f80 65 20 61 20 6d 6f 72 65 20 63 6f 6d 70 72 65 68 |e a more compreh|
00002f90 65 6e 73 69 76 65 20 69 6e 74 65 72 66 61 63 65 |ensive interface|
00002fa0 20 74 6f 20 53 74 72 6f 6e 67 48 65 6c 70 20 74 | to StrongHelp t|
00002fb0 68 61 6e 0a 53 74 72 6f 6e 67 45 64 20 64 6f 65 |han.StrongEd doe|
00002fc0 73 2e 20 3a 2d 29 0a 0a 0a 43 6f 6e 74 65 78 74 |s. :-)...Context|
00002fd0 20 73 65 6e 73 69 74 69 76 65 0a 2d 2d 2d 2d 2d | sensitive.-----|
00002fe0 2d 2d 20 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 |-- ---------..Th|
00002ff0 69 73 20 70 72 6f 76 69 64 65 73 20 68 65 6c 70 |is provides help|
00003000 20 6f 6e 20 77 68 61 74 65 76 65 72 20 69 73 20 | on whatever is |
00003010 62 79 20 74 68 65 20 63 75 72 73 6f 72 2e 20 43 |by the cursor. C|
00003020 75 72 72 65 6e 74 6c 79 20 69 74 20 6f 6e 6c 79 |urrently it only|
00003030 20 77 6f 72 6b 73 20 69 66 0a 74 68 65 20 63 75 | works if.the cu|
00003040 72 73 6f 72 20 69 73 20 6f 6e 20 74 65 78 74 20 |rsor is on text |
00003050 6f 66 20 73 6f 6d 65 20 64 65 73 63 72 69 70 74 |of some descript|
00003060 69 6f 6e 2c 20 62 75 74 20 69 74 20 69 73 20 73 |ion, but it is s|
00003070 75 62 6a 65 63 74 20 74 6f 20 69 6d 70 72 6f 76 |ubject to improv|
00003080 65 6d 65 6e 74 0a 77 68 65 6e 20 49 20 68 61 76 |ement.when I hav|
00003090 65 20 74 69 6d 65 2e 20 49 74 20 69 73 20 69 6e |e time. It is in|
000030a0 76 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20 63 |voked with the c|
000030b0 6f 6d 6d 61 6e 64 0a 4d 4a 45 5f 48 45 4c 50 43 |ommand.MJE_HELPC|
000030c0 4f 4e 54 45 58 54 2e 0a 0a 0a 50 72 65 76 69 6f |ONTEXT....Previo|
000030d0 75 73 0a 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 |us.--------..Thi|
000030e0 73 20 64 6f 65 73 6e 27 74 20 77 6f 72 6b 20 61 |s doesn't work a|
000030f0 74 20 74 68 65 20 6d 6f 6d 65 6e 74 2c 20 74 68 |t the moment, th|
00003100 6f 75 67 68 20 69 74 20 77 69 6c 6c 20 64 6f 20 |ough it will do |
00003110 6f 6e 65 20 64 61 79 2e 20 4d 4a 45 5f 48 45 4c |one day. MJE_HEL|
00003120 50 4c 41 53 54 20 69 73 0a 74 68 65 20 63 6f 6d |PLAST is.the com|
00003130 6d 61 6e 64 2c 20 61 6e 64 20 69 74 20 77 69 6c |mand, and it wil|
00003140 6c 20 72 65 2d 70 72 6f 64 75 63 65 20 74 68 65 |l re-produce the|
00003150 20 6c 61 73 74 20 78 20 70 72 65 76 69 6f 75 73 | last x previous|
00003160 20 68 65 6c 70 20 73 63 72 65 65 6e 73 20 67 6f | help screens go|
00003170 69 6e 67 0a 62 61 63 6b 20 75 70 20 61 20 73 74 |ing.back up a st|
00003180 61 63 6b 2e 20 28 54 68 69 73 20 69 73 20 6d 6f |ack. (This is mo|
00003190 72 65 20 66 6f 72 20 74 68 65 20 6e 61 74 69 76 |re for the nativ|
000031a0 65 20 73 79 73 74 65 6d 2e 29 0a 0a 0a 54 6f 70 |e system.)...Top|
000031b0 69 63 2f 6b 65 79 77 6f 72 64 0a 2d 2d 2d 2d 2d |ic/keyword.-----|
000031c0 20 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 68 | -------..This h|
000031d0 61 73 20 33 20 6d 6f 64 65 73 20 6f 66 20 6f 70 |as 3 modes of op|
000031e0 65 72 61 74 69 6f 6e 3a 0a 0a 54 68 65 20 63 6f |eration:..The co|
000031f0 6d 6d 61 6e 64 20 4d 4a 45 5f 48 45 4c 50 54 4f |mmand MJE_HELPTO|
00003200 50 49 43 20 22 74 65 78 74 22 20 77 69 6c 6c 20 |PIC "text" will |
00003210 6c 6f 6f 6b 20 66 6f 72 20 68 65 6c 70 20 6f 6e |look for help on|
00003220 20 74 68 65 20 6b 65 79 77 6f 72 64 20 74 65 78 | the keyword tex|
00003230 74 2e 20 54 68 69 73 0a 69 73 20 68 61 6e 64 79 |t. This.is handy|
00003240 20 74 6f 20 68 61 76 65 20 6b 65 79 73 20 66 6f | to have keys fo|
00003250 72 20 61 20 6d 61 69 6e 20 6d 65 6e 75 2c 20 65 |r a main menu, e|
00003260 74 63 2e 0a 0a 54 68 65 20 63 6f 6d 6d 61 6e 64 |tc...The command|
00003270 20 4d 4a 45 5f 48 45 4c 50 54 4f 50 49 43 20 77 | MJE_HELPTOPIC w|
00003280 69 74 68 20 6e 6f 20 70 61 72 61 6d 65 74 65 72 |ith no parameter|
00003290 20 77 69 6c 6c 20 73 65 61 72 63 68 20 66 6f 72 | will search for|
000032a0 20 68 65 6c 70 20 6f 6e 20 77 68 61 74 65 76 65 | help on whateve|
000032b0 72 0a 69 73 20 73 65 6c 65 63 74 65 64 2c 20 61 |r.is selected, a|
000032c0 73 73 75 6d 69 6e 67 20 69 74 20 69 73 20 69 6e |ssuming it is in|
000032d0 20 74 68 65 20 63 75 72 72 65 6e 74 20 77 69 6e | the current win|
000032e0 64 6f 77 20 61 6e 64 20 6e 6f 74 20 74 6f 6f 20 |dow and not too |
000032f0 6c 6f 6e 67 2e 20 28 54 68 69 73 0a 61 6c 6c 6f |long. (This.allo|
00003300 77 73 20 68 65 6c 70 20 6f 6e 20 77 6f 72 64 73 |ws help on words|
00003310 20 77 69 74 68 20 73 79 6d 62 6f 6c 73 20 69 6e | with symbols in|
00003320 2c 20 77 68 69 63 68 20 4d 4a 45 5f 48 45 4c 50 |, which MJE_HELP|
00003330 43 4f 4e 54 45 58 54 20 77 6f 75 6c 64 20 64 69 |CONTEXT would di|
00003340 73 63 61 72 64 20 61 73 0a 69 72 72 65 6c 65 76 |scard as.irrelev|
00003350 61 6e 74 2e 29 0a 0a 49 66 20 69 74 20 73 74 69 |ant.)..If it sti|
00003360 6c 6c 20 68 61 73 6e 27 74 20 77 6f 72 6b 65 64 |ll hasn't worked|
00003370 20 6f 75 74 20 77 68 61 74 20 74 6f 20 73 65 61 | out what to sea|
00003380 72 63 68 20 66 6f 72 2c 20 61 20 6d 69 6e 69 62 |rch for, a minib|
00003390 75 66 66 65 72 20 77 69 6c 6c 20 62 65 20 6f 70 |uffer will be op|
000033a0 65 6e 65 64 0a 66 6f 72 20 79 6f 75 20 74 6f 20 |ened.for you to |
000033b0 74 79 70 65 20 69 6e 20 74 68 65 20 61 70 70 72 |type in the appr|
000033c0 6f 70 72 69 61 74 65 20 74 6f 70 69 63 2e 0a 0a |opriate topic...|
000033d0 0a 0a 47 65 6e 65 72 61 6c 20 66 65 61 74 75 72 |..General featur|
000033e0 65 73 0a 3d 3d 3d 3d 3d 3d 3d 20 3d 3d 3d 3d 3d |es.======= =====|
000033f0 3d 3d 3d 0a 0a 4d 4a 45 5f 49 46 4d 4f 44 45 0a |===..MJE_IFMODE.|
00003400 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 |----------..This|
00003410 20 65 6e 61 62 6c 65 73 20 79 6f 75 20 74 6f 20 | enables you to |
00003420 75 73 65 20 6b 65 79 73 20 66 6f 72 20 64 69 66 |use keys for dif|
00003430 66 65 72 65 6e 74 20 66 75 6e 63 74 69 6f 6e 73 |ferent functions|
00003440 20 69 6e 20 64 69 66 66 65 72 65 6e 74 20 6d 6f | in different mo|
00003450 64 65 73 2c 20 6f 72 0a 6d 6f 72 65 20 6e 6f 72 |des, or.more nor|
00003460 6d 61 6c 6c 79 2c 20 70 72 6f 76 69 64 65 20 74 |mally, provide t|
00003470 68 65 20 73 61 6d 65 20 66 75 6e 63 74 69 6f 6e |he same function|
00003480 20 69 6e 20 73 65 76 65 72 61 6c 20 6d 6f 64 65 | in several mode|
00003490 73 20 77 68 65 72 65 20 6f 6e 65 20 6f 72 20 6d |s where one or m|
000034a0 6f 72 65 0a 6f 66 20 74 68 65 6d 20 64 6f 65 73 |ore.of them does|
000034b0 6e 27 74 20 63 68 65 63 6b 20 74 68 65 20 6d 6f |n't check the mo|
000034c0 64 65 20 62 65 66 6f 72 65 20 70 65 72 66 6f 72 |de before perfor|
000034d0 6d 69 6e 67 20 74 68 65 20 66 75 6e 63 74 69 6f |ming the functio|
000034e0 6e 2e 20 65 67 2e 20 41 20 6d 61 70 70 69 6e 67 |n. eg. A mapping|
000034f0 0a 66 6f 72 20 6e 65 78 74 20 66 75 6e 63 74 69 |.for next functi|
00003500 6f 6e 20 63 6f 75 6c 64 20 62 65 3a 0a 0a 4d 4a |on could be:..MJ|
00003510 45 5f 4e 45 58 54 46 55 4e 43 3a 4d 4a 45 5f 49 |E_NEXTFUNC:MJE_I|
00003520 46 4d 4f 44 45 20 22 37 3a 43 5f 4e 45 58 54 5f |FMODE "7:C_NEXT_|
00003530 46 55 4e 43 54 49 4f 4e 22 0a 0a 54 68 69 73 20 |FUNCTION"..This |
00003540 69 73 20 6e 65 65 64 65 64 20 62 65 63 61 75 73 |is needed becaus|
00003550 65 20 74 68 65 20 43 5f 4e 45 58 54 5f 46 55 4e |e the C_NEXT_FUN|
00003560 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e 64 20 65 78 |CTION command ex|
00003570 65 63 75 74 65 73 20 72 65 67 61 72 64 6c 65 73 |ecutes regardles|
00003580 73 20 6f 66 0a 6d 6f 64 65 20 61 6e 64 20 77 6f |s of.mode and wo|
00003590 75 6c 64 20 74 68 75 73 20 6d 65 73 73 20 74 68 |uld thus mess th|
000035a0 69 6e 67 73 20 75 70 20 69 6e 20 61 6e 79 20 6f |ings up in any o|
000035b0 66 20 74 68 65 20 6f 74 68 65 72 20 6d 6f 64 65 |f the other mode|
000035c0 73 2e 0a 0a 54 68 65 20 73 79 6e 74 61 78 20 69 |s...The syntax i|
000035d0 73 3a 0a 0a 4d 4a 45 5f 49 46 4d 4f 44 45 20 22 |s:..MJE_IFMODE "|
000035e0 4d 6f 64 65 6c 69 73 74 3a 43 6f 6d 6d 61 6e 64 |Modelist:Command|
000035f0 73 22 0a 0a 4d 6f 64 65 6c 69 73 74 20 69 73 20 |s"..Modelist is |
00003600 61 20 63 6f 6d 6d 61 20 73 65 70 61 72 61 74 65 |a comma separate|
00003610 64 20 6c 69 73 74 20 6f 66 20 6d 6f 64 65 20 6e |d list of mode n|
00003620 75 6d 62 65 72 73 20 66 6f 72 20 77 68 69 63 68 |umbers for which|
00003630 20 74 68 65 20 63 6f 6d 6d 61 6e 64 73 20 61 72 | the commands ar|
00003640 65 0a 74 6f 20 65 78 65 63 75 74 65 20 69 6e 2e |e.to execute in.|
00003650 20 59 6f 75 20 63 61 6e 20 61 6c 73 6f 20 75 73 | You can also us|
00003660 65 20 61 20 68 79 70 68 65 6e 20 66 6f 72 20 72 |e a hyphen for r|
00003670 61 6e 67 65 73 2e 20 65 67 2e 20 22 31 2c 33 2d |anges. eg. "1,3-|
00003680 35 2c 37 3a 2e 2e 2e 22 20 4e 6f 0a 6f 74 68 65 |5,7:..." No.othe|
00003690 72 20 63 68 61 72 61 63 74 65 72 73 2c 20 6e 6f |r characters, no|
000036a0 74 20 65 76 65 6e 20 73 70 61 63 65 73 20 61 72 |t even spaces ar|
000036b0 65 20 61 6c 6c 6f 77 65 64 20 62 65 66 6f 72 65 |e allowed before|
000036c0 20 74 68 65 20 63 6f 6c 6f 6e 2c 20 61 70 61 72 | the colon, apar|
000036d0 74 20 66 72 6f 6d 0a 74 68 65 20 6f 70 74 69 6f |t from.the optio|
000036e0 6e 20 6f 66 20 61 20 21 20 69 6d 6d 65 64 69 61 |n of a ! immedia|
000036f0 74 65 6c 79 20 62 65 66 6f 72 65 20 69 74 2e 20 |tely before it. |
00003700 54 68 69 73 20 68 61 73 20 74 68 65 20 65 66 66 |This has the eff|
00003710 65 63 74 20 6f 66 20 6e 65 67 61 74 69 6e 67 0a |ect of negating.|
00003720 74 68 65 20 63 6f 6e 64 69 74 69 6f 6e 2e 20 65 |the condition. e|
00003730 67 2e 20 22 30 2c 32 2c 36 2c 38 2d 32 35 35 21 |g. "0,2,6,8-255!|
00003740 3a 22 20 69 73 20 74 68 65 20 73 61 6d 65 20 61 |:" is the same a|
00003750 73 20 74 68 65 20 70 72 65 76 69 6f 75 73 20 65 |s the previous e|
00003760 78 61 6d 70 6c 65 2e 0a 0a 43 6f 6d 6d 61 6e 64 |xample...Command|
00003770 73 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 63 |s is a list of c|
00003780 6f 6d 6d 61 6e 64 73 20 69 6e 20 74 68 65 20 6e |ommands in the n|
00003790 6f 72 6d 61 6c 20 77 61 79 2e 0a 0a 0a 4d 4a 45 |ormal way....MJE|
000037a0 5f 41 4c 54 45 52 53 45 4c 0a 2d 2d 2d 2d 2d 2d |_ALTERSEL.------|
000037b0 2d 2d 2d 2d 2d 2d 0a 0a 54 68 69 73 20 77 6f 72 |------..This wor|
000037c0 6b 73 20 69 6e 20 74 68 65 20 73 61 6d 65 20 77 |ks in the same w|
000037d0 61 79 20 61 73 20 45 64 69 74 27 73 20 46 36 2e |ay as Edit's F6.|
000037e0 20 49 66 20 74 68 65 72 65 20 69 73 20 6e 6f 20 | If there is no |
000037f0 73 65 6c 65 63 74 69 6f 6e 2c 20 74 68 65 0a 63 |selection, the.c|
00003800 68 61 72 61 63 74 65 72 20 61 66 74 65 72 20 74 |haracter after t|
00003810 68 65 20 63 75 72 73 6f 72 20 69 73 20 73 65 6c |he cursor is sel|
00003820 65 63 74 65 64 2c 20 65 6c 73 65 20 74 68 65 20 |ected, else the |
00003830 6f 70 65 72 61 74 69 6f 6e 20 69 73 20 65 71 75 |operation is equ|
00003840 69 76 61 6c 65 6e 74 20 74 6f 0a 63 6c 69 63 6b |ivalent to.click|
00003850 69 6e 67 20 61 64 6a 75 73 74 20 77 69 74 68 20 |ing adjust with |
00003860 74 68 65 20 6d 6f 75 73 65 2e 20 54 68 69 73 20 |the mouse. This |
00003870 69 73 20 76 65 72 79 20 68 61 6e 64 79 20 69 66 |is very handy if|
00003880 20 79 6f 75 20 73 65 6c 65 63 74 20 73 6f 6d 65 | you select some|
00003890 74 68 69 6e 67 0a 77 69 74 68 20 74 68 65 20 6b |thing.with the k|
000038a0 65 79 62 6f 61 72 64 20 62 75 74 20 67 65 74 20 |eyboard but get |
000038b0 69 74 20 73 6c 69 67 68 74 6c 79 20 77 72 6f 6e |it slightly wron|
000038c0 67 20 2d 20 69 74 20 73 61 76 65 73 20 79 6f 75 |g - it saves you|
000038d0 20 72 65 2d 73 65 6c 65 63 74 69 6e 67 20 74 68 | re-selecting th|
000038e0 65 0a 77 68 6f 6c 65 20 6c 6f 74 2e 20 41 6e 6f |e.whole lot. Ano|
000038f0 74 68 65 72 20 65 73 73 65 6e 74 69 61 6c 20 75 |ther essential u|
00003900 73 65 20 69 73 20 74 6f 20 73 65 6c 65 63 74 20 |se is to select |
00003910 61 20 6c 69 6e 65 2f 73 65 76 65 72 61 6c 20 6c |a line/several l|
00003920 69 6e 65 73 20 77 69 74 68 20 74 68 65 0a 66 6f |ines with the.fo|
00003930 6c 6c 6f 77 69 6e 67 20 63 6f 6d 6d 61 6e 64 20 |llowing command |
00003940 73 65 71 75 65 6e 63 65 3a 0a 0a 43 4c 45 46 54 |sequence:..CLEFT|
00003950 3a 4d 4a 45 5f 41 4c 54 45 52 53 45 4c 3a 43 52 |:MJE_ALTERSEL:CR|
00003960 49 47 48 54 3a 44 4f 57 4e 3a 43 4c 45 46 54 3a |IGHT:DOWN:CLEFT:|
00003970 4d 4a 45 5f 41 4c 54 45 52 53 45 4c 0a 0a 0a 0a |MJE_ALTERSEL....|
00003980 43 6f 70 79 72 69 67 68 74 0a 3d 3d 3d 3d 3d 3d |Copyright.======|
00003990 3d 3d 3d 0a 0a 54 68 65 20 63 6f 6e 64 69 74 69 |===..The conditi|
000039a0 6f 6e 73 20 6f 66 20 63 6f 70 79 69 6e 67 20 74 |ons of copying t|
000039b0 68 69 73 20 70 72 6f 67 72 61 6d 20 61 6e 64 20 |his program and |
000039c0 69 74 73 20 61 73 73 6f 63 69 61 74 65 64 20 64 |its associated d|
000039d0 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 20 61 72 65 |ocumentation are|
000039e0 0a 74 68 65 20 73 61 6d 65 20 61 73 20 74 68 6f |.the same as tho|
000039f0 73 65 20 6f 66 20 74 68 65 20 6d 61 69 6e 20 5a |se of the main Z|
00003a00 61 70 20 61 70 70 6c 69 63 61 74 69 6f 6e 2c 20 |ap application, |
00003a10 65 78 63 65 70 74 20 79 6f 75 20 64 6f 20 6e 6f |except you do no|
00003a20 74 20 6e 65 65 64 20 6d 79 0a 70 65 72 6d 69 73 |t need my.permis|
00003a30 69 6f 6e 20 74 6f 20 63 6f 70 79 20 69 74 20 69 |ion to copy it i|
00003a40 66 20 79 6f 75 20 68 61 76 65 20 44 6f 6d 69 6e |f you have Domin|
00003a50 69 63 27 73 2e 0a 0a 54 68 69 73 20 73 6f 66 74 |ic's...This soft|
00003a60 77 61 72 65 20 69 73 20 70 72 6f 76 69 64 65 64 |ware is provided|
00003a70 20 61 73 20 69 73 20 77 69 74 68 20 6e 6f 20 77 | as is with no w|
00003a80 61 72 72 61 6e 74 79 20 61 73 20 74 6f 20 69 74 |arranty as to it|
00003a90 73 20 73 75 69 74 61 62 69 6c 69 74 79 20 6f 72 |s suitability or|
00003aa0 0a 6f 74 68 65 72 77 69 73 65 20 66 6f 72 20 61 |.otherwise for a|
00003ab0 6e 79 20 70 61 72 74 69 63 75 6c 61 72 20 74 61 |ny particular ta|
00003ac0 73 6b 2e 20 49 66 20 69 74 20 64 6f 65 73 20 61 |sk. If it does a|
00003ad0 6e 79 74 68 69 6e 67 20 6e 61 73 74 79 20 74 68 |nything nasty th|
00003ae0 65 6e 20 49 20 77 61 6e 74 20 74 6f 0a 6b 6e 6f |en I want to.kno|
00003af0 77 20 73 6f 20 49 20 63 61 6e 20 66 69 78 20 69 |w so I can fix i|
00003b00 74 2c 20 62 75 74 20 49 27 6d 20 6e 6f 74 20 74 |t, but I'm not t|
00003b10 61 6b 69 6e 67 20 61 6e 79 20 72 65 73 70 6f 6e |aking any respon|
00003b20 73 69 62 69 6c 69 74 79 2e 20 28 42 65 73 69 64 |sibility. (Besid|
00003b30 65 73 2c 0a 74 68 65 72 65 27 73 20 6e 6f 20 70 |es,.there's no p|
00003b40 6f 69 6e 74 20 69 6e 20 73 75 65 69 6e 67 20 6d |oint in sueing m|
00003b50 65 20 73 69 6e 63 65 20 49 27 76 65 20 67 6f 74 |e since I've got|
00003b60 20 6e 6f 20 6d 6f 6e 65 79 2e 29 0a 0a 4e 6f 6e | no money.)..Non|
00003b70 2d 72 65 6c 65 61 73 65 20 76 65 72 73 69 6f 6e |-release version|
00003b80 73 20 6f 66 20 74 68 69 73 20 6d 6f 64 75 6c 65 |s of this module|
00003b90 20 28 69 64 65 6e 74 69 66 79 20 74 68 65 6d 73 | (identify thems|
00003ba0 65 6c 76 65 73 20 61 73 20 74 65 73 74 20 76 65 |elves as test ve|
00003bb0 72 73 69 6f 6e 73 20 6f 6e 0a 2a 48 65 6c 70 20 |rsions on.*Help |
00003bc0 5a 61 70 4d 4a 45 29 20 61 72 65 20 2a 4e 4f 54 |ZapMJE) are *NOT|
00003bd0 2a 20 64 69 73 74 72 69 62 75 74 61 62 6c 65 20 |* distributable |
00003be0 77 69 74 68 6f 75 74 20 6d 79 20 65 78 70 72 65 |without my expre|
00003bf0 73 73 20 70 65 72 6d 69 73 73 69 6f 6e 2e 20 54 |ss permission. T|
00003c00 68 65 79 20 61 72 65 0a 61 6c 73 6f 20 6d 6f 72 |hey are.also mor|
00003c10 65 20 6c 69 6b 65 6c 79 20 74 6f 20 66 61 6c 6c |e likely to fall|
00003c20 20 6f 76 65 72 2e 20 3b 2d 29 0a 0a 50 6c 65 61 | over. ;-)..Plea|
00003c30 73 65 20 6e 6f 74 65 20 74 68 61 74 20 49 20 72 |se note that I r|
00003c40 65 73 65 72 76 65 20 74 68 65 20 72 69 67 68 74 |eserve the right|
00003c50 20 74 6f 20 6d 61 6b 65 20 61 6c 74 65 72 61 74 | to make alterat|
00003c60 69 6f 6e 73 20 74 6f 20 74 68 69 73 20 70 72 6f |ions to this pro|
00003c70 67 72 61 6d 2c 20 69 74 73 0a 6f 70 65 72 61 74 |gram, its.operat|
00003c80 69 6f 6e 2c 20 64 6f 63 75 6d 65 6e 74 61 74 69 |ion, documentati|
00003c90 6f 6e 2c 20 61 6e 64 2f 6f 72 20 63 6f 6e 64 69 |on, and/or condi|
00003ca0 74 69 6f 6e 73 20 6f 66 20 75 73 65 20 77 69 74 |tions of use wit|
00003cb0 68 6f 75 74 20 6e 6f 74 69 63 65 20 69 6e 20 61 |hout notice in a|
00003cc0 6e 79 20 77 61 79 0a 49 20 73 65 65 20 66 69 74 |ny way.I see fit|
00003cd0 2e 20 48 6f 70 65 66 75 6c 6c 79 20 69 74 20 77 |. Hopefully it w|
00003ce0 69 6c 6c 20 62 65 20 61 6e 20 69 6d 70 72 6f 76 |ill be an improv|
00003cf0 65 6d 65 6e 74 2e 0a 0a 0a 41 63 6b 6e 6f 77 6c |ement....Acknowl|
00003d00 65 64 67 65 6d 65 6e 74 73 0a 3d 3d 3d 3d 3d 3d |edgements.======|
00003d10 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 54 68 61 6e |==========..Than|
00003d20 6b 73 20 74 6f 20 44 6f 6d 69 6e 69 63 20 66 6f |ks to Dominic fo|
00003d30 72 20 77 72 69 74 69 6e 67 20 5a 61 70 20 61 6e |r writing Zap an|
00003d40 64 20 6e 6f 74 20 65 76 65 6e 20 63 68 61 72 67 |d not even charg|
00003d50 69 6e 67 20 66 6f 72 20 69 74 21 20 28 54 68 6f |ing for it! (Tho|
00003d60 75 67 68 20 68 65 27 73 0a 70 61 72 74 6c 79 20 |ugh he's.partly |
00003d70 72 65 73 70 6f 6e 73 69 62 6c 65 20 66 6f 72 20 |responsible for |
00003d80 61 20 72 61 74 68 65 72 20 6c 61 72 67 65 20 61 |a rather large a|
00003d90 6d 6f 75 6e 74 20 6f 66 20 64 61 6d 61 67 65 20 |mount of damage |
00003da0 74 6f 20 6d 79 20 27 70 68 6f 6e 65 20 62 69 6c |to my 'phone bil|
00003db0 6c 2e 0a 3a 2d 28 29 0a 0a 54 68 61 6e 6b 73 20 |l..:-()..Thanks |
00003dc0 74 6f 20 42 72 69 61 6e 20 53 63 61 74 74 65 72 |to Brian Scatter|
00003dd0 67 6f 6f 64 20 66 6f 72 20 77 72 69 74 69 6e 67 |good for writing|
00003de0 20 68 69 73 20 43 6d 6f 64 65 20 77 68 69 63 68 | his Cmode which|
00003df0 20 74 68 69 73 20 6f 72 69 67 69 6e 61 6c 6c 79 | this originally|
00003e00 20 63 61 6d 65 0a 66 72 6f 6d 20 2d 20 69 74 20 | came.from - it |
00003e10 6d 61 64 65 20 69 6e 69 74 69 61 6c 20 64 65 76 |made initial dev|
00003e20 65 6c 6f 70 6d 65 6e 74 20 61 20 6c 6f 74 20 65 |elopment a lot e|
00003e30 61 73 69 65 72 20 28 61 6c 74 68 6f 75 67 68 20 |asier (although |
00003e40 49 20 64 69 64 20 68 61 76 65 20 74 6f 20 68 61 |I did have to ha|
00003e50 63 6b 0a 69 74 20 66 69 72 73 74 20 3a 2d 5d 29 |ck.it first :-])|
00003e60 2e 20 54 68 65 72 65 27 73 20 65 76 65 6e 20 73 |. There's even s|
00003e70 6f 6d 65 20 6f 72 69 67 69 6e 61 6c 20 28 73 6c |ome original (sl|
00003e80 69 67 68 74 6c 79 20 6d 6f 64 69 66 69 65 64 29 |ightly modified)|
00003e90 20 63 6f 64 65 20 6c 65 66 74 21 0a 28 4d 6f 73 | code left!.(Mos|
00003ea0 74 20 6f 66 20 74 68 65 20 73 74 75 66 66 20 77 |t of the stuff w|
00003eb0 68 69 63 68 20 69 73 20 43 20 6d 6f 64 65 20 6f |hich is C mode o|
00003ec0 6e 6c 79 2e 29 20 54 68 69 73 20 77 69 6c 6c 20 |nly.) This will |
00003ed0 68 61 76 65 20 74 6f 20 62 65 20 72 65 70 6c 61 |have to be repla|
00003ee0 63 65 64 20 69 6e 0a 74 68 65 20 63 6f 75 72 73 |ced in.the cours|
00003ef0 65 20 6f 66 20 6d 61 6b 69 6e 67 20 69 74 20 77 |e of making it w|
00003f00 6f 72 6b 20 6f 6e 20 61 6c 6c 20 6d 6f 64 65 73 |ork on all modes|
00003f10 20 73 6f 6f 6e 65 72 20 6f 72 20 6c 61 74 65 72 | sooner or later|
00003f20 2e 20 3a 2d 28 0a 0a 54 68 61 6e 6b 73 20 74 6f |. :-(..Thanks to|
00003f30 20 4d 65 72 63 75 72 79 20 66 6f 72 20 6e 6f 74 | Mercury for not|
00003f40 20 63 68 61 72 67 69 6e 67 20 71 75 69 74 65 20 | charging quite |
00003f50 61 73 20 6d 75 63 68 20 61 73 20 42 54 2e 20 28 |as much as BT. (|
00003f60 49 74 20 6d 65 61 6e 73 20 49 27 6d 20 6a 75 73 |It means I'm jus|
00003f70 74 0a 62 72 6f 6b 65 20 72 61 74 68 65 72 20 74 |t.broke rather t|
00003f80 68 61 6e 20 63 6f 6d 70 6c 65 74 65 6c 79 20 62 |han completely b|
00003f90 61 6e 6b 72 75 70 74 2e 20 3a 2d 5d 20 20 43 6f |ankrupt. :-] Co|
00003fa0 72 72 65 63 74 69 6f 6e 3a 20 49 74 20 6d 65 61 |rrection: It mea|
00003fb0 6e 73 20 69 74 20 74 6f 6f 6b 20 6d 65 0a 76 65 |ns it took me.ve|
00003fc0 72 79 20 73 6c 69 67 68 74 6c 79 20 6c 6f 6e 67 |ry slightly long|
00003fd0 65 72 20 74 6f 20 62 65 63 6f 6d 65 20 63 6f 6d |er to become com|
00003fe0 70 6c 65 74 65 6c 79 20 62 61 6e 6b 72 75 70 74 |pletely bankrupt|
00003ff0 2e 29 0a 0a 0a 43 6f 6e 74 61 63 74 69 6e 67 0a |.)...Contacting.|
00004000 3d 3d 3d 3d 3d 3d 3d 3d 3d 3d 0a 0a 49 20 63 61 |==========..I ca|
00004010 6e 20 62 65 20 63 6f 6e 74 61 63 74 65 64 20 74 |n be contacted t|
00004020 68 72 6f 75 67 68 20 65 6d 61 69 6c 20 74 6f 20 |hrough email to |
00004030 6d 6a 65 40 73 6f 74 6f 6e 2e 61 63 2e 75 6b 20 |mje@soton.ac.uk |
00004040 61 6c 6c 20 79 65 61 72 20 72 6f 75 6e 64 20 28 |all year round (|
00004050 66 61 73 74 65 72 0a 72 65 73 70 6f 6e 73 65 20 |faster.response |
00004060 74 69 6d 65 20 64 75 72 69 6e 67 20 74 65 72 6d |time during term|
00004070 29 2e 20 41 6c 74 65 72 6e 61 74 69 76 65 6c 79 |). Alternatively|
00004080 2c 20 73 6e 61 69 6c 20 74 6f 3a 0a 0a 31 20 4d |, snail to:..1 M|
00004090 61 6c 76 65 72 6e 20 52 6f 61 64 0a 41 63 6f 63 |alvern Road.Acoc|
000040a0 6b 73 20 47 72 65 65 6e 0a 42 69 72 6d 69 6e 67 |ks Green.Birming|
000040b0 68 61 6d 0a 42 32 37 20 36 45 47 0a 0a 50 6c 65 |ham.B27 6EG..Ple|
000040c0 61 73 65 20 6c 65 74 20 6d 65 20 6b 6e 6f 77 20 |ase let me know |
000040d0 6f 66 20 61 6e 79 20 62 75 67 73 20 6f 72 20 75 |of any bugs or u|
000040e0 6e 64 6f 63 75 6d 65 6e 74 65 64 20 66 65 61 74 |ndocumented feat|
000040f0 75 72 65 73 20 69 66 20 79 6f 75 20 65 76 65 72 |ures if you ever|
00004100 20 66 69 6e 64 20 61 6e 79 0a 28 61 6e 64 20 74 | find any.(and t|
00004110 68 65 79 20 61 72 65 6e 27 74 20 6c 69 73 74 65 |hey aren't liste|
00004120 64 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20 |d at the end of |
00004130 74 68 65 20 66 69 6c 65 20 2d 20 74 68 61 74 27 |the file - that'|
00004140 73 20 74 68 65 20 68 61 72 64 20 62 69 74 21 29 |s the hard bit!)|
00004150 2e 20 41 6c 73 6f 2c 0a 69 64 65 61 73 20 66 6f |. Also,.ideas fo|
00004160 72 20 69 6d 70 72 6f 76 65 6d 65 6e 74 20 61 72 |r improvement ar|
00004170 65 20 77 65 6c 63 6f 6d 65 2e 20 41 20 66 65 77 |e welcome. A few|
00004180 20 6f 66 20 6d 79 20 63 75 72 72 65 6e 74 20 69 | of my current i|
00004190 64 65 61 73 20 61 72 65 3a 0a 0a 20 20 8f 20 41 |deas are:.. . A|
000041a0 20 6b 65 79 20 74 6f 20 67 65 6e 65 72 61 74 65 | key to generate|
000041b0 20 68 65 61 64 65 72 20 66 69 6c 65 73 20 66 72 | header files fr|
000041c0 6f 6d 20 73 6f 75 72 63 65 0a 20 20 8f 20 41 20 |om source. . A |
000041d0 72 65 61 6c 6c 79 20 63 6f 6f 6c 20 6e 61 74 69 |really cool nati|
000041e0 76 65 20 68 65 6c 70 20 73 79 73 74 65 6d 20 6f |ve help system o|
000041f0 66 20 77 68 69 63 68 20 74 68 65 20 64 65 74 61 |f which the deta|
00004200 69 6c 73 20 61 72 65 20 73 65 63 72 65 74 20 61 |ils are secret a|
00004210 74 20 74 68 65 0a 20 20 20 20 6d 6f 6d 65 6e 74 |t the. moment|
00004220 2e 2e 2e 20 3b 2d 29 20 49 66 20 79 6f 75 27 76 |... ;-) If you'v|
00004230 65 20 67 6f 74 20 61 6e 79 20 69 64 65 61 73 20 |e got any ideas |
00004240 66 6f 72 20 69 74 20 68 6f 77 65 76 65 72 2c 20 |for it however, |
00004250 74 68 65 6e 20 6e 6f 77 27 73 20 74 68 65 20 74 |then now's the t|
00004260 69 6d 65 0a 20 20 20 20 74 6f 20 6c 65 74 20 6d |ime. to let m|
00004270 65 20 68 61 76 65 20 74 68 65 6d 0a 20 20 8f 20 |e have them. . |
00004280 41 20 70 72 65 74 74 79 20 6e 69 66 74 79 20 73 |A pretty nifty s|
00004290 65 6c 65 63 74 69 6f 6e 20 6d 65 63 68 61 6e 69 |election mechani|
000042a0 73 6d 20 66 6f 72 20 43 20 26 20 50 61 73 63 61 |sm for C & Pasca|
000042b0 6c 20 28 70 6f 73 73 69 62 6c 79 20 65 76 65 6e |l (possibly even|
000042c0 0a 20 20 20 20 61 73 73 65 6d 62 6c 65 72 29 0a |. assembler).|
000042d0 20 20 8f 20 43 6f 6c 6f 75 72 20 72 65 64 72 61 | . Colour redra|
000042e0 77 20 66 6f 72 20 50 61 73 63 61 6c 0a 20 20 8f |w for Pascal. .|
000042f0 20 42 72 61 63 6b 65 74 20 6d 61 74 63 68 69 6e | Bracket matchin|
00004300 67 20 63 6f 72 72 65 63 74 6c 79 20 6f 6e 20 61 |g correctly on a|
00004310 6c 6c 20 6d 6f 64 65 73 0a 20 20 8f 20 52 65 6d |ll modes. . Rem|
00004320 6f 76 65 20 61 6e 79 20 66 65 61 74 75 72 65 73 |ove any features|
00004330 20 77 68 69 63 68 20 61 72 65 6e 27 74 20 6c 69 | which aren't li|
00004340 73 74 65 64 20 69 6e 20 74 68 69 73 20 68 65 6c |sted in this hel|
00004350 70 20 66 69 6c 65 0a 0a 49 66 20 61 6e 79 62 6f |p file..If anybo|
00004360 64 79 20 77 61 6e 74 73 20 74 6f 20 68 65 6c 70 |dy wants to help|
00004370 20 6d 65 20 70 61 79 20 6f 66 66 20 73 6f 6d 65 | me pay off some|
00004380 20 6f 66 20 74 68 65 20 27 70 68 6f 6e 65 20 62 | of the 'phone b|
00004390 69 6c 6c 20 74 68 69 73 20 6d 6f 64 75 6c 65 20 |ill this module |
000043a0 68 61 73 0a 69 6e 63 75 72 72 65 64 2c 20 74 68 |has.incurred, th|
000043b0 65 6e 20 61 6c 6c 20 64 6f 6e 61 74 69 6f 6e 73 |en all donations|
000043c0 20 61 72 65 20 67 72 61 74 65 66 75 6c 6c 79 20 | are gratefully |
000043d0 61 63 63 65 70 74 65 64 20 61 74 20 74 68 65 20 |accepted at the |
000043e0 61 64 64 72 65 73 73 20 61 62 6f 76 65 2e 0a 28 |address above..(|
000043f0 57 65 6c 6c 20 79 6f 75 20 63 61 6e 27 74 20 62 |Well you can't b|
00004400 6c 61 6d 65 20 6d 65 20 66 6f 72 20 74 72 79 69 |lame me for tryi|
00004410 6e 67 2c 20 63 61 6e 20 79 6f 75 21 29 0a 0a 0a |ng, can you!)...|
00004420 4b 6e 6f 77 6e 20 6d 69 73 2d 66 65 61 74 75 72 |Known mis-featur|
00004430 65 73 0a 3d 3d 3d 3d 3d 20 3d 3d 3d 20 3d 3d 3d |es.===== === ===|
00004440 3d 3d 3d 3d 3d 0a 0a 28 54 68 65 73 65 20 61 72 |=====..(These ar|
00004450 65 20 6a 75 73 74 20 74 68 65 20 69 6d 70 6f 72 |e just the impor|
00004460 74 61 6e 74 20 6f 6e 65 73 20 3a 2d 28 29 0a 0a |tant ones :-()..|
00004470 41 73 73 65 6d 62 6c 65 72 3a 0a 0a 20 20 8f 20 |Assembler:.. . |
00004480 41 73 73 65 6d 62 6c 69 6e 67 20 77 69 74 68 20 |Assembling with |
00004490 6e 6f 20 6d 61 6b 65 20 66 69 6c 65 20 64 6f 65 |no make file doe|
000044a0 73 6e 27 74 20 77 6f 72 6b 0a 20 20 8f 20 46 75 |sn't work. . Fu|
000044b0 6e 63 74 69 6f 6e 20 66 69 6e 64 69 6e 67 20 63 |nction finding c|
000044c0 68 65 61 74 73 20 28 75 73 65 73 20 73 65 61 72 |heats (uses sear|
000044d0 63 68 29 0a 0a 43 3a 0a 0a 20 20 8f 20 54 68 65 |ch)..C:.. . The|
000044e0 20 73 79 6e 74 61 78 20 63 6f 6c 6f 75 72 69 6e | syntax colourin|
000044f0 67 20 69 73 20 73 6c 6f 77 20 77 69 74 68 20 6c |g is slow with l|
00004500 61 72 67 65 20 66 69 6c 65 73 20 61 6e 64 20 6d |arge files and m|
00004510 75 6c 74 69 70 6c 65 20 76 69 65 77 73 20 6f 66 |ultiple views of|
00004520 20 74 68 65 0a 20 20 20 20 73 61 6d 65 20 66 69 | the. same fi|
00004530 6c 65 2c 20 62 75 74 20 74 68 65 6e 20 77 68 65 |le, but then whe|
00004540 6e 20 63 6f 6e 73 74 72 75 63 74 73 20 73 75 63 |n constructs suc|
00004550 68 20 61 73 3a 0a 20 20 20 20 23 69 6e 63 5c 0a |h as:. #inc\.|
00004560 20 20 20 20 6c 75 64 65 20 2f 2a 20 2a 5c 0a 20 | lude /* *\. |
00004570 20 20 20 2f 20 3c 73 74 64 5c 0a 20 20 20 20 69 | / <std\. i|
00004580 6f 2e 68 3e 0a 20 20 20 20 61 72 65 20 76 61 6c |o.h>. are val|
00004590 69 64 20 28 74 72 79 20 69 74 2c 20 69 74 20 77 |id (try it, it w|
000045a0 6f 72 6b 73 21 29 2c 20 69 74 73 20 68 61 72 64 |orks!), its hard|
000045b0 6c 79 20 73 75 72 70 72 69 73 69 6e 67 2e 20 48 |ly surprising. H|
000045c0 6f 77 65 76 65 72 2c 20 74 68 69 73 20 77 69 6c |owever, this wil|
000045d0 6c 0a 20 20 20 20 62 65 20 69 6d 70 72 6f 76 65 |l. be improve|
000045e0 64 20 69 6e 20 6c 61 74 65 72 20 76 65 72 73 69 |d in later versi|
000045f0 6f 6e 73 2e 0a 20 20 8f 20 50 72 6f 62 6c 65 6d |ons.. . Problem|
00004600 73 20 77 69 74 68 20 66 75 6e 63 74 69 6f 6e 20 |s with function |
00004610 66 69 6e 64 69 6e 67 3a 0a 20 20 20 20 31 29 20 |finding:. 1) |
00004620 50 72 65 70 72 6f 63 65 73 73 6f 72 20 23 20 6e |Preprocessor # n|
00004630 6f 74 20 61 74 20 73 74 61 72 74 20 6f 66 20 6c |ot at start of l|
00004640 69 6e 65 20 6e 6f 74 20 72 65 63 6f 67 6e 69 73 |ine not recognis|
00004650 65 64 0a 20 20 20 20 32 29 20 66 6f 6f 20 28 29 |ed. 2) foo ()|
00004660 20 69 73 6e 27 74 20 66 6f 75 6e 64 0a 20 20 20 | isn't found. |
00004670 20 33 29 20 49 74 20 64 6f 65 73 6e 27 74 20 63 | 3) It doesn't c|
00004680 6f 70 65 20 77 69 74 68 20 5c 20 6f 75 74 73 69 |ope with \ outsi|
00004690 64 65 20 6f 66 20 70 72 65 70 72 6f 63 65 73 73 |de of preprocess|
000046a0 6f 72 0a 20 20 20 20 54 68 65 73 65 20 27 62 75 |or. These 'bu|
000046b0 67 73 27 20 61 72 65 20 64 75 65 20 74 6f 20 6d |gs' are due to m|
000046c0 65 20 6e 6f 74 20 6b 6e 6f 77 69 6e 67 20 70 72 |e not knowing pr|
000046d0 65 63 69 73 65 6c 79 20 68 6f 77 20 74 68 65 20 |ecisely how the |
000046e0 43 20 73 79 6e 74 61 78 20 77 6f 72 6b 65 64 0a |C syntax worked.|
000046f0 20 20 20 20 77 68 65 6e 20 49 20 77 72 6f 74 65 | when I wrote|
00004700 20 69 74 2e 20 55 6e 66 6f 72 74 75 6e 61 74 65 | it. Unfortunate|
00004710 6c 79 2c 20 74 68 65 20 64 65 61 64 6c 69 6e 65 |ly, the deadline|
00004720 20 68 61 73 20 62 65 65 6e 20 76 65 72 79 20 74 | has been very t|
00004730 69 67 68 74 20 26 20 69 74 27 73 0a 20 20 20 20 |ight & it's. |
00004740 62 65 65 6e 20 63 6c 6f 73 65 20 74 6f 20 67 65 |been close to ge|
00004750 74 20 74 68 65 20 63 6f 6c 6f 75 72 69 6e 67 20 |t the colouring |
00004760 77 6f 72 6b 2c 20 6c 65 74 20 61 6c 6f 6e 65 20 |work, let alone |
00004770 74 68 65 20 66 75 6e 63 74 69 6f 6e 20 66 69 6e |the function fin|
00004780 64 69 6e 67 0a 20 20 8f 20 54 68 65 72 65 20 61 |ding. . There a|
00004790 72 65 20 70 72 6f 62 6c 65 6d 73 20 77 69 74 68 |re problems with|
000047a0 20 74 68 65 20 63 6f 6c 6f 75 72 69 6e 67 20 6f | the colouring o|
000047b0 6e 20 63 6f 6e 73 74 72 75 63 74 73 20 73 75 63 |n constructs suc|
000047c0 68 20 61 73 3a 0a 20 20 20 20 31 29 20 5f 6b 65 |h as:. 1) _ke|
000047d0 72 6e 65 6c 5f 6f 73 65 72 72 6f 72 20 28 66 6f |rnel_oserror (fo|
000047e0 6f 29 20 28 29 3b 0a 20 20 20 20 32 29 20 77 69 |o) ();. 2) wi|
000047f0 62 62 6c 65 0a 20 20 20 20 20 20 20 23 64 65 66 |bble. #def|
00004800 69 6e 65 20 77 6f 62 62 6c 65 0a 20 20 20 20 20 |ine wobble. |
00004810 20 20 28 76 6f 69 64 29 0a 0a 50 61 73 63 61 6c | (void)..Pascal|
00004820 3a 0a 0a 20 20 8f 20 46 75 6e 63 74 69 6f 6e 20 |:.. . Function |
00004830 66 69 6e 64 69 6e 67 20 63 68 65 61 74 73 20 28 |finding cheats (|
00004840 6c 69 6b 65 20 61 73 73 65 6d 62 6c 65 72 29 0a |like assembler).|
00004850 0a 4d 69 73 63 65 6c 6c 61 6e 65 6f 75 73 3a 0a |.Miscellaneous:.|
00004860 0a 20 20 8f 20 54 68 69 73 20 69 73 20 5a 61 70 |. . This is Zap|
00004870 27 73 20 66 61 75 6c 74 2c 20 62 75 74 20 73 77 |'s fault, but sw|
00004880 61 70 20 74 6f 20 68 65 61 64 65 72 20 64 6f 65 |ap to header doe|
00004890 73 6e 27 74 20 6c 6f 61 64 20 66 69 6c 65 20 69 |sn't load file i|
000048a0 6e 74 6f 20 63 6f 72 72 65 63 74 0a 20 20 20 20 |nto correct. |
000048b0 6d 6f 64 65 |mode|
000048b4 
.