Prometheus Assembler Editor Manual

ZX Land #06

PROMETHEUS

Assembler User Manual

Installation

The 48 version of Prometheus can be installed at addresses:

  • from -23296 to 49500 with the monitor
  • from -23296 to 54500 without the monitor

Installer control keys:

  • M — install the monitor (Yes/No)
  • P — background colour (PAPER)
  • I — ink colour (INK)
  • B — increase brightness (BRIGHT)
  • D — font type (Normal/Bold)
  • C — letter case for labels and processor instructions
  • X — set the keypress sound volume:
    • X — quieter
    • Caps Shift — louder

Editor

Terms used in this article:

  • EDIT LINE — the attribute bar in the middle of the screen
  • EDITOR LINE — the bottom line containing the cursor
  • INFORMATION LINE — the top line, displaying information about:
    • errors that have occurred
    • the selected mode, Insert or Overwrite
    • the address of the last byte of source text
    • the address of the last byte available for source text

SS — Symbol Shift
CS — Caps Shift

Note! An expression such as ((SS+R)+b) means that to call a particular function—in this case, RUN b—you must press Symbol Shift together with R, then press B and ENTER.

Editor control keys

  • CS+1 (EDIT) — copy the contents of the edit line to the editor line
  • CS+2 (CapsLock) — turn uppercase letters on or off
  • CS+3 (TrueVideo) — display the next page of source text
  • CS+4 (InvertVideo) — display the previous page of source text
  • CS+5 (LeftCursor) — move the cursor one position left
  • CS+6 (DownCursor) — move the edit line down one position
  • CS+7 (UpCursor) — move the edit line up one position
  • CS+8 (RightCursor) — move the cursor one position right
  • CS+9 (Graphic) — clear the contents of the edit line
  • CS+0 (Delete) — delete the last character in the editor line
  • SS+Q — clear the contents of the editor line
  • CS+SS (ExtendedMode) — mark a block of source text
  • ENTER — confirm a command or send a line
  • SS+E — move the edit line to the end of the source text
  • SS+K — move the edit line to the beginning of the source text
  • SS+H — cycle the number display mode between hexadecimal and decimal
  • SS+W — cycle the program-line entry mode between Insert and Overwrite

Block operations

  • COPY (SS+C) — copy the selected block of source text before the edit line
  • DELETE (SS+D) — delete the selected block of source text

Additional function in the 128 version:

  • COPY m ((SS+C)+m) — move the selected block of source text before the edit line

Search and replace operations

  • FIND:xxx ((SS+F)+:xxx) — search for the string xxx, starting from the position of the edit line
  • FIND — search for the next occurrence of the same string
  • FIND s:xxx ((SS+F)+s+:xxx) — search for the string xxx from the beginning of the source text
  • FIND s — search from the beginning of the source text for the previously defined string
  • FIND b:xxx ((SS+F)+b+:xxx) — search for the string xxx within the selected block of source text
  • FIND b — search for the next occurrence of the same string within the selected block of source text
  • REPLACE:xxx ((SS+Z)+:xxx) — replace the string yyy found by the FIND function with the string xxx
  • REPLACE — replace the next occurrence of the string yyy with the string xxx

Clearing text and setting U-TOP

  • CLEAR y ((SS+X)+y) — clear the source text and symbol table, if the table has not been protected
  • U-TOP number ((SS+U)+number) — set the address of the last byte available for source text and the resulting code

Additional functions in the 128 version:

  • CLEAR f ((SS+X)+f) — quickly clear the source text together with the symbol table, even if the table has been protected
  • S-BEGIN number ((SS+I)+number) — set the lower limit for source text in the banks:
    • bank 1 — addresses 00000/16383
    • bank 3 — addresses 16384/32767
    • bank 4 — addresses 32768/49151
    • bank 6 — addresses 49152/65535

Note! The source text may start in one bank and end in another. For example, it may start at address 8912 (bank 1) and end at address 56782 (bank 6).

  • S-TOP number ((SS+J)+number) — set the upper limit for source text in the banks
  • S-TOP — display information about the set limits for source text

To be continued.

Share your thoughts about the article