- editor.h 39.50 Trust begins to bloom / Routine becomes second nature / Anchored in the storm
- led - Larry's Editor for Linux/Unix Terminal (1.0.8)
- Dedicated to Neal Stephenson's vision of paper-like data safety.
- Author: Larry Bruce Daniel. Assistance from Grok (xAI): grok-code-fast-1 on earlier versions, Grok 4.7 on 1.0.7.
- Data safety: undo/redo (1M-change cap, oldest dropped first; one step per key press, cut, or paste), auto-save with versioned backups, recovery file written when the terminal closes (SIGHUP/SIGTERM). A file that did not load whole (too large, binary, unreadable, not a regular file, or with cut lines) is never written back. Saving through a symlink keeps the link. Rejects files over
max_file_size_mb(default 10MB) or with null bytes, and files whose line cache would passmemory_limit_mb. Cuts lines atmax_line_length. - Editing: insert, newline, backspace/delete, tabs (spaces or
\t), word wrap (F3), select all (Ctrl+A) then copy / cut / Backspace act on the whole buffer, clipboard (Ctrl+C/X/V, multi-line, undoable), regex search (Ctrl+/) and replace (Ctrl+R), syntax highlighting (C/C++ nesting, pre-parsed, per-line cache). - Search chord:
Ctrl+/opens search. Byte 31 still works. foot and xterm modifyOtherKeys (ESC [27;5;47~) and kitty CSI-u (ESC [47;5u) are the same chord, so that sequence is not typed into the buffer. - Display:
F2line numbers,F3word wrap,F4border toggle (see below), status bar (version/time/position/key-metershow_key_meter), Unicode/Cyrillic (arrows, Backspace, Delete, and undo work on whole characters). - Incremental rendering: cursor moves repaint only status line, single-line edits repaint only that row (75x less output);
view_decide()+ nesting cache. - Border handling: text lives in its own pane inside the screen: rows-2 × cols-2 at (1,1) with the border on, rows-1 × cols at (0,0) with it off; border only on
FULLrepaint. Paste-timeborder_filter_dup()strips| + - │ ─ ┌ ┐ └ ┘ ├ ┤ ┬ ┴ ┼ ┃ ━from the ends of each line and drops pure┌──┐lines — replacestr -d. - Config: two files in
~/.config/led/, written on first run with every default as a comment:led.conf(general settings) andcolorization.conf(the eight curses colours by name, the ANSI extended colours byLIGHT_name or number, orDEFAULT;reserved_words,paired_keywords,syntax_extensions,show_key_meter,show_border).--prefix DIRkeeps them inDIR/led/where~/.configis not the place. EnvLED_NO_BORDER=1/LED_SHOW_BORDER. - C/C++ editing:
file:line:coland+Nopen on the diagnostic,Ctrl+Gjumps there,Ctrl+]matches braces, word motions,Ctrl+Ktoggles//, Enter keeps indent, Shift+Tab outdents. Source files show line numbers. - Tests: 363 tests (buffer, undo, clipboard, autosave, view, search wrap, search chord, indent, braces, save, data safety, config files, screen contents, controller actions, colours).
./led -ton your machine. - Paths: a file with
..in its path (../src/file.c) opens. It used to fail. - First frame, resize,
F4: these draw through the same painter as a key press. Before, they showed no status line, dropped word wrap, and cut a line with non-ASCII characters short (sometimes ending in??) until the next key.
- Large files: the whole file is still loaded into memory. There is no lazy load or mmap. led stops when the file exceeds
max_file_size_mb, or when the next line would push the nesting cache pastmemory_limit_mb. The buffer stays empty and the status line saysFile too largeorToo many lines. Raise those keys to accept the cost, or split the file first. - Long lines: a line past
max_line_length(default 10000) is cut on load. The status line saysLong line truncated. Cut lines skip highlighting and use basic rendering. A file with cut lines opens read-only (Ctrl+Sand autosave refuse). Raisemax_line_lengthto edit it. - Limits:
max_file_size_mb(1–100, default 10),memory_limit_mb(1–200, default 50), andmax_line_length(80–100000, default 10000) are keys incolorization.conf. A value outside its range keeps the default. - Language support: highlighting and parsing are built for C/C++; other languages may be incomplete. Turn highlighting off in config if a file fights you. Strings, character literals and comments are left plain: brackets and keywords inside them are not coloured and do not nest. A
paired_keywordspair is used only when both words, or neither, are inreserved_words, so the defaultif-thenis ignored for C andifis coloured as a reserved word. - Error handling: not fully standardized across modules.
- No per-buffer undo persistence across sessions.
- Replace (
Ctrl+R) cannot be undone and clears the undo history. The status line says so. - No fuzzing harness yet. Empty-file, size, null-byte, truncation, and memory-ceiling loads are tested.
- Input sanitization:
is_filename_saferejects only empty names, names over 255 bytes, and control characters. There is no directory-traversal check;..is allowed. - Terminal:
xtermblock-select still copies screen cells — useF4off or filter; no OSC 52 system clipboard. - Other languages: a file such as Python is not highlighted by default. Add its extension to
syntax_extensionsincolorization.conf(for examplesyntax_extensions=.c,.h,.cpp,.py) and it is highlighted with the C rules. - Garbled display: if the screen looks corrupted, press
F4twice (border on, then off again).F4repaints the whole screen.F2is not a repaint key. A file whose extension is not insyntax_extensionsshould need no workaround; if one does, that is a bug to report.
Bugs: size and type (file, head sample), or a gdb ./led backtrace, at https://github.com/refgift/led/issues
The view draws through three functions with one signature, declared in frontend/frontend.h:
mark(x, y, c)— the cell holds characterc(its Unicode number).show(x, y, c)— the cell is seen with qualityc(normal, selection, reserved word, ...) and the cursor rests there.hide(x, y, c)— the cell is blanked withc, a space.
For each cell that changed: mark it and show it, or hide it; finish with a show where the caret is. view/screen.c keeps a grid of cells and sends only the ones that differ.
A front end supplies those three functions plus start, stop, size and read-key. frontend_curses.c is the only file that includes ncurses. frontend_memory.c is a grid the tests read, so what reaches the screen is tested without a terminal. frontend_ansi.c is a stub with notes on how to finish it.
The controller is three functions with one signature too, declared in controller/controller.h:
symbol(action, value)— one action, one key press:symbol(S_INSERT, 'a'),symbol(S_LEFT, 3).macro(action, value)— an action made of several symbols, and one undo step:macro(M_ENTER, 1)is a newline plus the indent.token(action, value)— keys collected into a unit before anything happens (search, replace, go to line,Escthen a key):T_BEGIN, thenT_CHARper character, thenT_DONEorT_CANCEL.
One table in controller.c says which call each key makes. A test, or a recorded macro, is a list of those calls with no keys involved.
C compiler, GNU make (gmake on BSD and other Unix), POSIX regex.h (in libc), and libncursesw for the default front end.
make # builds ./led with the curses front end
make UI=ansi # no ncurses; the ANSI front end is not written yet (make clean first)
make install # installs to /usr/local/bin
make doc # installs led.1
./led file.c
./led +142 file.c # open at a line (compiler output)
./led file.c:142:8 # file:line or file:line:col
./led --prefix DIR file.c # config files in DIR/led, not ~/.config/led
./led -t # test mode (stderr, no curses) — also LED_TEST=1 ./led
man led # after make doc
| Keys | Action |
|---|---|
| Arrows, Home/End (×2 top/bottom), PgUp/PgDn | Navigation |
Ctrl+Left / Ctrl+Right, or Esc then b / f |
Previous / next word (_ counts as part of a word) |
Ctrl+] |
Jump to the matching () [] {} (skips strings and comments) |
Ctrl+G |
Go to line, or line:col |
| Printable, Enter, Backspace/Delete, Tab, Shift+Tab | Insert / delete / outdent |
| Enter at end of line | Copy indent; one extra level after { or ( |
Ctrl+K |
Toggle a // comment on this line |
Ctrl+W |
Delete the previous word |
Ctrl+Z / Ctrl+Y |
Undo / Redo |
Ctrl+S / Ctrl+Q |
Save / Quit (Ctrl+Q again if the buffer is modified) |
Ctrl+A / Ctrl+C / Ctrl+X / Ctrl+V |
Select all / Copy / Cut / Paste (paste is border-filtered) |
Ctrl+/ / Ctrl+R |
Search / Replace (regex, wraps, 100-char limit). Ctrl+/ is byte 31 or the terminal's modified-key sequence |
F2 |
Line numbers |
F3 |
Word wrap |
F4 |
Border on/off (subwindow inset vs full-width; pasted │ stripped) |
Two files in ~/.config/led/, both key=value with # comments: led.conf for general settings and colorization.conf for colours and syntax words. led writes each one on first run if it is missing, with every default shown as a comment; remove the # from a line to change it. An existing file is never rewritten.
Either file may hold any key, so a colorization.conf from before led.conf existed keeps working. led.conf is read last and wins when both set a key.
led --prefix DIR file uses DIR/led/ in place of ~/.config/led/, for systems that keep settings somewhere else.
Colors (the eight curses colours BLACK,RED,GREEN,YELLOW,BLUE,MAGENTA,CYAN,WHITE; the ANSI extended colours as LIGHT_BLUE or BRIGHT_BLUE, and GRAY; DEFAULT for the terminal's own colour; or a number 0–255; any letter case): normal_fg/bg, selection_fg/bg, semicolon_fg/bg, meta_level1..4_fg/bg, reserved_words_fg/bg.
| Number | Curses colour | Number | ANSI extended (led's name) |
|---|---|---|---|
| 0 | BLACK |
8 | GRAY (or BRIGHT_BLACK) |
| 1 | RED |
9 | LIGHT_RED |
| 2 | GREEN |
10 | LIGHT_GREEN |
| 3 | YELLOW |
11 | LIGHT_YELLOW |
| 4 | BLUE |
12 | LIGHT_BLUE |
| 5 | MAGENTA |
13 | LIGHT_MAGENTA |
| 6 | CYAN |
14 | LIGHT_CYAN |
| 7 | WHITE |
15 | LIGHT_WHITE |
BRIGHT_ works wherever LIGHT_ does. Defaults: text WHITE on BLACK, selection BLACK on WHITE, semicolon and reserved words RED, nesting levels 1–4 BLUE, CYAN, GREEN, YELLOW.
Curses names eight colours, 0–7, with no light or dark shade. Colours 8–15 are the ANSI extended set, which a terminal with 16 or more colours adds; curses has no names for them, so LIGHT_ and BRIGHT_ are led's own. On an 8-colour terminal led shows the matching curses colour in bold instead (see curs_color(3x)). A number above what the terminal has falls back to white.
Example, extended colours on the terminal's own background:
normal_bg=DEFAULT
reserved_words_fg=LIGHT_RED
meta_level1_fg=LIGHT_BLUE
meta_level2_fg=LIGHT_CYAN
meta_level3_fg=LIGHT_GREEN
meta_level4_fg=LIGHT_YELLOW
semicolon_fg=208
Give every _bg key the same value, or the background changes from word to word.
Display/Border: show_border=0 (default off, 1 shows box). Toggled by F4.
Other: syntax_extensions=.c,.h,.C,.H,.cpp,.cc,.cxx,.hpp,.hh,.hxx, reserved_words=... (C and C++ keywords), paired_keywords=if-then,begin-end,(,), tab_width=8, spaces_for_tab=0, show_key_meter=1, show_line_numbers=0.
Limits: max_file_size_mb=10 (1–100), memory_limit_mb=50 (1–200), max_line_length=10000 (80–100000). A file over the size or memory ceiling is not opened. A longer line is cut and the status line says Long line truncated. A null byte is refused with Binary file.
Source files (those extensions) show line numbers unless show_line_numbers is set in the config. Ctrl+S replaces the file by rename and keeps its permission bits. Search wraps to the top and says so.
Example:
normal_fg=WHITE
normal_bg=BLACK
selection_fg=CYAN
selection_bg=BLACK
show_key_meter=1
show_border=0
syntax_extensions=.c,.h,.cpp