ULTIMATEEXPERIMENTSCommodore 64 · Work in progress

SuperEditor user guide

SuperEditor edits raw PETSCII source on a C64 with a REU. Its four editable views share one document, selection, clipboard and Undo history. Formatted GEOS preview is a separate, read-only view of that same source.

This guide describes the current standalone working release, including the qualified three-page F6 guide.

Start and open a file

Attach the complete SuperEditor D81 as drive 8 and enable a REU. The complete font package works with 2 MiB for the tested small-document workflow; larger tests use 16 MiB. It does not start with 512 KiB. See capacity.

LOAD"SUPEREDITOR",8,1
RUN

Keep the overlay and font files on the disk. Startup and some operations at 1 MHz can take a substantial time; see performance and remaining latency. The editor uses C64 key names below. A host emulator's PC keyboard mapping may differ; these instructions are not a claim about every physical key chord.

Press CTRL-O, or F1, F, O, to open a file. Type a PETSCII filename or select one with up/down, then press Return. Files are raw PETSCII SEQ text with CR line endings, not tokenized BASIC PRGs or UTF-8 Markdown.

F1 opens the menu bar. Choose a heading and item by its cyan/yellow displayed letter, or use left/right, up/down and Return. The attached yellow child menu meets the menu bar at PETSCII T junctions; its lower corners are the PETSCII rounded corner cells. RUN/STOP closes the current menu or prompt. For example, F1, V, H selects GEOS and F1, V, S opens Settings.

Menu Available actions
File Open, Save, Save As
Edit Undo, Redo, Delete next character, Clear Undo/recover
View 40/60/80 columns, GEOS, wrap, pan, preview/source, settings
Navigate Up/down, pages, line/document ends,40-character jumps, words, GOTO, Find/next
Block Mark, copy, cut, paste, fold toggle, collapse all, expand all
Help Keyboard/SuperMark guide, document diagnostics

F7 opens a typed command line. Return executes; RUN/STOP cancels. Commands are case-insensitive. Representative commands, including aliases without dedicated menu items, are:

mode 40          mode 60          mode 80          mode hires
home             end              top              bottom
up               down             page up          page down
jump -40         jump +40         word left        word right
goto 25          find text        findi text       next match
mark             copy             cut              paste
undo             redo             delete           clear undo
wrap             wrap on          wrap off
pan left         pan right
open             save             save as
fold             fold all         unfold all
preview          source           settings         diag
syntax plain     syntax markdown  syntax full

F8 cycles 40→60→80→GEOS; CTRL-F8 cycles in reverse. The 40-column view uses native cells;60/80 use narrower bitmap text; editable GEOS uses proportional BSW text and fixed-width code. All keep source markers visible and editable. There is no source formatting command on CTRL-B or CTRL-I, and no quit command.

Edit, navigate and select

C64 key Action
Printable keys / Return Insert source text / CR newline
DEL / SHIFT-DEL Delete previous character / insert a space
Cursors Move caret; up/down preserve the preferred horizontal position
HOME / CTRL-E Beginning / end of the logical CR-delimited source line
SHIFT-HOME Top of document
F3 / F5 or CBM-Up / CBM-Down Previous / next page
CBM-Left / CBM-Right Move backward / forward 40 characters within the source line
CTRL-A / CTRL-W Previous / next word
CTRL-G GOTO prompt; line numbers start at 1
CTRL-F / CTRL-N Find prompt / next match
F2 Mark/unmark; move the caret to extend a selection
CTRL-C or CTRL-K Copy selection
CTRL-X / CTRL-V Cut / paste
CTRL-Z / CTRL-Y Undo / redo
CBM-F Toggle the region containing the caret between folded and expanded
CBM-D / CBM-E Collapse / expand the region containing the caret
CBM-S Open session Settings directly
RUN/STOP Clear selection or close the current popup/prompt

Use Edit→D or F7 delete for forward deletion. A selection refers to canonical source bytes, including markup and collapsed text. Copy preserves it; cut and replacement operate on those bytes. Paste replaces an active selection.

find text searches literally; findi text ignores case. next match repeats the search. GOTO uses logical line numbers, so soft wrapping does not add lines. A GOTO or match inside a collapsed block opens its containing folds.

Undo/Redo history is finite. A new edit after Undo discards the redo branch; opening another document starts a fresh history. clear undo deliberately clears history and should not be used when you still need those edits.

F4 toggles soft wrapping without inserting CRs. pan left/right enables the unwrapped view and moves 20 columns in text modes or 20 pixels in GEOS. Manual panning can hide the caret; ordinary source navigation reveals it again.

Choose source processing and preview appearance

The presets change display processing, not document bytes:

F7 command Source behavior
syntax plain or syntax off Literal source, no syntax parser or code-token coloring; folds shown expanded
syntax markdown SuperMark structure and inline styles, uniform code color
syntax full or syntax on SuperMark plus BASIC/assembler token colors

Plain preserves stored collapse choices for the other presets. Formatted preview remains an explicit formatting view even with Plain selected; its code-token colors are enabled only in Full.

Open CBM-S, F1, V, S, or F7 settings in any mode. Settings affect formatted preview; editable GEOS keeps its established source fonts.

Settings key Action
1–8 or up/down Select Body, H1–H6 or Code profile
F / S Next font family / next supported size within that family
C / G Cycle ink / paper color
B / I / U Toggle bold / italic / underline for that profile
H Cycle Plain→Markdown→Full source processing
R Reset all appearance and source-processing settings to compiled defaults
Return / RUN/STOP Close; already applied choices remain applied

Settings are session-only. Restart restores the compiled defaults; Save does not write appearance into the source file. Numeric sizes/colors use C64 hexadecimal notation: $18 means 24, $0A means 10. Fonts have genuine supplied sizes, not arbitrary scaling. Code offers only the supported fixed-width faces. See the font catalog and C64 color-cell rules. Settings/H changes processing; View/H selects the GEOS view.

Formatted preview

Select GEOS, then F1, V, P or F7 preview. Preview hides confirmed formatting controls and uses the heading/body/code profiles. Unmatched inline delimiters stay literal. It does not edit or replace the saved source.

In preview, F3/F5 or up/down change pages; HOME returns to the top. Return or RUN/STOP returns to editable source. F7 source and View/P toggle between source and preview in GEOS. F8 switches mode and returns to source. Preview is not available in the 40/60/80-column modes.

Menus, Help and Settings remain available. Closing Settings opened from preview returns to preview. Typing, deletion, cut/paste and Undo cannot mutate source while preview is active. Preview currently retains 32 page-back starts; it does not yet provide word-aware wrapping or editing inside formatted text.

Write SuperMark

SuperMark is PETSCII Markdown-lite. The examples below are readable host transcriptions; use the C64's native characters in the document.

Form Meaning
# Title … ###### Title Heading levels 1–6, starting in column zero with a following space
**bold**, *italic*, ***both*** Matched emphasis; may be nested within supported parser limits
@@code@@ Inline code; no emphasis or pound escapes inside it
- item, * item Bullet list item
1. item, 27. item Numbered item; supplied numbers are preserved, not renumbered
:::basic, :::asm, :::text Fenced BASIC V2, 6502/6510 assembler, or plain code
:::region Title … :::end Explicit nested region
£*, £#, £@, ££ Contextual literal syntax escapes using the native pound key

Indent with spaces; typed Tab does not expand into four-column stops. Lists recognize two-space indentation through three nested levels. Block markers start in column zero; indented colon strings do not open fences. A leading * is a bullet marker, not italic markup. Inline styles end at CR; unmatched markers remain literal while typing. BASIC/assembler colors are lexical assistance, not compilation or validation. Unknown code-language labels use plain code.

A fence opens with 3–15 colons and closes on a line containing exactly the same number of colons, without a label or trailing text. To include a literal three-colon line, use a longer fence:

::::text
A literal closing-looking line:
:::
::::

A region uses exactly :::region and :::end; regions can nest. For example:

# Notes
A **strong** idea and @@lda #0@@.
:::region Example
:::basic
10 PRINT "HELLO"
20 GOTO 10
:::
:::end

The native pound character (£, PETSCII $5C) replaces Markdown's backslash. It escapes # * - . : @ £ only where the following character would be syntax; for example, £# Title at line start is literal. Currency such as £5 stays literal. Escapes are disabled inside fenced/inline code.

There is no underscore emphasis, backtick/tilde fence or backslash escape syntax. Links, images, HTML, tables and block quotes are unsupported and stay literal. There is no JSON highlighting. Return inserts CR, not a host LF; source views preserve imported unsupported control bytes as data with visible markers. Changing views never renumbers lists or rewrites the source.

Fold without losing source

Heading sections (through the next equal or higher heading), fenced code and explicit regions can collapse. Place the caret in the desired unit and use Block/F or F7 fold; repeat to expand it. Use fold all or unfold all for the document. There is no standalone unfold command.

A collapsed unit keeps its summary/opener with an inverse +. Arrow/page navigation skips the hidden body; direct GOTO/find reveals it. Selection and copy/cut still include the hidden source. No hidden-line count or delete confirmation is shown, so check the selection before a destructive edit.

Incomplete fence/region syntax during editing makes automatic fold retention fall back to expanded source. You can keep typing and use Undo. Explicit fold all still reports malformed fold syntax; it does not silently accept it.

Save and handle a file dialog

CTRL-S or F1, F, S saves. An unnamed document opens Save As; F1, F, A always asks for a new name. Filenames allow up to 16 native bytes. In the dialog:

Opening over a dirty document asks S to save, D to discard or C to cancel. Saving an unnamed document first asks for a name, then resumes the Open. The clipboard survives opening another file; the document's Undo history does not.

Save writes and verifies a staged file before replacing the target, retaining recovery candidates when DOS status is uncertain. It needs temporary free disk space as well as room for the final file. On an error, read the dialog and keep the disk attached until cleanup finishes; cancelling does not imply a save completed. If a recovery dialog offers K, that explicitly keeps the precise candidate files on disk. It is not a generic success acknowledgement.

A capacity error refuses an edit before changing source or pending text; existing Undo remains usable. Source quota, append/history storage, object slots and disk space are separate finite resources. See capacity and tested limits. A D81 is 819,200 bytes including its filesystem and cannot store a 1 MiB document.

Help and current limits

F6 opens a three-page guide: keyboard/routes, inline/list syntax and blocks/fences. F3/F5 wrap between guide pages; F6 or RUN/STOP closes it and restores the source or preview. Help/D or F7 diag opens document diagnostics. The normal source F3/F5 page keys are unchanged when Help is closed.

General reflow, cold startup and some far navigation/editing are still slow. The 1 MiB capacity result is a bounded CPU/source-engine test, not a 1 MiB native D81 save claim. See current performance, capacity, preview limitations and memory/standalone adapter scope. ReadyOS integration and UltimateDOS file access are future adapters; the current standalone file workflow is drive 8/9 D81. This guide does not claim those adapters or general performance work complete.