This is a small help page with an overview of selected functions. Choose from the index below to jump to a help topic.
While typing, press ctrl+space to open a popup with a list of all labels that match
the previous chars to complete and insert a label name. If you did not already started typing before
pressing ctrl+space, all available labels will be shown in the popup. Press Enter
or mouse click on a label to insert it or complete your input.
You can drag & drop files from the file explorer (or finder, nautilus, etc.) into
the editor area to either open them or include them into your source. The drop operation
depends on which modifier keys (shift and control) you hold
down while dropping the selected file(s).
shift and control keys
.a or .asm) will be opened..bin, .c64 or .txt) will be included via
!bin, .import or .binary directive (depending on the assembler).
control key
.a or .asm) will be included via
!src, .import or .binclude directive (depending on the assembler).
.bin, .c64 or .txt) will be included as
byte table (see function Insert bytes from file in Source menu).
shift and control keys
This menu includes typical file operations like opening, saving and closing files. Note that the latest ten recent files can be opened quickly via the Recent files submenu, and that the associated compiler and user script settings will be restored automatically when opening a recent document.
This menu contains the default edit operations like cut, copy, paste, but also undo and redo.
Contains all find and replace operation for current active documents. Both the Find searchterm and the Replace command will open an edit field below the source code window where find and replace terms can be edited.
The Find searchterm function also accepts regular expressions.
Use buttons beside the text fields or menu shortcuts / hotkeys to jump to the next or previous occurence of a searchterm.
Except for the Goto line command, each of the goto commands opens the drop down list at the bottom of the window. The content of this list depends on the context, i.e. the command that opened this list. The Goto label command, for instance, extracts all labels from all currently opened files and lists them in the drop down list. A red heading with the related file name indicates to which file the labels from this list belong. Selecting an item will choose the related file and scrolls the caret to the line containing the label.
The Goto function or Goto macro command work in a similar way, just that the drop down list contains all functions or macros found in all opened files.
The Goto section command lets you choose any section to jump. Section are specific comments on the source code, which can be used to structure your source. See Source menu for more details.
The Goto line command sets the input focus into the text field at the bottom left part, where you can enter any line number. Then the content will scroll to this line.
Unlike the Goto commands, which scroll to a specific label, function, macro... etc., the Jump commands scroll to the next, respectively to the previous occurence of a label, section or error. Next and previous relate to the current caret position.
While the Jump to next/prev label and Jump to next/prev section commands only work when you have labels or sections defined in your source, the Jump to next/prev error command only works after you have compiled a source file that contains errors. In case the assembler stops parsing your source code due to errors, the Compiler log is shown and you can cycle through all errors with the Jump to next/prev error command.
The Jump to label command only works when the caret (cursor) is positioned over a label inside your source code. The command will then scroll to the line where this label is defined.
Running and selecting scripts are menu commands that execute the same as clicking the Run button or selecting an item from the drop down list of the Compile and Run area in the main window.
The Run script command runs the currently selected user script. User script are commands that you would typically type into the console or terminal in order to run compilers, crunchers or emulators. With these scripts you can execute your compiler, cruncher and emulator in order to compile your source code and watch the compiled file in an emulator.
You can set up as much different scripts as you want in order to get various compile and run options. Please refere to the preferences, select the Compile & Run tab and click on the help button for details on user scripts.
With the Select script command the input focus is set to the drop down list with all user scripts. This is a convenience command for quickly switching between scripts using the keyboard.
Select syntax scheme lets you switch between different compiler syntax schemes (e.g. the KickAss syntax differs from ACME and 64tass) in order to correctly highlight keywords, comments, compiler directives etc.
The Toggle comment command comments or uncomments the current selection. Note that this command only works when text is selected.
Insert section inserts a specific command line with a named label, which can be used to structure your source and easily navigate through it (see Navigate menu). Insert separator inserts a simple commented dashed line as separator.
The Insert Basic start command adds a short asm code snippet that adds a Basic line to the compiled source code with a Sys-command to start your code.
Inserts bytes from file reads a file byte-wise and insert all bytes of that file as byte-table. The Insert sinus table command opens an input window where you can specifiy parameters for computing a sinus curve, which will be inserted as byte-table into your source.
With the commands of the View menu, it is possible to switch the position and layout of the log windows and the Compile and Run area. Furthermore, you can quickly show one of the log windows.