EBM S/800 - USER MANUAL

This User Manual may not yet cover all features.

The guide covers the following subjects, click an item in the list or scroll. Or Click itch.io to download.

EDITOR MODE

For clipboard see section Scratch Clipboard and Mnemonic Clipboards.

F2+CTRL - Cycle through all four Status Bar modes.

INSERT - Toggle Insert/Overtype Mode. Status bar will display INS or OVR

NUM LOCK - Toggle Number Lock Mode. Status bar will highlight NUM when set. Both 2 and 5 move down, meaning 8 and 4/5/6 provide all four arrow keys in the now expected inverted T formation.

CAPS LOCK - Toggle Capital Letter Lock Mode. Status bar will highlight CAP when set.

SCROLL LOCK - Toggle Scroll Lock Mode. Status bar will highlight SCR when set. In Scroll Lock Mode, the arrow keys, PGUP/PGDN and HOME/END scroll the view window without moving the cursor. Toggle off to return to your original view and edit text.

CTRL+Q - Toggle Query Mode line number margin.

F5/CTRL+F5 - Jump forward/back through previous Find Mode search results.

SHIFT+UP/DOWN/LEFT/RIGHT/HOME/END - Select text.

CTRL+A - Select All.

CTRL+Z/Y - Undo/Redo.

CTRL+UP/DOWN - Jump to start of previous/next line.

CTRL+SHIFT+UP/DOWN - Jump to previous/next section, as defined in language pack.

CTRL+1/2/3/4 - Change case of selection: Lower, Upper, Sentence, Title.
Designed to be easy to remember: 1 is the lowest number, hence Lowercase. Upper/lower work together, hence 2 is Uppercase. 3 is above the S key on most keyboards, and S is for Sentence. 4 is close to T, and T is for Title.

CTRL+D - Duplicate current line or all selected lines.
CTRL+SHIFT+D - Delete line or lines.

CTRL+L - Select current line. Repeat to extend selection.
CTRL+SHIFT+L - Extend selection upwards.

CTRL+J/CTRL+SHIFT+J - Jump to next or previous matching word or character, depending on cursor position or selection.

CTRL+G - Go to line number.

CTRL+I - Invert Selection. IMPORTANT: The S/800 uses a non-standard ASCII sequence. Characters 128-255 are the first 128 characters inverted. The Invert Selection feature highlights an area of text by adding 128 to each character. This feature is useful for highlighting words and phrases in note documents that you intend to open only in the S/800. You may be able to use this feature in comments in your code.

CTRL+SHIFT+I - Rather than toggle the selection, these keys deduct 128 from all characters with a value greater than 127. Toggling would make uninverting many scattered inversions tedious.

Editor Mode rows

To change the number of Editor Mode rows, up to a maxium of 99, type EDIT INI in Terminal Mode, then edit the S800.ini file in Editor Mode: under the [EDIT] header, enter e.g. ROWS=99

EDITOR MODE: FILE MANAGEMENT

The EBM S/800's Editor Mode does provide some degree of file management.

Type F2 to ensure you are in Editor Mode. Note the Status Bar along the bottom of the editing screen.

CTRL+N - Create a new text document with extension .txt, use Save As if you require an alternate extension such as .h or .cpp The free edition allows up to 4 open documents; the Executive Edition allows up to 32.

CTRL+S - Save the currently viewed document.

CTRL+SHIFT+S - Save As, type the new filename in the Status Bar.

CTRL+SHIFT+A - Save All, saves all open documents. Untitled documents will not be saved.

CTRL+SHIFT+R - Reload, the open copy of the document will be replaced by the file stored on the disk.

CTRL+W - Close, closes the document.

ALT+PGUP/PGDN/HOME/END - Cycle between open documents.

ALT+CTRL+PGUP/PGDN/HOME/END - Reorder open documents, e.g. move document to end.

EDITOR MODE: SECTION JUMP

In Editor Mode, type CTRL+SHIFT+UP/DOWN to jump to the previous/next document section, based on definitions in your .8pk language pack definition documents.

Sections might be functions, subroutines, labels, or even chapters in a story, for example.

Several pre-defined sections are available. In a language which uses C-style functions, you can simply include the following line in the language pack:

[SECTION_TYPE:FUNCTION-C]

At present, the following pre-defined sections exist, though more can be made available on request:

FUNCTION-C
CLASS-CSHARP
METHOD-CSHARP
INTERFACE-CSHARP
ENUM-CSHARP
METHOD-JAVA
CLASS-JAVA
INTERFACE-JAVA
ENUM-JAVA

You can define your own section types, using an asterisk to mean any combination of characters, and one of two tag types: [SECTION_USERDEF_CLMN#] where # is the column number, and [SECTION_USERDEF_CLMN_ANY] where the header may start in any column. Consider the following examples.

[SECTION_USERDEF_CLMN0:<*:>] - must start in the first column and consist of text (e.g. label name) followed by a colon, followed by nothing. Example:
myLabel:

[SECTION_USERDEF_CLMN1:<*:*>] - must start in the second column and consist of text (e.g. label name) followed by a colon, which can then be followed by more text. Example:
myLabel: blah

[SECTION_USERDEF_CLMN_ANY:<FUNCTION *(*>] - can start in any column and consist of the word FUNCTION followed by any further text, followed by an opening round bracket, followed by any further text. Note that in this example, the algorithm looks for the first line only; the other lines are assumed:
FUNCTION myFunction(int myParam
                  int maybeAnotherParamHere
                  int andAnotherHere)

EDITOR MODE: FIND/REPLACE

The EBM S/800's Editor Mode may seem confusing at first, but it has been designed to be both powerful and efficient. The keystrokes will soon become second nature.

Let's start with a quick overview.

You'll be typing your Find/Replace text in the Status Bar, then using PGUP/PGDN/HOME/END to jump between matches. When entering this sub-mode, optionally hold one or both of two Control Keys to affect the search: SHIFT forces case sensitive mode (this makes sense, because you're used to using SHIFT to control case when you type) ... CTRL forces Whole Word Match. Certain key combinations then execute replacement.

Here follows the full list of keystrokes:

CTRL+F - Enter Find/Replace Mode. A cursor will appear in the Status Bar. If text has been selected in the document, S will be shown in the Status Bar to indicate that the EBM S/800 will search only the selected text. Otherwise, A will be shown in the Status Bar, indicating that all of the document will be searched.

TAB - Toggle Find Text Mode and Replace Text Mode. The letter F or R will be shown in the Status Bar. Enter text to find in Find Text Mode, optionally enter replace text in Replace Text Mode.

PGUP/PGDN/HOME/END - Search the document, e.g. PGDN will jump to the first match after the cursor. The Status Bar will show the match index and counter, for example 3/5 will indicate the third of five matches.

When typing PGUP/PGDN/HOME/END to search, hold SHIFT to activate case sensitive Exact Match Mode, ↑ will be shown in the Status Bar, hold CTRL to activate Whole Word Match mode, # will appear in the Status Bar.

CTRL+R - Replace, replaces the current match with the Replace text.

CTRL+A - Replace All, replaces all matches in the document with the Replace text.

CTRL+SHIFT+A - Replace All In Language, replaces all matches in all documents of the same language type.

CTRL+SHIFT+ALT+A - Replace All Across All, replaces matches in all documents of all language types.

EDITOR MODE: CLIPBOARD

The EBM S/800's Scratch Clipboard will be familiar to Windows users.

CTRL+C - Copy to Scratch Clipboard.

CTRL+X - Cut to Scratch Clipboard.

CTRL+V - Paste contents of Scratch Clipboard.

Both EBM S/800 editions include multiple Mnemonic Clipboards. These clipboards are tied to letters of the alphabet, and triggered by the respective keys. You might store the phrase "Extra life" in the X key, for example.

The free edition features 8 Mnemonic Clipboards, tied to keys A-H. The Executive Edition features A-Z.

CTRL+ALT with letter - Copy selected text to chosen Mnemonic Clipboard.

CTRL+SHIFT+ALT with letter - Cut to chosen Mnemonic Clipboard. Text will be stored to the clipboard and deleted from the document.

ALT with letter - Mnemonic clipboard paste.

EDITOR MODE: MULTI-LINE TAB AND EXTENDED TAB MODE

In Editor Mode, type TAB to increase tab indent, CTRL+TAB to decrease tab indent. To change the indent on multiple lines, first select multiple lines by holding SHIFT and navigating with the arrow keys.

In Terminal Mode, the TAB command sets the default tab size. For example, TAB 5 sets the default tab size to five spaces.

Executive Edition includes Extended Tab Mode for more precise control, allowing you to set tabs individually.

In Editor Mode, type CTRL+SHIFT+TAB to enter Extended Tab Mode.

The Status Bar will show a tab editing rule.

LEFT/RIGHT - Navigate left and right along rule.

SPACE - Set or unset a tab position. Tab positions cannot be consecutive.

ENTER - Save Extended Tab Mode settings.

ESC - Cancel without saving.

Extended Tab Mode settings apply only to the active language.

Default tab settings are overridden by Extended Tab Mode settings.

To remove Extended Tab Mode settings, enter Extended Tab Edit Mode and remove all tabs, or edit the file S800.ini

EDITOR MODE: BRACKET MATCH MODES

Editor Mode includes two Bracket Match Modes.

Visual Bracket Match Mode highlights bracket pairs as you edit. Move the cursor onto a bracket and the matching bracket will be highlighted. This feature applies only when the active language has Bracket Match Mode enabled for the bracket type. Check the .8pk files in your pack folder. Type CTRL+M to enable/disable this mode for the current language.

Bracket Match Locate Mode enables you to manually locate the off-screen bracket that matches a known bracket. To enter Bracket Match Locate Mode, move the cursor onto a known bracket and type CTRL+SHIFT+M. Type ESC to exit.

The S/800 will locate the matching bracket. The Status Bar will show the coordinates of both brackets, together with your cursor's coordinates relative to each bracket, updating the values as you move.

The first two values show the opening bracket's actual and relative position. The second two values show the closing bracket's actual and relative position. The Status Bar also shows the cursor's current position.

For example, if the known bracket is the opening bracket, and the closing bracket's second pair of digits shows -5, -8, move the cursor down 8 and right 5 to locate the bracket.

EDITOR MODE: LINE NUMBER MARGIN MODE

Type CTRL+Q in Editor Mode to toggle Line Number Margin Mode.

The minimum number of columns can be configured per language type in the EBM S/800's .ini file under [EDIT-LINENUMBER], for example <c>=<00000> defaults to five columns for .c files, <txt>=<000> defaults to three columns for .txt files. The margin expands automatically for documents that exceed the minimum.

Note that the stated language is a language defined in a language pack, not the file extensions relevant to a particular language, for example <c>=<00000> will be ignored if a language pack for the C language is not included in the pack folder.

EDITOR MODE: SUGGEST MODULE

Suggest Mode suggests words as you type. When you type two or more letters, the EBM S/800 suggests matching words in the Status Bar. An UP ARROW indicates that the displayed text is a suggestion.

ALT+LEFT/RIGHT - Cycle through suggestions.

ALT+UP - Accept suggestion.

Suggest is one of several optional Modules, some of which are installed by default and some of which must be installed. Suggest Mode is available only in Editor Mode.

For general usage, you can stop reading here. Just work as you will, and when the S/800 suggests a word, consider accepting the word.

EDITOR MODE: SUGGEST MODULE - ADVANCED

Suggested words are tied to languages. But what is a language? Consider the following concepts:

So what is a dictionary? There are two types.

Let's assume that your language pack folder contains a Language Pack definition file for the C language only. And let's assume that you have six documents open: four C language documents (two .h and two .c, which are linked by the C language definition file), and two BASIC documents, both with the extension .bas

Type a word in one of the .h or .c documents, and the word is added to the C language's Dynamic Dictionary. Type a word in a BASIC document and the word is added to the BASIC language's Dynamic Dictionary - even though no language pack for BASIC documents exist.

To define a language, simply create a new .8pk file. Open folder pack and study files with extension .8pk Reboot the S/800.



Responsible coders code while listening to Supertramp.