jupp cheat sheet

Joe's Own Editor, portable fork · v3.1jupp · mirbsd.org/jupp

WordStar-style keys, modeless, tiny, runs almost anywhere. ^ means Ctrl.

Only key to remember: ^K H toggles the help window.

Start & quit

$ jupp file.txt        # edit a file
$ jupp                 # new empty buffer
$ jupp +42 file.txt    # open at line 42
$ jupp -hex file.bin   # hex mode
$ jupp -help           # list command-line options

Save & exit

`^K` `X`	save and exit
`^K` `D`	save, keep editing
`^C`	abort, discard changes
`^K` `H`	help

Invoke as

`jupp`	enhanced default
`joe`	classic JOE
`jstar`	WordStar-like
`jmacs`	Emacs-like
`jpico`	Pico-like
`rjoe`	restricted (no shell, one file)

Essential keys

Movement

`^B` `^F`	left / right
`^P` `^N`	up / down
`^Z` `^X`	word left / right
`^A` `^E`	start / end of line
`^U` `^V`	page up / down
`^K` `U` `^K` `V`	top / bottom of file
`^K` `L`	go to line

Editing

`^Y`	delete line
`^_`	undo
`^^`	redo
`^T` `T`	toggle insert / overwrite
`^K` `J`	reformat paragraph
`^K` `,` `^K` `.`	less / more indent

Blocks

`^K` `B`	mark block start
`^K` `K`	mark block end
`^K` `C`	copy block here
`^K` `M`	move block here
`^K` `Y`	delete block
`^K` `W`	write block to file

Search & files

`^K` `F`	find / replace (with options)
`^L`	find next
`^K` `R`	insert file at cursor
`^K` `E`	edit another file

Windows

`^K` `O`	split window
`^K` `N` `^K` `P`	next / prev window
`^K` `I`	one window / all windows

Misc

`^T`	options menu
`^R`	redraw screen
`^K` `Z`	suspend / shell
`^K` `[` n	record macro n (`^K` `]` stops)
`^K` n	play macro n (0–9)

Arrow keys, Home, End, PgUp and PgDn also work. In jstar the cursor keys follow WordStar instead: ^S ^D left/right, ^E ^X up/down, ^A ^F word left/right.

Tips & config

# install
$ sudo apt install jupp          # Debian / Ubuntu
$ doas pkg_add jupp              # OpenBSD

# customise: copy the system rc, then edit your copy
$ cp /etc/joe/joerc ~/.joerc      # path varies by distro

# one-off options
$ jupp -nobackups -tab 4 -spaces file.c

Many commands also accept Esc in place of the Ctrl on the second key.
Mouse works in xterm-style terminals (click, drag, wheel).
Syntax highlighting is on by default for many languages.
Config is read from ~/.jupprc or ~/.joerc; the per-user copy wins over the system one.

Personal reference, not affiliated with MirBSD. Key bindings follow the stock rc; if a binding differs on your box, ^K H is authoritative.