2022-02-16 19:24:35 -05:00
|
|
|
---- femto text editor ----
|
2022-02-08 01:16:06 -05:00
|
|
|
|
|
|
|
|
based on nano.
|
|
|
|
|
|
|
|
|
|
draws graphics using ANSI control sequences.
|
|
|
|
|
|
|
|
|
|
this means the terminal must be in raw mode with echo
|
|
|
|
|
turned off. the `femto` wrapper script achieves this
|
|
|
|
|
using `sttry raw -echo` (it also restores the previous
|
|
|
|
|
terminal settings on exit).
|
|
|
|
|
|
2022-03-24 01:39:39 -04:00
|
|
|
---- WARNING ----
|
|
|
|
|
|
|
|
|
|
this is alpha quality software, still under active
|
|
|
|
|
development. although it seems to work fairly reliably
|
|
|
|
|
it has bugs!
|
|
|
|
|
|
|
|
|
|
please consider making backups (or using version control)
|
|
|
|
|
before femto this to modify important files.
|
|
|
|
|
|
|
|
|
|
---- getting started ----
|
|
|
|
|
|
2022-02-16 19:24:35 -05:00
|
|
|
you must provide a path to a file when starting femto:
|
|
|
|
|
|
|
|
|
|
./femto femto.tal
|
|
|
|
|
|
2022-03-23 23:03:20 -04:00
|
|
|
the femto launcher script makes many assumptions:
|
|
|
|
|
|
|
|
|
|
- uxnasm and uxncli are both in the PATH
|
|
|
|
|
- femto.tal is in the same directory as femto
|
|
|
|
|
- femto.rom should be (re)assembled every time
|
|
|
|
|
- femot.rom should be written in the same directory
|
|
|
|
|
|
|
|
|
|
once femto is not in active development a more robust
|
|
|
|
|
packaging process can be explored.
|
|
|
|
|
|
2022-03-24 01:39:39 -04:00
|
|
|
---- current status ----
|
2022-02-16 19:24:35 -05:00
|
|
|
|
2022-03-25 00:15:42 -04:00
|
|
|
- can't create new files that don't already exist
|
2022-03-23 23:03:20 -04:00
|
|
|
- can't create new directories while saving
|
|
|
|
|
- doesn't support horizontal scrolling for long lines
|
2022-02-08 01:16:06 -05:00
|
|
|
- no search (or search&replace)
|
2022-03-25 00:15:42 -04:00
|
|
|
- no copy/paste
|
2022-03-23 23:03:20 -04:00
|
|
|
- few help messages
|
2022-03-24 01:35:35 -04:00
|
|
|
- doesn't support function keys, mouse, etc.
|
2022-03-23 23:03:20 -04:00
|
|
|
|
2022-03-24 01:39:39 -04:00
|
|
|
---- status line ----
|
2022-03-23 23:03:20 -04:00
|
|
|
|
|
|
|
|
the femto status line contains a lot of information:
|
|
|
|
|
|
|
|
|
|
1. if the file has unsaved changes (**) or not (--)
|
|
|
|
|
2. the file name (e.g. "scratch.tal")
|
|
|
|
|
3. the number of bytes/lines (e.g. "[49 bytes, 8 lines]"
|
|
|
|
|
4. the x/y cursor position (e.g. "(1,8)" for col 1, row 8)
|
2022-03-26 15:30:38 -04:00
|
|
|
5. whether tabs ("[t]") or spaces ("[s]") are inserted by tab key
|
2022-02-16 19:24:35 -05:00
|
|
|
|
2022-03-24 01:39:39 -04:00
|
|
|
---- special key bindings ----
|
2022-02-16 19:24:35 -05:00
|
|
|
|
2022-03-30 01:26:09 -04:00
|
|
|
C-g cancel (used with commands like save, search, etc.)
|
2022-03-23 23:03:20 -04:00
|
|
|
C-o save
|
2022-02-16 19:24:35 -05:00
|
|
|
C-x quit
|
2022-02-08 01:16:06 -05:00
|
|
|
|
2022-03-25 00:15:42 -04:00
|
|
|
C-b move back one character (or LEFT ARROW)
|
|
|
|
|
C-f move forward one character (or RIGHT ARROW)
|
|
|
|
|
C-n move down one line (or DOWN ARROW)
|
|
|
|
|
C-p move up one line (or UP ARROW)
|
|
|
|
|
M-v page up (or PAGE DOWN)
|
|
|
|
|
C-v page down (or PAGE UP)
|
2022-02-16 19:24:35 -05:00
|
|
|
|
2022-03-25 00:15:42 -04:00
|
|
|
C-a go to beginning of line (or HOME)
|
|
|
|
|
C-e go to end of line (or END)
|
2022-02-16 19:24:35 -05:00
|
|
|
M-< go to start of file
|
|
|
|
|
M-> go to end of file
|
2022-03-24 00:09:55 -04:00
|
|
|
M-g go to line
|
2022-03-26 15:30:38 -04:00
|
|
|
C-l center screen on cursor line
|
2022-02-16 19:24:35 -05:00
|
|
|
|
|
|
|
|
C-d delete
|
2022-03-24 01:35:35 -04:00
|
|
|
M-c toggle color scheme
|
2022-03-25 00:15:42 -04:00
|
|
|
M-t toggle tabs-vs-spaces indentation
|
2022-03-24 01:35:35 -04:00
|
|
|
C-l refresh screen (DEBUG)
|
2022-02-16 19:24:35 -05:00
|
|
|
|
|
|
|
|
(C stands for Control)
|
|
|
|
|
(M stands for Meta, often Alt or Option)
|
