The Datafile PD-CD 5/DATAFILE_PDCD5.iso/utilities/z/zap/!Zap/Docs/HelpData

Text File | 1995-08-02 | 29.2 KB | 1,071 lines

| Zap 'HelpData' file. This file contains:
|
| 1. Documentation on all Zap commands stored in the Zap and ZapBasic modules.
| 2. Help text for Zap interactive help.
|
| The data in this file is used by the 'Help' command (^H) and the !Help
| Application.
|
| The file format consists of paragraphs of the form:
|
| <label> [<comment>]
| <paragraph of help text>
|
| where label is one of:
|
|   <command>        help text for command <command>
|   window.<name>    help for leaf window with template called <name>
|   mode_<name>        help for a window in mode called <name>
|   zap.icon        help for Zap's main iconbar icon.
|
| Please keep the commands in alphabetical order to aid clarity.
| NB Only the first 4 lines get displayed by the !Help application.
|    Use ^H for more details.

| Main icon

zap.icon
This is the Zap application.
Zap is a text editor.
Click SELECT to open a new text file.
Drag a file onto this icon to load it.

| Window in mode 'n'

mode_text
Text editing mode.
Click SELECT to position the cursor.
Click ADJUST to re-enable the cursor at its current position.
Drag SELECT to set a selection or ADJUST to alter a selection.
Double click to select a word.
Treble click to select a line.
Quadruple click to select a paragraph.
Quintruple click to select the whole text.

mode_byte
Byte editing mode.
Toggle hex entry mode via sF3 and insert/overwrite mode via the Insert key.
In hex entry mode keys 0-9,A-F,a-f enter hex bytes.
While not in hex entry mode letters enter their Ascii values.

mode_word
Word (32 bit) editing mode.
Toggle hex entry mode via sF3 and insert/overwrite mode via the Insert key.
In hex entry mode keys 0-9,A-F,a-f enter hex words.
DELETE deletes a whole word.
Use undo (F8 or Shift <-|) to remove the last digit typed.

mode_ascii
ASCII editing mode.
Type characters to insert them.
Same as text mode except there is no return character.

mode_code
Assembler instruction examining mode.
Press RIGHT arrow to follow a branch and LEFT arrow to go back.
Press RIGHT arrow or cI to indirect through the current address.
Press RETURN to edit the current instruction.
The instruction is assembled by BASIC so you can use any basic FNs.
You can also use EQUD and EQUS but only the first 4 bytes will count.

mode_basic
Tokenised BASIC editing mode.
Press SHIFT-F8 to renumber the program.
Press SHIFT-CTRL-F or SHIFT-CTRL-U to run the program.

mode_bastxt
Detokenised BASIC editing mode.
This is the same as the text mode except the program is tokenised on saving.
Line numbers are inserted automatically in 1's.
(So error at line 10 means the 10th line in the program).

mode_cmode
Bryan Scattergood's C mode.
Bracket matching can be configured from the mode menu.
See Bryan's help text for more details.

mode_c
Martin Ebourne's colour C mode.
Colours can be configures from the display menu.
Press scC to compile.
See Martin's help text for more details.

mode_assembler
Martin Ebourne's colour Assembler mode.
Designed for Acorn's AAsm assembler files.
See Martin's help text for more details.

mode_pascal
Martin Ebourne's Pascal mode.
See Martin's help text for more details.

mode_throwback
This is a Zap throwback window.
Double click SELECT or press RETURN on a line to go to the match.
Treble click SELECT to jump to the match and bring the window to front.
Click ADJUST or press DELETE on a line to remove the line.
Double click SELECT with Shift held to jump & remove the throwback file.

mode_taskwindow
Taskwindow output window.
Most control letter keys and cursor keys are sent to the displayed task.
Function keys and cursor-copying dealt with by Zap.
Change to TEXT mode to suspend the task.
Change back to TASKWINDOW mode to resume the task.
Use ^C to copy the selected are to the input stream.

| Leaf windows

window.InfoBox
This is the Zap info window.
The application Zap is copyright Dominic Symes - see 'Copyright' file.
Click on the 'Dominic Symes' for a list of mode authors.
See the 'Copyright' file for my address.

window.GotoBox
This window displays your current position in the text.
Type the line number or address you wish to move to in the file.
You may use expressions (eg '&100+32*78').
Press CTRL U to clear the buffer.

window.SaveBox
Drag the file type icon to a directory window to save the file.
Press RETURN or click on 'OK' to save the file.
Click ADJUST on 'OK' to save the file but leave the window open.
Click MENU to bring up a file type menu.

window.DyingBox
Click SAVE    (or press 'S') to save the file before it is discarded.
Click DISCARD (or press 'D') to delete the file.

window.QuitBox
Click QUIT (or press 'Q') if you wish to leave zap WITHOUT saving any files.

window.SaveSelBox
Drag the file type icon to a directory window to save the selection.

window.SearchBox
Type the search string and press RETURN to search for it.
Click on 'Edit Macros' to change the search macros.
Press TAB to recall the old search string.
Press ctrl-letter keys to alter the options.

window.MacroBox
The small boxes give the macro to match.
The large boxes give the text to replace the macro with.

window.ReplaceBox
Type search string then RETURN.
Type replace string then RETURN.
Press CTRL U to clear a buffer.
Press ctrl-letter keys to alter the options.

window.NextBox
Click REPLACE (or press R) to replace one match.
Click TO END  (or press T or E) to replace all following matches.
Click SKIP    (or press S) to move to the next match without replacement.

window.PrintBox
Prints a file by use of the !Printers (printer driver) application.
Printing uses the outline font selected via the display menu.
Press PRINT to start printing.

window.DzapBox
Type the filing system name (CASE SENSITIVE) and then press RETURN.
The default drive number should then be filled in for you.
Type the drive number then RETURN to change drive.
Press READ SECTOR to read the disc.

window.QuickBox
Click on PRINT or type RETURN to send the file to the printer.
If this does not work for your printer then change the CR/LF DIP switch OR:
Load the printer driver and save the file onto it.

window.MzapBox
Drag the 'switcher' icon to a window/icon belonging to the task you want.
Press RETURN or click on READ.
Drag to a Zap taskwindow to read the taskwindow memory.

window.UndoBox
If you turn off the UNDO remember that PASTE and YANK will no longer work.

window.LoadBox
Click on 'EDIT' (or press E) to load the file into a separate buffer.
Click on 'OVERWRITE' (or press O) to replace the current buffer.

window.SaveOBox
Click on 'OVERWRITE' (or press O) to replace the file on disc.

window.SaveCBox
Click on 'SAVE TO CSD' to save to the currently selected directory.

window.MiniBuf
This is the Zap minibuffer.
Drag with SELECT to move.
Drag near the right hand edge to resize.
Press ESCAPE to leave the minibuffer.

window.ColourBox
This is the Zap 24 bit colour selector.
Press one of the 16 wimp colours to set that colour.
Drag the bars then click on 'Set' to set a general colour.

| ***************************************************************
| *                       C O M M A N D S            *
| ***************************************************************

ASSEMBLE <string>
Assembles the instruction given by <string>.
Places it at the current cursor position (using its file address).
Assembly is performed by spawning a BASIC program.

AUTOINDENT
Toggles auto indent on and off.
(see b16 of w_flags)

BASEMAP <word>
This command switches the key basemap to the given keymap number.
All further keypresses will use this keymap.
(It writes variables key_basemap and key_current - see E-Vars)

BASIC
In Basic mode drops the user into BASIC with program loaded at PAGE.
In a different mode will do something mode specific.
(Calls mode entry point e_basic)

BEEP
Makes a short beep.
(Does a VDU 7)

BINDTOKEY <string>
Evaluates string to a number and binds the currently learnt sequence
to that key code. (eg BINDTOKEY "&1B").
If <string> is not given then prompts you to press a key.

BITMAPLIST
For internal use.
Generates the menu of bitmap fonts.

CANCEL
Cancel current Yank and Search-as-you-type operations.
Cursor is restored to its original position.

CDOWN
Moves cursor to the end of the file.
A marker is left at you previous position.
(Use sF6 to restore your position).

CHAR <byte>
Inserts the character code <byte> into the file.
Multiple presses are buffered (as with any byte call).
(Uses mode entry point e_char)

CLEARSEL
Clears any selected regions.
(Calls Zap_ClearSel)

CLEFT
Moves cursor to start of line.
(uses mode entry point e_cminus)

CLI <string>
Execute <string> as a command line interpreter command. Eg CLI "Set A 3".
Output from the command is redirected to Null:.
See also OSCLI and WIMPTASK.

CLOSEOTHER
Closes the next window in the swap-window sequence.
(Closes other window if only two are open)

CLOSEPRINTER
Closes 'printer:$' filer window via *Filer_CloseDir.

CLOSEWINDOW
Closes the current window.
Puts the cursor in the next available window afterwards.

COLOURLIST
Internally used command to create the colourlist menu.

COLUMNTAB
Set tab mode to column tab.
(Changes b9-10 of w_flags)

COMMAND <string>
Executes the command (or colon separated list of commands) <string>.
(Uses Zap_CommandString)

COMPILE
In Basic mode saves the program to disc and then runs it.
In C mode compiles the program.
(Calls the mode entry point e_compile)

COPY
Initiates split-cursor-copying mode.
Each subsequent press copies a single character.
(Switches cursor to mode 2 and uses mode entry point e_copy)

COPYSEL
Copies the selected region to input caret position.

COREDUMP
Produces an image of Zap's memory in Zap's directory.
Use to produce a record of a nasty bug etc.

CREATEFILE <word>
Creates an empty file of filetype <word>.

CRIGHT
Moves to end of line using.
(uses the mode entry point e_cminus)

CUP
Moves to the start of a file, leaving a marker at the old offset.

CURSORMENU
Internally used to produce the cursor types menu.

CUT
Deletes the selected region.
If the undo buffer is on, it can be pasted back with cY (Paste).
If the undo buffer is off, then it's gone for ever!

DATE <string>
Inserts a date string of format <string>.
Eg, <string>=%MI to substitute the time in minutes.
(uses OS_ConvertDateAndTime)

DEFAULTMAP
Changes the key basemap to the default value.
(default value specified in the 'keys' file)

DELETE
Deletes the character before the cursor.
(calls mode entry point e_delete with R7=0)

DELETENEXT
Deletes the character under the cursor.
(calls mode entry point e_delete with R7=1)

DELLINE
Deletes the line the cursor is on.
Cumulative deletes can be pasted in one go by cY.
(uses e_lineprev and e_linenext to find the line limits)

DELTOEND
Deletes from cursor to the end of the line.
Deletes the line terminator if the cursor is at the line end.
(uses e_lineend to find the line end)

DELTOSTART
Deletes from cursor to the start of the line.
(uses e_linestart to find the line start)

DOWN
Moves cursor down a line.

DUMPFILE
Creates a text image of the current display for this file.

DZAPBOX
Opens the 'read disc' window.

EMACS
Switches to Emacs key map emulation.
(Sets Basemap to 1)

ESCAPE
Cancels the following modes (leaving cursor where it is):
copy-mode, yank-mode, select-via-cursor, search-as-you-type.
See also Cancel (cG).

EXECUTE
Execute last learnt sequence.
(see cL)

FASTUNDO
Undo the last operation taking the fastest route in the undo tree.
For example if you do a,b,undo,c,fastundo,fastundo then it will
delete the 'a' as opposed to inserting the 'b'.

FFLAGS_TOGGLE <word>
General purpose command to toggle one bit of the file flags word.
The titlebar updated afterwards.
See Wflags_Toggle for details of <word>.

FINDFILE <string>
Opens a buffer on the indicated file (should be a full path name).

FINDFILEREADONLY <string>
As for FINDFILE but puts in read only mode when file loaded.

FONTLIST
Internally used to produce the menu of outline fonts.

FONTSIZE <word>
Set the outline font size to <word>.

FONTTYPE <word>
Sets the display font type according to word:
0=bitmap font at 1dpp, 1=scaled bitmap font, 2=system font via vdu.
3=anti-aliased font (quick) 4=anti-aliased font (via vdu)
5=bitmap font (double height).

FORMATTEXT
Formats the current paragraph from the cursor position.
Uses the wordwrap width for formatting.

FULLUNDO
Undo the last operation taking the slowest route in the undo tree.
For example if you do a,b,undo,c,fullundo,fullundo then it will insert
the 'b' as opposed to deleting the 'a'. Compare this with Fast undo.

GETMODULE
Internally used to open the list of modules to grab.

GETWORKSPACE
Internally used to open the list of module workspace's to grab.

GETDYNAMICAREA
Internally used to open the list of dynamic areas to grab.

GOTO
Bring up the goto dialogue box.

HELP <string>
Gives help on subject according to the first letter of <string>
'c' or 'f'=help on a command (Helpcom), 'k'=help on a key (via Helpkey)
'm'=help on the current mode, 'z'=Loads main help file on Zap.

HELPKEY <string>
<string> is evaluated to a number and  help is given on that key code.

HELPCOM <string>
Help is given on the command <string>.

HEXASCII
Toggle hex/ascii entry mode.
(uses b5 of the w_flags). Byte mode uses this for

ICONISE
Iconises the window.

INDENT
Indents the currently selected region by the string given in the
menu option selection.indent. If this evaluates to a number then it
indents by that number of spaces.

INDENTBY <string>
Indents the selected area by <string>.
If <string> is a number then uses that many spaces.
If <string> is negative then outdents.

INDIRECT
Jump to the address contained at the word at the current cursor position.
(leaving a marker behind as with any jumps)

INFOBOX
Opens the info box.

INSERT <string>
Inserts <string> into the file.
(Uses the mode entry point e_char)

INSERTDATE
Insert the current date using the format in the keys file.
(variable &300)

INSERTGS <string>
Inserts <string> into the file, GS-Transing it first.
Hence, you can include control code (eg |M).
(Uses the mode entry point e_char)

INSERTTIME
Insert the current time using the format in the keys file.
(variable &301)

JOINLINE
Joins the current line to the following line.
(uses the mode entry point e_joinline)

KEEPREGION
Copies the selected region to the yank buffer (Emacs kill ring).
The region can be pasted again using cY.
This is the equivalent of Emacs Meta-W.

KEYMAP <word>
Change the keymap to <word> for the next key press only.
After the next key press the keymap will revert to Basemap value.
(Eg Used for ctrl-X extensions in the Emacs key map)

LASTMARK
Jump to the previous mark in the market buffer.

LASTMATCH
Move to the previous match of the current search string.
Will move across files if the 'all files' option is set.

LASTSECTOR
Move to the last sector on an (unaltered) file read from disc.

LASTTRACK
Move to the last track on a file read from disc.

LEARN
Start or stop learning a key sequence.
Use Execute (F1) to replay the learnt sequence.
NB Escape will be learnt and will not stop the learning.

LEFT
Move cursor left.
(calls mode entry point e_minus)

LINEEDIT
Toggles line edit mode on and off.
(uses b14 of w_flags)

LINENOS <word>
Change line number state of the window to <word>.
0=no line numbers 1=logical line nos 2=physical line nos 3=addresses.

LINESPACING <word>
Sets the line spacing to <word>.

LINEWRAP
Toggles line wrap mode on and off.
(b26 of w_flags)

LISTFNS
Lists function definitions for the given mode.
(via e_listfns)

LOADLIST
Internally used to generate a menu of modes to load.

LOADMODULE <string>
Load the module given by filename <string> as a Zap module.
Warning: This is very low level - loading a module which is
already loaded will cause a crash.

MAKEDEFAULT
This saves the window's options as the current default options.
Follow this by a 'save options' to make the current window dictate
the default options. Useful for setting default colours.

MARGIN <word>
Set the margin to <word>.

MINIMENU
Internally used to create the minibuffer options menu.

MINIMISEMEMORY
Contacts heap by as much as possible.
I'm afraid it's an Acorn OS_Heap type heap so this won't usually do much.
Automatically done whenever a file is removed from Zap.

MISCOPS <word>
Toggles a miscellaneous option according to <word>
 0=Auto removal of files when a window closes
 1=Auto clearing of selection regions when a character typed
 2=reserved
 3=Flashing cursor
 4=Check datestamp before saving a file
 5=Auto clear of search box when opened
 6=Confine cursor to visible area of the window

MODE <word>
Change the current display mode to <word>.
Use MODEN in preference.

MODEN <string>
Change to the display mode named <string>.

MOVESEL
Move the selected area to current cursor offset.

MULTICOMMAND <data>
Executes a list of other commands (eg learnt sequence or ':' separated
chain of commands). The list is stored in the data block.
The data block is a -1 terminated list of entries of the form given below.
Note that all the data for the commands to be executed is stored within the
data block except for data type 4 (other multicommands).
    #0 Command address
    #4 Data length/number of times (R1 on command entry)
    #8 Command data. Depends on the type of the command (see E-command):
        0 No data
        1 List of #4 bytes then align
        2 List of #4 words
        3 0 terminated string then align
        4 Pointer to the data block

MZAPBOX
Opens the 'read memory' window.

NEWTYPE <word>
Changes the file type of the file to <word>.
Creates a file of value <word> if on main (options) menu.

NEWVIEW
Open a new window on this file.
(copying the old window mode and format)

NEWVIEWLIST
Internally used to create the menu of files to open a new view on.

NEXTMARK
Jump to next mark in the marker buffer.

NEXTMATCH
Move to the next match of the current search string.

NEXTSECTOR
Move to the next sector on a file read from disc.

NEXTTRACK
Move to the next track on a file read from disc.

NONSTANDARD
Toggles non standard editing on and off.
(b15 of w_flags)

NULL
Does nothing.
(but prevents the key from being passed on via Wimp_ProcessKey)

OPENPRINTER
Open a filer window on printer:$ via *Filer_OpenDir.

OSCLI <string>
Execute <string> via the command line interpreter. Eg OSCLI "Help".
Command output is sent indirected to <Wimp$Scrap>.
The file is displayed if it's non null. See also CLI and WIMPTASK.

OUTDENT
Outdents the selected region.
(by the length of the current indent string)

PASTE
Pastes the last cut region repeatedly.
(Use YANK to cycle through previously deleted regions)

PRINTFILE
Open the fancy print window.

QUICKPRINT
Open the quick print window.

QUICKSAVE
Save the file directly to disc with no prompt.

QUIT
Kill Zap - dead!
(prompts user to save altered files first)

QUOTE
Causes the next key typed to have its key code entered into the text.
It is the Zap key code that is entered.
Hence you need to do cQ cSpace to get a 0.

READONLY
Toggle the read only state of a file.
(b8 of f_flags)

REDO
Redo the last undone operation whether full or fast.

RELOADKEYS
Reload the 'keys' file, reading the new key bindings.

REMOVELIST
Internally used to produce the menu of files to remove.

RENUMBER
In Basic mode this renumbers the program
(In general calls the mode entry point e_renumber)

REPLACE
Open the Search & Replace window.

RETURN
Breaks the line (if not in line edit mode), indenting in auto-indent mode.
Also cancels split cursor copying.
(uses mode entry point e_return)

RETURNCHAR <word>
Set the value of the file return character.

RETURNNOINDENT
Breaks the line as for RETURN but does not indent in auto-indent mode.

RIGHT
Move cursor right.
(using mode entry point e_plus)

RUN
In Basic mode this runs the basic program at PAGE.
(in general calls the mode entry point e_run)

RUNANDQUIT
In Basic mode this runs the basic program at PAGE and then quits BASIC.
(in general calls the mode entry point e_runandquit)

SAVE
Opens the save box.

SAVEANDRUN
In Basic mode this saves the program to disc and the chains it.
(in general calls the mode entry point e_saveandrun)

SAVEFILE <string>
Save the current buffer with filename <string>.
If <string> is omitted the buffer is saved under its current name.
(unless it doesn't have a proper name when you are prompted for one)

SAVEOPTIONS
Saves the current default options to the !Config file.

SAVESEL
Opens the save selection box.

SCDOWN
Move down display one line (without moving cursor).

SCLEFT
Move to left of display one character (without moving cursor).

SCRIGHT
Move to right of display one character (without moving cursor).

SCUP
Move up display one line (without moving cursor).

SDOWN
Move down a page.

SEARCHBACK <string>
Search as you type backwards (if no arguments).
Searches backwards for <string> if argument given.
Cursor is placed at the end of the match.

SEARCHBUF <string>
Open Search window with output to window option set (if no arguments).
Produce a buffer containing all matches of <string> if argument given.

SEARCHCUR <string>
Open Search window with output to cursor option set (if no arguments).
Move cursor to the first match of <string> if argument given.

SEARCHFORWARD <string>
Search as you type forwards (if no arguments).
Searches forwards for <string> if argument given.
Cursor is placed at the end of the match.

SELECTBUFFER
Select entire buffer.

SELREGION
Start selection of region by cursor movement.
Use Escape to end the selection.
(this sets the cursor mode to 4)

SETWIDTH <string>
Set width of window to number contained in <string>.
(calls mode entry point e_setwidth)

SLEFT
Move cursor back a word.
(calls e_sminus)

SPLITLINE
Split line at current cursor position.
(calls mode entry point e_splitline)

SRIGHT
Move cursor forward a word.
(calls e_splus)

STARTADDR <word>
Set apparent start address of file to <word>.
(this address is used in the margin in byte/code mode)

STARTLINE <word>
Set the apparent line number of the first line in the file.

STRIPSPACES <word>
Perform space altering commands according to the bits set in <word>.
b0=Strip spaces at the end of lines, b1=Strip tabs at the end of lines
b2=Tabify (ie convert spaces to tabs), b3+ reserved

SUP
Move up a page.

SUSPEND
Brings up the command line (same as F12).

SWAPCASE
Swap case of next character/selected region if there is one.

SWAPCHARS
Swap characters either side of cursor.

SWAPWINDOW
Moves cursor to the next window in sequence.
If several views are on the file then swaps between views.

SWITCHTAB
This toggles the TAB mode for a file between UNIX and Truetab modes.
(b9-b10 of w_flags)

TAB
Performs the mode's tab action.
(calls e_tab)

TABCHAR <word>
Sets the current tab character (usually 9)

TABDISPLAY <word>
Sets the way tabs are displayed according to <word>:
0=none 1=as spaces 2=arrow 3=dashes then arrow.

TABMODE <word>
Sets the current tab insertion mode according to <word>:
0=unix tab 1=edit tab 2=column tab.

TABSASSPACES
Toggles whether tabs are inserted as spaces or truetabs (char 9).
(toggles b11 of w_flags)

TASKWINDOW
Opens a new task window (creating a new task).

TOBACK
Moves the window to the back of the window stack.
(via Zap_OpenWindow 4)

TOFRONT
Moves the window to the front of the window stack.
(via Zap_OpenWindow 3)

TOGGLEHEX
Toggle hex/decimal display of line numbers.
(b10 of w_format)

TOGGLEINSERT
Toggle insert/overwrite modes
(b1 w_flags)

TOGGLEMARK
Insert/delete mark from marker buffer at current cursor offset.

TOGGLEUNDO
Toggle the undo buffer for a file on and off.

TOGGLEWIND
Toggles the window size.
(he not-fully-open size is stored in w_togminx to w_togmaxy)

UNIVERSALARG <string>
Evaluates <string> to a number and then passes it to the next command.
This usually has the effect of executing the next command <string> times.

UNSPACE
Remove excess spacing around the cursor.

UP
Move cursor up a line.

WFLAGS_ALTER <word>
Command to alter bits of the w_flags or opt_flags word.
The window is redrawn afterwards to display the new status.
The <word> is as for Wflags_toggle.

WFLAGS_TOGGLE <word>
Command to alter bits of the w_flags or opt_flags word.
The titlebar is updated after the toggle.
The <word> is a short 'program' consisting of up to 4 instructions in
the 4 bytes. Each byte has the form:
 b0-b4 = bit to effect
 b5-b6 = 0=> toggle the bit, 1=> set the bit, 2=> clear the bit
 b7    = 1 to show this byte is active (in the top 3 bytes only)
Eg, &5 means 'toggle bit 5'
Eg, &8609 means toggle bit 9 then toggle bit 6 etc.

WFORMAT_ALTER <word>
Command to alter bits of the w_format or opt_format words.
The titlebar is updated afterwards but the window not redraw.
The <word> is as for Wflags_toggle.

WFORMAT_TOGGLE <word>
Command to alter bits of the w_format or opt_format words.
The window is redrawn afterwards to display the new status.
The <word> is as for Wflags_toggle.

WIMPTASK <string>
Execute <string> as an OSCLI command via Wimp_StartTask.
Differs from OSCLI and CLI in that VDU output is not redirected.
Should be used for starting up other applications.

WORDWRAP
Toggle wordwrap mode on/off.
(toggles b13 w_flags)

WRAPWIDTH <word>
Set the wordwrap width.

WRITEFILE <string>
Saves the buffer with filename <string>.
If <string> is not given then it prompts for a filename.
(it differs from Savefile which doesn't usually prompt)

YANK
Paste last cut region from undo buffer to current cursor position.
On repeated action it pastes previously cut regions in a cyclic manor.

| ***************************************************************
| *                      ZapMJE extensions            *
| ***************************************************************

| Modes

mode_c
Martin Ebourne's colour C mode.
Colours can be configured from the display menu.
Press scC to compile.
See Martin's help text for more details.

mode_c++
Martin Ebourne's colour C++ mode.
Colours can be configured from the display menu.
Press scC to compile.
See Martin's help text for more details.

mode_assembler
Martin Ebourne's colour Assembler mode.
Designed for Acorn's ObjAsm assembler files.
Press scC to compile.
See Martin's help text for more details.

mode_pascal
Martin Ebourne's Pascal mode.
Press scC to compile.
See Martin's help text for more details.

| Commands

MJE_ALTERSEL
Move the closest end of the selection to the current cursor position (like
Adjust). If there is no selection then select the next character.

MJE_CLOSECOMMENT
Insert close comment string.
(ZapMJE modes only)

MJE_COMMENT
Insert open and close comment strings leaving the cursor in the middle.
(ZapMJE modes only)

MJE_COMMENTLINE
Comment out the entire line and move onto next.
(ZapMJE modes only)

MJE_ENDIF
Insert end pre-processor 'comment'; ie. use conditional compilation to
disable a code section.
(ZapMJE modes only)

MJE_GENERATEHEADER
Automatically append function declarations onto the end of the corresponding
header file.
(C mode only)

MJE_HELPCONTEXT
Find help for the word at the cursor, using Guttorm Vik's StrongHelp.
Note that StrongHelp is not supplied with Zap.

MJE_HELPTOPIC <string>
Find help for the supplied string, using Guttorm Vik's StrongHelp.
If there is no supplied string then find help for the selected word, else
prompt for the word in the minibuffer.
Note that StrongHelp is not supplied with Zap.

MJE_IF
Insert start pre-processor 'comment'; ie. use conditional compilation to
disable a code section.
(ZapMJE modes only)

MJE_IFMODE <string>
Execute given command string only if the current mode is in the supplied
list. See Martin Ebourne's help text for further details.

MJE_LASTFUNC
Jump to the start of the previous function definition.
(ZapMJE modes only)

MJE_NEXTFUNC
Jump to the start of the next function definition.
(ZapMJE modes only)

MJE_OPENCOMMENT
Insert open comment string.
(ZapMJE modes only)

MJE_SWAPTOHEADER
Move cursor into corresponding header or source file, possibly loading it.
(ZapMJE modes only)

MJE_UNCOMMENTLINE
Uncomment line and move onto next.
(ZapMJE modes only)

| ***************************************************************
| *                      ZapDS extensions            *
| ***************************************************************

DS_RUNAPP
Save the file if changes have been made, then try to run it as an
application (failing this, the file itself). The window is sent to the back.

DS_INSERT
Insert a space at the cursor as in !Edit.
In byte/word/code modes, insert a zero byte or word as appropriate.

DS_EVAL <string>
<string> = "<base>:<expression>" or "<expression>"
Evaluate the supplied expression (as *EVAL) and inserts the signed result in
the supplied base (the exact format is mode dependent).
If the expression evaluates to a string, the base (if supplied) is ignored.

DS_UEVAL <string>
<string> = "<base>:<expression>" or "<expression>"
Evaluate the supplied expression (as *EVAL) and inserts the unsigned result
in the supplied base (the exact format is mode dependent).
If the expression evaluates to a string, the base (if supplied) is ignored.

DS_EVALH <string>
Evaluate the supplied string (as *EVAL) and inserts the result as a
hexadecimal number (the exact format is mode dependent).
If it evaluates to a string, the base (if supplied) is ignored.

DS_ADRL <string>
<string> = "<condition code> <register>,<address>"
Assemble a long (two instruction) ADR.
The condition code is optional.

DS_ADRX
<string> = "<condition code> <register>,<address>"
Assemble a very long (three instruction) ADR.
The condition code is optional.

DS_FINDFILE
Look for an object name (file or directory) at the cursor. If successful,
then attempt to load the file or open the directory (as appropriate).

DS_OPENPARENT
Open the directory containing the current file.

DS_SWAPCASECURSOR
Swaps the case of the character at the cursor, advancing the cursor by one -
whether there's a selection or not.

| End