ZMail command and keybinding inventory for the maintained LM-3 tree

Direct message and application commands

N and P are not simple array increments in every case. Profile/menu choices can select unseen or undeleted messages and first/last variants. The table binds the entry commands; those commands interpret the current policy.

Numeric arguments

The four ten-key ranges are generated by range entries in SET-COMTAB; they are 40 effective bindings, not four literal keys. Together with the four minus variants, the reader table has 44 generated numeric cells in addition to its 47 ordinary direct cells.

The argument is not adequately represented by “present plus an integer.” The source retains five provenance tags:

The top-level loop resets value and tag before each command (zmail/top.lisp.566:95-103); Large Argument installs :INFINITY (zmail/comnds.lisp.602:269-273). Provenance is observable: Summary scrolling tests :DIGITS and :CONTROL-U as explicit line counts and treats the other tags as screen counts (zmail/comnds.lisp.602:1687-1701).

Reachability is context-specific. The top-level ZMail reader reaches all five tags. The message and reply editors use the inherited System 303 editor argument reader, which reaches NIL, :SIGN, :DIGITS, and :CONTROL-U (zwei/modes.lisp.164:995-1024); Large Argument is not installed in those editor tables, so :INFINITY is not an editor state in the clean profile. Summary, menu, pointer, typeout, and transient utility loops do not synthesize a separate numeric state of their own. A command reached after returning to the top reader receives the top reader's state; a command executed wholly inside one of those loops does not. Minibuffer argument behavior belongs to D05's minibuffer parent.

General message editing

The message Control-X prefix adds:

Unrecognized Control-X keys continue into ZWEI's standard prefix table.

Reply/draft composition

The reply Control-X table adds:

An absent reply-prefix child then inherits the message-prefix additions and Standard ZWEI Control-X commands. Direct reply cells instead go straight to the active mode, as described above.

The reply extended-command registry has these 17 entries in source order:

1. Add To Field
2. Add Cc Field
3. Add FTo Field
4. Add Fcc Field
5. Add Subject Field
6. Add In-Reply-To Field
7. Add More Text
8. Add From Field
9. ZMail Yank Current Msg
10. Prune Yanked Headers
11. Send Message
12. Abort Send
13. Restore Draft File
14. Write Draft File
15. Save Draft File
16. Save Draft As Msg
17. Change Subject Pronouns

Mouse-3-1 opens this separate 15-entry menu, also in exact source order:

1. Add To
2. Add Cc
3. Add Fcc
4. Add Subject
5. Add In-Reply-To
6. Add More Text
7. Add From
8. Prune Yanked Headers
9. Send Message
10. Abort Send
11. Restore Draft File
12. Write Draft File
13. Save Draft File
14. Save Draft As Msg
15. Change Subject Pronouns

Thus Add FTo Field and ZMail Yank Current Msg are extended-command-only in this profile. The two lists and their deliberate difference are constructed at zmail/comnds.lisp.602:107-142; they must not be normalized into one synthetic menu.

Exact 20-command button matrix

Numeric arguments take precedence where the command explicitly tests them. Delete uses the argument to select message number N and forces no movement, regardless of button (zmail/comnds.lisp.602:354-382). Undelete uses N as the exact message and otherwise performs the backward scan (comnds.lisp.602:411-426). Reply's numeric rules are specified below. Other commands reject or consume arguments according to their DEFINE-ZMAIL-TOP-LEVEL-COMMAND options; the table does not manufacture a button variant for them.

Source anchors for the matrix are zmail/defs.lisp.284:75-95,691-727,780-832; zmail/window.lisp.361:199-217; zmail/comnds.lisp.602:275-426,699-842,1172-1242,1319-1475,1724-1744,2023-2077,2606-2634; zmail/mail.lisp.313:10-36,248-290,558-619; zmail/filter.lisp.364:5-70,216-299; zmail/mfiles.lisp.336:837-880; and zmail/profil.lisp.131:118-135.

Fixed option trees

The following order is normative; an implementation must compare ordered leaves, not merely set membership.

• Next: Next undeleted; Next unseen; Next; Last undeleted; Last unseen; Last.
• Previous: Previous undeleted; Previous unseen; Previous; First undeleted; First unseen; First.
• Delete: Backward; Forward; Remove; No.
• Configure: Summary only; Both; Message only; Experimental.
• Mail: Bug; Mail; Forward; Redistribute; Local.
• Sort is an 8 × 2 product. Keys are Date, To, From, Subject, Keywords, Text, Length, Position; directions are Forward, Backward.
• Quit is a 3 × 2 product. Save policies are Don't Save, Ask, Save; exit policies are Quit, Logout.
• Map Over: Delete; Undelete; Type; Find string; Keywords; Unkeywords; Move; Forward; Redistribute; Reply; Concatenate.
• Other starts with exactly View File; Whois. ADD-OTHER-COMMANDS appends new command-name entries in registration order, so a patched or site-loaded image has a larger registry rather than a different clean denominator (zmail/comnds.lisp.602:144,2606-2609).

Reply's 21-choice tree

System 303 Reply is a 7 × 3 product, not the later Genera 7 × 3 × 2 tree:

recipient
├─ All
├─ All-Cc
├─ Cc-All
├─ To
├─ To-Cc
├─ Cc-To
└─ Sender
   × view/yank
     ├─ Like Mail
     ├─ Show Original
     └─ Yank

Left and KBD use *REPLY-MODE* × *REPLY-WINDOW-MODE*; middle uses the two middle-profile values; right exposes all 21 products. A numeric argument bypasses the button branch: 1 substitutes *1R-REPLY-MODE*; 3 or 4 forces Yank; every other numeric value leaves the default pair unchanged. This exact ordering and precedence come from zmail/defs.lisp.284:712-727 and zmail/mail.lisp.313:558-619.

Dynamic chooser schemas

Dynamic values vary, but their construction order and terminal actions are fixed:

• Save Files: rows are buffers sorted by display name. A disk-buffer row offers Expunge, Save, Kill; a temporary-buffer row offers Expunge, Kill. Initial checks reflect pending expunge/save work. Execution is Expunge, then Save, then Kill for each chosen row; after any disk expunge, unchanged temporary buffers receive the source's cleanup expunge (zmail/comnds.lisp.602:801-842).
• Select: loaded disk buffers, then loaded temporary buffers, then an optional nonselectable balancing cell, followed by Read or create file, Mark summary, Abort, Subset (zmail/filter.lisp.364:26-70).
• Move: loaded disk buffers, then loaded temporary buffers, then an optional balancing cell; next comes By Filters for a single message or By Individual Filters for a whole-buffer operation; then New Temporary, Generated Temporary, Find file, Text Mail File, Abort, Hardcopy. Hardcopy maps left to ordinary hardcopy, middle to no value, and right to hardcopy options (zmail/comnds.lisp.602:1367-1475).
• Continue: draft rows in *DRAFT-LIST* order, followed by Restore draft file and Restore draft message. On Restore draft message, left uses the current message, middle has no value, and right invokes the one-message Summary chooser (zmail/mail.lisp.313:248-290).
• Keywords: the multiple-choice rows come from the current keyword registry. Committing computes and stores two ordered sets—newly added and newly removed—as the next left-button default (zmail/comnds.lisp.602:1172-1242).
• Survey and Jump/Goto: their right branches enter the filter/universe selector described under Filter selection. Survey stores all four map and filter values; Goto stores its filter function and argument. Cancellation and a missing remembered value retain the source's abort/barf behavior (zmail/filter.lisp.364:216-299).
• Other: its rows are the current append-only auxiliary registry, beginning with the two clean leaves above. Left and middle resolution use exact command identity, and the selected menu item becomes the remembered left default (zmail/comnds.lisp.602:2611-2634).
• Replay Keyboard Macro: although not one of the 20 pane cells, it has the same dynamic shape: registered macro names in registration order, a remembered default for KBD/left, and a menu for right. An absent/invalid default or a stream without macro execution support barfs (zmail/comnds.lisp.602:2660-2684).

The experimental filter-oriented layout separates commands which do not require a message filter—Configure, Get New Mail, Save Files, Sort, Profile, and Quit—from the filter-aware menu: Concatenate, Survey, Delete, Undelete, Reply, Other, Type, Next, Previous, Continue, Select, Keywords, Move, and Mail.

The Mail menu's Local leaf creates a new message in the current buffer for editing instead of sending it through a network transport.

Utility-frame parent

Filter, universe, and profile tasks share this noneditor outer loop:

The parent compound-event dispatcher is exact and ordered by opcode:

The main ZMail frame uses that table as its fallback but overrides these opcodes:

Main-frame matches take precedence; unlisted opcodes fall through to the parent. An unknown compound event is requeued only when the active dispatcher's :WHICH-OPERATIONS result advertises that opcode, then the current loop is restarted. Otherwise the unknown-special condition declines it; there is no universal “unknown event beeps” rule. These branches are at zmail/top.lisp.566:135-185,694-727.

Reader mode line and summary label

The mode line has three dynamic selectable regions:

The Summary pane's label has a separate geometry-dependent action. A single left click in its central half toggles Both to Summary and every other configuration to Both. A single left click in either outer quarter selects Message. Other mouse buttons on the label do not invoke this transition.

Marking mode

Marking first clears message marks and exposes the Summary configuration. Its entire task-local tree is:

Compound-blip commit is tested before atomic abort. Unwind always removes the marks and restores the prior documentation and layout.

Filter selection

The filter-selection frame owns no keyboard table: every atomic key beeps. Its pointer/event tree is:

Filter definition

Outside the editor, filter definition inherits the utility-frame parent. Inside the editor, End and Control-Escape finish the standalone edit, Abort leaves only the editor, and all other input inherits Standard ZWEI plus the extended-search Control-H prefix listed below.

The insertion menus cover Any or a named keyword, a named user filter, Deleted/Unseen/Recent/Answered/Filed, Search, To, To/Cc, From, Subject, Other, and Before/On/After date predicates. The application buttons are exact:

A summary click extracts filter material. Typeout-execute and summary-execute events explicitly barf. The middle-button Name behavior is source-visible even though its documentation mentions only the right button.

Universe definition

Universe definition uses the same utility parent and standalone editor contract; its mode line incorrectly says Editing Filter. File and temporary-buffer menu items insert buffer-name strings, Primary and Current insert those symbols, named universes insert a one-item list, and All inserts (ALL).

Union, Intersection, Not, Close, Done, and Abort perform the same action for every button. Name uses left for a new name and middle/right for the existing universe menu. D08 retains a runtime oracle for the (ALL) representation versus direct symbol expansion instead of guessing.

Profile task

The profile task uses the utility parent before editing and standalone ZWEI while editing. Control-R, selecting the editor pane, or clicking Edit enters the editor. The application buttons form this tree:

Variable-choice events delegate the actual button to the TV value pane, mark profile state changed, and refresh its documentation. The Keywords popup uses the same standalone End/Abort edit contract. Random nonaccent clicks are ignored.

Message choosers and typeout items

CHOOSE-MSG-FROM-SUMMARY consumes exactly one event: SUMMARY-MOUSE returns its message; every other input barfs and is not requeued. The typed-or-summary chooser uses ordinary minibuffer editing, accepts a clicked summary message, and substitutes its default when typed input is empty.

Typeout items have these left defaults and ordered right menus:

Left emits a typeout-execute event, right chooses an operation, and any other single button beeps. The typeout reader returns only numeric/keyboard input or the named typeout, summary, menu, mouse, mode-line, and mouse-button opcodes; it discards other compound events. Multiple-header and single-field selectors accept exactly one typeout-execute event and barf otherwise. Filter extraction accepts typeout actions, changes its source message on a summary click, returns on Space, and requeues any other input before returning.

Extended-search minibuffer

Extended search inherits the ordinary minibuffer and adds Help plus this complete Control-H child:

The ordinary parent accepts Return, Control-Return, End, Control-G, Abort, Control-Shift-Y, Control-Meta-Y, Control-Shift-S, Meta-Shift-Y, and a double left click. Control-Z, Meta-Z, and Control-Meta-Z are hard undefined before Standard fallthrough.

Experimental :NEW layout

The experimental layout gathers a universe, filter, and command through a staged tree:

Universe
├─ left   -> reuse last universe
├─ middle -> current buffer
└─ right  -> choose universe and save it as the default

Filter
├─ left   -> reuse last filter
├─ middle -> BARF
└─ right  -> choose filter and save it as the default

Command/menu event
├─ repeatedly resolve Other Commands
├─ current-message command
├─ current-buffer associated-all command
├─ other-buffer associated-all command under dynamic selection
├─ materialize filtered temporary buffer, then associated-all command
├─ associated map command
└─ otherwise BARF

A filter chosen while scope is one message promotes scope to the current buffer. An input which is neither a menu nor mouse-button event is requeued and exits operand collection. Unwind restores the labels Just current message and All.

Navigation, display, and help

Apropos; Break; Configure; Documentation; Down to Next; End of Msg; Extended Command; Find String; Help; Mode Line Scroll; Mouse Point PDL; Move to Default Previous Point; Move to Previous Point; Next; Previous; Refresh; Replay Keyboard Macro; Scroll Summary Window; Self Document; Set Pop Mark; Start of Msg; Up to Previous.

Message lifecycle and filing

Delete; Delete All; Delete and Save Msg; Delete and Up; Delete Duplicate Msgs; Expunge; Get New Mail; Kill Current Buffer; Kill Ring Save Msg; List Buffers; Move; Move All to File; Not Modified; Remove; Rename Buffer; Save; Select; Select Arbitrary Format Mail File; Set Expiration Date; Undelete; Undelete All; Undigestify Message; View File.

Composition, reply, and transport-facing commands

Bug; Continue; Edit Current Msg; Forward; Forward All; Mail; Redistribute All; Redistribute Msg; Reply; Reply All; Yank Msg.

Classification, search, and bulk operations

Goto; Jump; Keywords; Keywords All; Large Argument; Map; Occur; Other Commands; Profile; Select References; Sort; Survey; Type; Type All; Unkeywords All.

Reference and conversation operations

Append to Referenced Msg; Concatenate; Concatenate All; Delete Conversation by References; Delete Referenced Msgs; Move in Place of Referenced Msg; Select Conversation by References; Select Referenced Msg.

Output, integration, and session control

Enable Background Process When Deexposed; Gmsgs; Hardcopy All; Hardcopy Msg; Quit; View Original Header; Whois.

The groups account for all 86 definitions. Some named commands call shared ZWEI commands or open secondary menus; some direct bindings such as scrolling use generic ZWEI commands and therefore do not appear in this ZMail-macro denominator.