Kyle Isom
c864af7daa
Some checks failed
Release / Bump Homebrew formula (push) Has been cancelled
Release / Build Linux amd64 (push) Has been cancelled
Release / Build Linux arm64 (push) Has been cancelled
Release / Build macOS arm64 (.app) (push) Has been cancelled
Release / Create GitHub Release (push) Has been cancelled
- Amber - LCARS - Orbital - Weyland-Yutani - Kanagawa Paper (dark mode extension) Update help text to reflect additions.
291 lines
6.0 KiB
Groff
291 lines
6.0 KiB
Groff
.\" kte(1) — Kyle's Text Editor (terminal-first)
|
|
.\"
|
|
.\" Project homepage: https://github.com/wntrmute/kte
|
|
.TH KTE 1 "2025-12-01" "kte 0.1.0" "User Commands"
|
|
.SH NAME
|
|
kte \- Kyle's Text Editor (terminal-first)
|
|
.SH SYNOPSIS
|
|
.B kte
|
|
[
|
|
.I options
|
|
]
|
|
[
|
|
.I files ...
|
|
]
|
|
.SH DESCRIPTION
|
|
.B kte
|
|
is a small, fast, and understandable text editor with a terminal-first
|
|
experience. It preserves ke's WordStar/VDE-style command model with
|
|
Emacs-influenced ergonomics. The core uses ncurses in the terminal.
|
|
|
|
By default, .B kte
|
|
runs in the terminal (ncurses) frontend. If the binary was built with GUI
|
|
support, the same editor core can be shown with an ImGui-based GUI by passing
|
|
.B --gui
|
|
or by invoking the GUI-first target
|
|
.BR kge (1)
|
|
when available.
|
|
|
|
If one or more
|
|
.I files
|
|
are provided, they are opened on startup; otherwise, an empty buffer is
|
|
created.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -g, --gui
|
|
Use the GUI frontend (if the binary was built with GUI support). If GUI was
|
|
not built, the editor exits with an error.
|
|
.TP
|
|
.B -t, --term
|
|
Use the terminal (ncurses) frontend. This is the default for
|
|
.B kte
|
|
.
|
|
.TP
|
|
.B -h, --help
|
|
Display a brief usage summary and exit.
|
|
.TP
|
|
.B -V, --version
|
|
Print version information and exit.
|
|
.SH KEYBINDINGS
|
|
The command model and keybindings are inherited from
|
|
.I ke
|
|
and are summarized here for convenience. See
|
|
.I docs/ke.md
|
|
in the source tree for the canonical reference and notes.
|
|
|
|
.SS K-commands (prefix Ctrl-K)
|
|
.PP
|
|
Enter K-command mode with Ctrl-K. Exit K-command mode with ESC or Ctrl-G.
|
|
.TP
|
|
.B C-k '
|
|
Toggle read-only for the current buffer.
|
|
.TP
|
|
.B C-k -
|
|
If the mark is set, unindent the region.
|
|
.TP
|
|
.B C-k =
|
|
If the mark is set, indent the region.
|
|
.TP
|
|
.B C-k ;
|
|
Open the generic command prompt (": ").
|
|
.TP
|
|
.B C-k a
|
|
Set the mark at the beginning of the file, then jump to the end of the file.
|
|
.TP
|
|
.B C-k b
|
|
Switch to a buffer.
|
|
.TP
|
|
.B C-k c
|
|
Close the current buffer. If no other buffers are open, an empty buffer will be opened. To exit, use C-k q.
|
|
.TP
|
|
.B C-k d
|
|
Delete from the cursor to the end of the line.
|
|
.TP
|
|
.B C-k C-d
|
|
Delete the entire line.
|
|
.TP
|
|
.B C-k e
|
|
Edit (open) a new file.
|
|
.TP
|
|
.B C-k f
|
|
Flush the kill ring.
|
|
.TP
|
|
.B C-k g
|
|
Go to a specific line.
|
|
.TP
|
|
.B C-k h
|
|
Show the built-in help (+HELP+ buffer).
|
|
.TP
|
|
.B C-k j
|
|
Jump to the mark.
|
|
.TP
|
|
.B C-k l
|
|
Reload the current buffer from disk.
|
|
.TP
|
|
.B C-k n
|
|
Switch to the previous buffer.
|
|
.TP
|
|
.B C-k o
|
|
Change working directory (prompt).
|
|
.TP
|
|
.B C-k p
|
|
Switch to the next buffer.
|
|
.TP
|
|
.B C-k q
|
|
Exit the editor. If the file has unsaved changes, a warning will be printed; a second C-k q will exit.
|
|
.TP
|
|
.B C-k C-q
|
|
Immediately exit the editor.
|
|
.TP
|
|
.B C-k r
|
|
Redo changes.
|
|
.TP
|
|
.B C-k s
|
|
Save the file, prompting for a filename if needed.
|
|
.TP
|
|
.B C-k u
|
|
Undo.
|
|
.TP
|
|
.B C-k v
|
|
Toggle visual file picker (GUI).
|
|
.TP
|
|
.B C-k w
|
|
Show the current working directory.
|
|
.TP
|
|
.B C-k x
|
|
Save the file and exit. Also C-k C-x.
|
|
.TP
|
|
.B C-k y
|
|
Yank the kill ring.
|
|
.TP
|
|
.B C-k C-x
|
|
Save the file and exit.
|
|
|
|
.SH GUI APPEARANCE
|
|
When running the GUI frontend, you can control appearance via the generic
|
|
command prompt (type "C-k ;" then enter commands):
|
|
.TP
|
|
.B : theme NAME
|
|
Set the GUI theme. Available names: "amber", "eink", "everforest", "gruvbox", "kanagawa-paper", "lcars", "nord", "old-book", "orbital", "plan9", "solarized", "weyland-yutani", "zenburn".
|
|
Compatibility aliases are also accepted: "gruvbox-dark", "gruvbox-light",
|
|
"solarized-dark", "solarized-light", "eink-dark", "eink-light",
|
|
"everforest-hard", "oldbook", "old-book-dark", "old-book-light",
|
|
"kanagawa", "kanagawa-light", "kanagawa-paper-light", "vim-amber", "weyland".
|
|
.TP
|
|
.B : background MODE
|
|
Set background mode for supported themes. MODE is either "light" or "dark".
|
|
Themes that respond to background: eink, gruvbox, kanagawa-paper, old-book, solarized. The
|
|
"lcars", "nord" and "plan9" themes do not vary with background.
|
|
|
|
.SH CONFIGURATION
|
|
The GUI reads a simple configuration file at
|
|
~/.config/kte/kge.ini. Recognized keys include:
|
|
.IP "fullscreen=on|off"
|
|
.IP "columns=NUM"
|
|
.IP "rows=NUM"
|
|
.IP "font_size=NUM"
|
|
.IP "theme=NAME"
|
|
.IP "background=light|dark"
|
|
The theme name accepts the values listed above. The background key controls
|
|
light/dark variants when the selected theme supports it.
|
|
|
|
.SS Other keybindings
|
|
.TP
|
|
.B C-g
|
|
Cancel the current operation.
|
|
.TP
|
|
.B C-a
|
|
Move to the beginning of the line.
|
|
.TP
|
|
.B C-e
|
|
Move to the end of the line.
|
|
.TP
|
|
.B C-b
|
|
Move left.
|
|
.TP
|
|
.B C-f
|
|
Move right.
|
|
.TP
|
|
.B C-n
|
|
Move down.
|
|
.TP
|
|
.B C-p
|
|
Move up.
|
|
.TP
|
|
.B C-l
|
|
Refresh the display.
|
|
.TP
|
|
.B C-d
|
|
Delete the character at the cursor.
|
|
.TP
|
|
.B C-r
|
|
Regex search.
|
|
.TP
|
|
.B C-s
|
|
Incremental find.
|
|
.TP
|
|
.B C-t
|
|
Regex search and replace.
|
|
.TP
|
|
.B C-h
|
|
Search and replace.
|
|
.TP
|
|
.B C-u
|
|
Universal argument. C-u followed by numbers will repeat an operation n times.
|
|
.TP
|
|
.B C-w
|
|
Kill the region if the mark is set.
|
|
.TP
|
|
.B C-y
|
|
Yank the kill ring.
|
|
.TP
|
|
.B ESC <
|
|
Move to the beginning of the file.
|
|
.TP
|
|
.B ESC >
|
|
Move to the end of the file.
|
|
.TP
|
|
.B ESC m
|
|
Toggle the mark.
|
|
.TP
|
|
.B ESC BACKSPACE
|
|
Delete the previous word.
|
|
.TP
|
|
.B ESC b
|
|
Move to the previous word.
|
|
.TP
|
|
.B ESC d
|
|
Delete the next word.
|
|
.TP
|
|
.B ESC f
|
|
Move to the next word.
|
|
.TP
|
|
.B ESC q
|
|
Reflow the paragraph to 72 columns or the value of the universal argument.
|
|
.TP
|
|
.B ESC w
|
|
Save the region (if the mark is set) to the kill ring.
|
|
.SH ENVIRONMENT
|
|
.TP
|
|
.B TERM
|
|
Specifies terminal type and capabilities for ncurses.
|
|
.TP
|
|
.B LANG, LC_ALL, LC_CTYPE
|
|
Determine locale and character encoding.
|
|
.SH FILES
|
|
.TP
|
|
.I ~/.kte/
|
|
Future configuration directory (not yet stabilized).
|
|
.SH EXIT STATUS
|
|
Returns 0 on success, non-zero on failure.
|
|
.SH EXAMPLES
|
|
.TP
|
|
Edit a file in the terminal (default):
|
|
.RS
|
|
.nf
|
|
kte README.md
|
|
.fi
|
|
.RE
|
|
.TP
|
|
Force GUI frontend (if available):
|
|
.RS
|
|
.nf
|
|
kte --gui main.cc
|
|
.fi
|
|
.RE
|
|
.SH SEE ALSO
|
|
.BR kge (1),
|
|
.I docs/ke.md
|
|
(project keybinding manual)
|
|
.br
|
|
Project homepage: https://github.com/wntrmute/kte
|
|
.SH BUGS
|
|
Incremental search currently restarts from the top on each invocation; see
|
|
\(lqKnown behavior\(rq in the ke manual. Report issues on the project tracker.
|
|
.SH AUTHORS
|
|
Kyle (wntrmute) and contributors.
|
|
.SH COPYRIGHT
|
|
Copyright \(co 2025 Kyle. License as per project repository.
|
|
.SH NOTES
|
|
This page documents kte version 0.1.0.
|