mirrors/foot
1
0
Fork 0
mirror of https://codeberg.org/dnkl/foot.git synced 2026-02-26 01:40:12 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

Merge branch 'readme-pimping'

Browse source
This commit is contained in:
Daniel Eklöf 2020-01-01 15:20:39 +01:00
commit fad5c87f65
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F
1 changed files with 48 additions and 55 deletions
Download patch file Download diff file Expand all files Collapse all files

103
README.md
View file

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