diff --git a/README.md b/README.md
index eebc3289..6ed7c071 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,8 @@
1. [Fonts](#fonts)
1. [Shortcuts](#shortcuts)
1. [Keyboard](#keyboard)
+ 1. [Normal mode](#normal-mode)
+ 1. [Scrollback search](#scrollback-search)
1. [Mouse](#mouse)
1. [Server mode](#server-mode)
1. [Requirements](#requirements)
@@ -47,20 +49,21 @@ This is a list of known, but probably not all, issues:
* Unicode combining characters
- Examples: á (`LATIN SMALL LETTER A` + `COMBINING ACUTE ACCENT`)
+ Examples: á (`LATIN SMALL LETTER A` + `COMBINING ACUTE ACCENT`)
* Reflow text on window resize
* GNOME; might work, but without window decorations.
- Strictly speaking, foot is at fault here; all Wayland applications
- _must_ be able to draw their own window decorations (but foot is
- not).
+ Strictly speaking, foot is at fault here; all Wayland applications
+ _must_ be able to draw their own window decorations (but foot is
+ not).
- However, most people want a uniform look and feel on their desktop,
- including the window decorations. For this reason, a Wayland
- application can request _Server Side Decorations_ (SSD). GNOME will
- reply with a "I hear you, but sorry, I wont do that".
+ However, most people want a uniform look and feel on their
+ desktop, including the window decorations. For this reason, a
+ Wayland application can request _Server Side Decorations_
+ (SSD). GNOME will reply with a "_I hear you, but sorry, I wont do
+ that_".
## Fonts
@@ -90,79 +93,66 @@ is **not** possible to define new key bindings.
### Keyboard
-* shift+page up/page down
+#### Normal mode
- Scroll up/down in history
+shift+page up/page down
+: Scroll up/down in history
-* ctrl+shift+c
+ctrl+shift+c
+: Copy selected text to the _clipboard_
- Copy selected text to the _clipboard_
+ctrl+shift+v
+: Paste from _clipboard_
-* ctrl+shift+v
+ctrl+shift+r
+: Start a scrollback search
- Paste from _clipboard_
-* ctrl+shift+r
+#### Scrollback search
- Start a scrollback search
+ctrl+r
+: Search _backward_ for next match
-While doing a scrollback search, the following shortcuts are
-available:
+ctrl+s
+: Search _forward_ for next match
-* ctrl+r
-
- Search _backward_ for next match
-
-* ctrl+s
-
- Search _forward_ for next match
-
-* ctrl+w
-
- Extend current selection (and thus the search criteria) to the end
+ctrl+w
+: Extend current selection (and thus the search criteria) to the end
of the word, or the next word if currently at a word separating
character.
-* ctrl+shiftw
-
- Same as ctrl+w, except that the only word
+ctrl+shiftw
+: Same as ctrl+w, except that the only word
separating characters are whitespace characters.
-* escape, ctrl+g
+escape, ctrl+g
+: Cancel the search
- Cancel the search
-
-* return
-
- Finish the search and copy the current match to the primary
+return
+: Finish the search and copy the current match to the primary
selection
### Mouse
-* left - **single-click**
-
- Drag to select; when released, the selected text is copied to the
+left - **single-click**
+: Drag to select; when released, the selected text is copied to the
_primary_ selection. Note that this feature is normally **disabled**
whenever the client has enabled _mouse tracking_, but can be forced
by holding shift.
-* left - **double-click**
-
- Selects the _word_ (separated by spaces, period, comma, parenthesis
+left - **double-click**
+: Selects the _word_ (separated by spaces, period, comma, parenthesis
etc) under the pointer. Hold ctrl to select everything
under the pointer up to, and until, the next space characters.
-* left - **triple-click**
+left - **triple-click**
+: Selects the entire row
- Selects the entire row
+middle
+: Paste from _primary_ selection
-* middle
-
- Paste from _primary_ selection
-
-* wheel
-
- Scroll up/down in history
+wheel
+: Scroll up/down in history
## Server mode
@@ -208,8 +198,11 @@ want to launch a new terminal.
* pixman
* wayland (_client_ and _cursor_ libraries)
* xkbcommon
-* [tllist](https://codeberg.org/dnkl/tllist), _unless_ built as a subproject
-* [fcft](https://codeberg.org/dnkl/fcft), _unless_ built as a subproject
+* [tllist](https://codeberg.org/dnkl/tllist) [^1]
+* [fcft](https://codeberg.org/dnkl/fcft) [^1]
+
+[^1]: can also be built as subprojects, in which case they are
+ statically linked.
### Building