led.1

.TH LED 1 "2026-09-22" "1.0.7" "User Commands"
.SH NAME
led \- Larry's Editor, a terminal-based text editor
.SH SYNOPSIS
.B led
[\fIoptions\fR] [\fI+line\fR] [\fIfile\fR[\fI:line\fR[\fI:col\fR]]]
.SH DESCRIPTION
.B led
is a terminal-based editor for C and C++ with unlimited undo/redo, auto-save/backups, syntax highlighting, and incremental rendering. Text lives in a subwindow; border only on full repaint.
Open at a compiler location with
.B led +142 file.c
or
.B led file.c:142:8
(1-based).
A name that already exists, colon and all, is opened as itself.
.SH OPTIONS
.TP
.B \-t
Test mode: run model/view/controller tests to stderr, exit.
.SH KEYBINDINGS
.SS Navigation
.TP
.B Arrows, Home/End (×2 top/bottom), PgUp/PgDn
Move and scroll.
.TP
.B Ctrl+Left / Ctrl+Right, Esc b / Esc f
Previous / next word. Ctrl+W deletes the previous word.
.TP
.B Ctrl+]
Jump to the matching parenthesis, bracket, or brace. Strings, comments, and C++ raw strings are skipped.
.TP
.B Ctrl+G
Go to a 1-based line, or line:col. Esc cancels.
.SS Editing
.TP
.B Printable, Enter, Backspace/Delete, Tab, Shift+Tab, Ctrl+Z/Y
Insert, newline, delete, tab, outdent, undo/redo.
Enter at the end of a line copies that line's indent, and adds one level after an opening brace or parenthesis.
.TP
.B Ctrl+K
Toggle a // comment on the current line.
.SS File
.TP
.B Ctrl+S / Ctrl+Q
Save / Quit. Save replaces the file by rename and keeps its mode.
Ctrl+Q on a modified buffer asks for a second Ctrl+Q.
.SS Selection
.TP
.B Ctrl+A / Ctrl+C / Ctrl+X / Ctrl+V
Select all / Copy / Cut / Paste (paste filtered).
.SS Search
.TP
.B Ctrl+/ / Ctrl+R
Search / Replace (regex, wraps to the top).
Ctrl+/ is byte 31, or the modified-key sequence the terminal sends for that chord
(\fCESC [27;5;47~\fR or \fCESC [47;5u\fR). The sequence is not inserted.
.SS Display
.TP
.B F2
Line numbers.
.TP
.B F3
Word wrap.
.TP
.B F4
Border on/off. On: \fCderwin(LINES-2,COLS-2,1,1)\fR boxed. Off: \fCderwin(LINES-1,COLS,0,0)\fR full-width so xterm block-select copies only text. Paste filter strips \fC| │ ─ ┌┐└┘\fR. Config \fCshow_border\fR, env \fCLED_NO_BORDER=1\fR.
.SH WHAT WORKS
.IP \(bu 2
Data safety, undo/redo, autosave, crash recovery.
.IP \(bu 2
Editing, selection, clipboard, regex search/replace, syntax highlight, Unicode, incremental rendering (75x less output).
.IP \(bu 2
Subwindow border + paste-time border filter (replaces \fCtr -d\fR).
.IP \(bu 2
229 tests.
.SH WHAT FAILS
.IP \(bu 2
Whole-file in memory, no mmap; lines >10k truncated.
.IP \(bu 2
Limits hardcoded, errors not standardized, no per-buffer undo persistence.
.IP \(bu 2
No fuzzing, still needs input sanitization, no OSC 52 clipboard.
.IP \(bu 2
xterm copy still sees screen cells — use F4 off.
.SH CONFIGURATION
\fC~/.config/led/colorization.conf\fR (\fCkey=value\fR, \fC#\fR comments). Colors: \fCnormal_fg/bg\fR etc. (\fCBLACK..WHITE\fR). \fCshow_border=0\fR (F4), \fCshow_key_meter\fR, \fCsyntax_extensions\fR, \fCreserved_words\fR, \fCpaired_keywords\fR, \fCtab_width\fR. Env \fCLED_NO_BORDER=1\fR.
.SH FILES
.I ~/.config/led/colorization.conf
.SH SEE ALSO
.BR vim (1),
.BR emacs (1),
.BR nano (1)
.SH AUTHOR
Larry Bruce Daniel
.PP
Assistance from Grok (xAI): grok-code-fast-1 on earlier versions, Grok 4.7 on 1.0.7.
.SH BUGS
https://github.com/refgift/led/issues