aboutsummaryrefslogtreecommitdiff
path: root/doc (follow)
Commit message (Collapse)AuthorAgeLines
* config: add ctrl+shift+v and XF86 paste to SEARCH_CLIPBOARD_PASTEDaniel Eklöf2022-04-26-1/+1
| | | | | | | | | | | | | We now bind ctrl+v, ctrl+shift+v, ctrl+y and XF86Paste to pasting from the clipboard into the scrollback search buffer. Why all these? Because we can, and because all are common shortcuts for pasting: * ctrl+v: “normal” apps use this by default * ctrl+shift+v: used in terminals (including foot) * ctrl+y: Emacs * XF86Paste: special keyboard key, for pasting
* doc: foot.ini: drop empty line after *show-urls-launch*Daniel Eklöf2022-04-23-1/+0
|
* doc + meson.build: update information about foot.ini, small cleanupMerlin Büge2022-04-22-33/+31
| | | | | | | | | | | | | | | | | | | - foot.ini.5: mention location of example config file - foot.1: replace outdated (or incomplete) information about the location of the config file with references to foot.ini.5 - foot.1 and foot.ini.5: conform to scdoc specification, thus surround each header with (at least) one blank line. additionally consistently use exactly one line before/after each header (was sometimes two before) - foot.1: some parts of the keybindings had their own section, move into KEYBOARD SHORTCUTS section - foot.1: move EXIT STATUS section to the end where it is commonly found - foot.1: copy information about config file handling from the beginning of foot.ini.5 into the CONFIGURATION section of foot.1 - INSTALL.md: foot.ini is no longer included in the documentation - meson.build: do not bundle foot.ini with documentation anymore, see also https://codeberg.org/dnkl/foot/pulls/1015 Closes #1002
* csi: implement CSI > 4n (reset modifyOtherKeys)Daniel Eklöf2022-04-19-1/+7
|
* url-mode: add a key binding that enables “persistent” URL modeDaniel Eklöf2022-04-17-2/+7
| | | | | | | This is an alternative to ‘show-urls-launch’, where we stay in URL mode after activating an URL. Closes #964
* config: add [csd].hide-when-maximized=yes|noDaniel Eklöf2022-04-16-1/+8
| | | | | | | When enabled, the CSD titlebar will be hidden when the window is maximized. Closes #1019
* fix some small typosMerlin Büge2022-04-13-1/+1
|
* doc: footclient: codespellDaniel Eklöf2022-04-12-2/+2
|
* doc: footclient: add -E,--client-environmentDaniel Eklöf2022-04-12-0/+4
|
* doc: ctlseq: document XTMODKEYSDaniel Eklöf2022-04-10-0/+5
|
* config: fallback to /etc/xdg if XDG_CONFIG_DIRS is unsetDaniel Eklöf2022-04-07-3/+4
| | | | Closes #1008
* config: add tweak option to allow disabling sixelsjvoisin2022-04-06-0/+4
| | | | Closes #950
* Small clarification/rewording of default color valuesMerlin Büge2022-04-06-6/+4
| | | | | | | | | This makes the example config `foot.ini` and its man page slightly more coherent regarding the specification of default values. Note that the cursor color is not hardcoded like e.g. foreground or background, thus in the example config, `<inverse foreground/background>` makes more sense.
* doc: fix some small typosMerlin Büge2022-04-06-16/+16
|
* doc: foot.ini: escape ‘-’ and ‘*’Daniel Eklöf2022-04-05-1/+1
|
* doc: foot.ini: align documented default value of uri-characters with realityDaniel Eklöf2022-04-05-1/+1
| | | | Fixes #1000
* csi: add support for DECNKM private modeCraig Barnes2022-03-19-0/+3
| | | | | | | | | | | This is equivalent to DECKPAM/DECKPNM when enabled/disabled, but can also be saved/restored/queried with XTSAVE/XTRESTORE/DECRQM. See also: * https://vt100.net/docs/vt510-rm/DECNKM.html * https://vt100.net/docs/vt510-rm/DECKPAM.html * https://invisible-island.net/xterm/ctlseqs/ctlseqs.html#h3-PC-Style-Function-Keys
* meson: stop using deprecated functions, require meson >= 0.58Daniel Eklöf2022-02-27-2/+2
| | | | | | * get_pkgconfig_variable() -> get_variable() * prog.path() -> prog.full_path() * meson.build_root() -> meson.global_build_root()
* Document socket activation featureMax Gautier2022-02-26-1/+14
| | | | - Particular mention to included systemd user units
* config/input: add scrollback-home|end key bindings (unbound by default)Daniel Eklöf2022-02-23-0/+6
|
* doc: foot.ini: document the new [text-bindings] sectionDaniel Eklöf2022-02-16-0/+31
|
* doc: ctlseq: recommend using DECSET 2026 for synchronized updatesCraig Barnes2022-02-16-4/+4
| | | | | | Instead of the somewhat problematic[1] DCS-based equivalent. [1]: https://codeberg.org/dnkl/foot/issues/459
* doc: ctlseq: tweak formatting of OSC 22 sequence slightly, for clarityCraig Barnes2022-02-15-1/+1
| | | | | Having 3 separately underlined words made it look a bit like 3 separate parameters, at a glance.
* doc: ctlseq: make OSC 8 formatting consistent with other sequencesCraig Barnes2022-02-15-3/+3
|
* doc: ctlseq: OSC-22Daniel Eklöf2022-02-07-0/+4
|
* doc: foot.1: describe how to search for the previous search stringDaniel Eklöf2022-01-29-2/+4
|
* doc: foot.1: shortcuts: mention that there are more actions than listed hereDaniel Eklöf2022-01-29-4/+3
|
* doc: foot.1: add missing ‘*’Daniel Eklöf2022-01-27-1/+1
|
* doc: foot.1: use tab for indentationDaniel Eklöf2022-01-27-1/+1
|
* Merge branch 'document-ansi-colors'Daniel Eklöf2022-01-27-6/+6
|\
| * doc: document the 8 ANSI escape codes.Mark Stosberg2022-01-15-6/+6
| |
* | doc: foot.1: add URL mode bindings to the list of default keyboard shortcutsDaniel Eklöf2022-01-27-0/+9
| |
* | doc: foot.1: add “enter URL mode” shortcutDaniel Eklöf2022-01-27-0/+4
| |
* | doc: foot.1: add the new XF86{Copy,Paste} key bindingsDaniel Eklöf2022-01-27-2/+2
| |
* | Merge branch 'support-copy-paste-keybindings-by-default'Daniel Eklöf2022-01-25-2/+3
|\ \
| * | config: support Copy and Paste keycodes by defaultMark Stosberg2022-01-25-2/+3
| |/ | | | | | | | | | | | | | | | | | | | | | | These work as expected and don't interfere with anything else. They are useful on the increasing number of keyboards with custom firmware. The keycodes enable using the same key combination for terminals as other apps. For example: by holding down a layer-switching key with a thumb, the Copy and Paste key codes can be assigned to the C and V keys on a secondary layer, making for a natural universal copy/paste key combination.
* / Fix typo in manual page for foot.ini(5).Felix Lechner2022-01-20-1/+1
|/
* dcs: implement DECRQSSDaniel Eklöf2022-01-14-0/+3
| | | | | | | | | | | This patch adds support for DECRQSS (request Selection or Setting), for the following sub-queries: * DECSTBM Set Top and Bottom Margins * SGR Set Graphic Rendition * DECSCUSR Set Cursor Style Closes #798
* doc: foot.1: XTGETTCAPDaniel Eklöf2022-01-14-0/+47
|
* doc: ctlseq: add XTGETTCAPDaniel Eklöf2022-01-13-0/+3
|
* doc: ctlseq: add missing ‘[‘ to a couple of CSI sequencesDaniel Eklöf2022-01-01-5/+5
|
* doc: ctlseq: kitty kbd: swap name/fromDaniel Eklöf2022-01-01-4/+4
|
* doc: ctlseq: kitty keyboard protocolDaniel Eklöf2022-01-01-0/+17
|
* doc: ctlseq: private mode 1016 - SGR-PixelsDaniel Eklöf2022-01-01-0/+3
|
* Add irc:// to default URL schemesSimon Ser2021-12-27-1/+1
|
* improve documentation for [mouse-bindings].selection-override-modifiersfeeptr@codeberg.org2021-12-04-8/+13
|
* config, doc, changelog: move selection-override-modifiers to [mouse-bindings] and validate other ↵feeptr@codeberg.org2021-12-02-14/+6
| | | | | | case specifically, check for conflicts both when mouse bindings are set and when the selection-override-modifiers setting itself is set
* doc: document select-override-modsfeeptr@codeberg.org2021-12-02-3/+14
|
* config: add tweak.grapheme-width-method=maxDaniel Eklöf2021-11-23-1/+3
| | | | | | ‘max’ is a new value for ‘tweak.grapheme-width-method’. When enabled, the width of a grapheme cluster is that of the cluster’s widest codepoint.
* config: add [colors].dim0-7Daniel Eklöf2021-11-13-0/+30
| | | | | | | | | | | | | | | | | | | | | | | | | This allows you to configure custom colors to be used when colors are being dimmed (`\E[2m`). It is implemented by color matching (just like bold-text-in-bright=palette-based); the color-to-be-dimmed is matched against the current color palette. If it matches one of the regular colors (colors 0-7), the corresponding “dim” color will be used. If it matches one of the bright colors (colors 8-15), the corresponding “regular” color will be used (but *only* if the “dim” color has been set). Otherwise, the color is dimmed by reducing its luminance. The default behavior, i.e. when dim0-7 hasn’t been configured, is to dim by reducing luminance for *all* colors. I.e. we don’t do any color matching at all. In particular, this means that dimming a bright color will *not* result in the corresponding “regular” color. Closes #776
* doc: foot.ini: try to clear up the meaning of (AA)RRGGBBDaniel Eklöf2021-11-13-30/+39
|
* config: drop all warning logs from the tweak sectionDaniel Eklöf2021-11-13-3/+1
|
* doc: foot.ini: mention “xkbcli interactive-wayland”Daniel Eklöf2021-11-07-0/+2
|
* csd: add support for a visible borderDaniel Eklöf2021-10-27-0/+11
| | | | | | | | | | | | | | | | | | | | | | | | When we’re using CSDs, we’ve up until now rendered a 5px invisible border. This border handles interactive resizing. I.e. hovering it changes the mouse cursor, and mouse button events are used to start an interactive resize. This patch makes it possible to color part of (or the entire) border, with a configurable color. To facilitate this, two new options have been added: * csd.border-width * csd.border-color border-width defaults to 0, resulting in the look we’re used to. border-color defaults to the title bar color. If the title bar color hasn’t been set, it defaults to the default foreground color (just like the title bar color does). This means that, setting border-width but not border-color, results in a border that blends with the title bar.
* config: add [key-bindings].noop actionDaniel Eklöf2021-10-27-4/+8
| | | | | | | Key combinations assigned to this action will not be sent to the application. Closes #765
* doc: fix a typoDaniel Martí2021-10-23-1/+1
| | | | | I presume "can be used here as well" was meant. Spotted it while reading the docs.
* doc: foot.5: we support “real” urgency through XDG activationDaniel Eklöf2021-10-22-9/+6
| | | | | | Foot has been signaling window urgency through the (new) “XDG activation” protocol for some time now. Update the documentation to reflect this.
* doc: foot.5: warn user to be careful with single letter key bindings in url modeDaniel Eklöf2021-10-20-1/+10
|
* doc: foot.1: reporting bugs: move “search existing issues”Daniel Eklöf2021-10-16-2/+4
|
* doc: foot.1: reporting bugs: re-order and tweakDaniel Eklöf2021-10-16-5/+8
| | | | | * Tell people to search existing bugs first (open + closed) * Re-order instructions: most important ones first
* config: enable grapheme shaping by defaultDaniel Eklöf2021-10-13-12/+4
| | | | | | | | This changes the default value of tweak.grapheme-shaping to “yes”, thus enabling grapheme shaping by default. It also changes the default value of tweak.grapheme-width-method to “wcswidth”, for maximum compatibility with terminal applications.
* doc: ctlseq: improve text formatting in CSI and SGR sectionsCraig Barnes2021-10-11-10/+10
| | | | | | | | Using underlining for parameters allows the angle brackets to be removed while still keeping a visual separation between literals and parameters. The removes any uncertainty about whether the angle brackets are part of the sequence or not. It also mirrors the formatting used further down in the document.
* doc: ctlseq: fix SGR table headingCraig Barnes2021-10-11-2/+2
| | | | | The other tables that contain only params also use the heading "Parameter" rather than "Sequence".
* doc: document indicator-colorfeeptr@codeberg.org2021-10-09-0/+7
|
* doc: benchmark: 1.9.2 results, laptopDaniel Eklöf2021-10-09-11/+11
|
* doc: benchmark: 1.9.2 results, beefy desktopDaniel Eklöf2021-10-09-1138/+11
|
* notify: add the notify-focus-inhibit config optionMitja Horvat2021-10-06-4/+12
| | | | | | | | | | | | | | | foot doesn't show desktop notifications (via OSC777) if the current terminal has keyboard focus. This is probably a sane default, but there are use cases where showing a notification regardless of the focus status may be desired. For example, a completion notification of a long running task inside a non-focused tmux window. This PR adds the notify-focus-inhibit option which can be used to disable inhibition of notifications when the window has focus. The default value is `yes`, which retains the old behavior.
* term: only scale using DPI if *all* monitors have a scaling factor or oneDaniel Eklöf2021-09-24-2/+4
| | | | | | | | | | | | | | | | | | | | With dpi-aware=auto (the default), scale fonts using DPI *only* if *all* available monitors have a scaling factor of one. The idea is this: if a user, with multiple monitors, have enabled scaling on *at least* one monitor, he/she has most likely done so to match the size of his/hers other monitors. For example, if the user has one monitor with a scaling factor of one, and another one with a scaling factor of two, he/she expects things to be twice as large on the second monitor. If we (foot) scale using DPI on the first monitor, and using the scaling factor on the second monitor, foot will *not* look twice as big on the second monitor (this was the old behavior of dpi-aware=auto). Part of #714
* doc: foot.ini: remove stray double quote characterDaniel Eklöf2021-09-22-1/+1
|
* doc: foot.ini: font: add reference to dpi-aware optionDaniel Eklöf2021-09-22-1/+2
|
* doc: foot.ini: mention how dpi-aware interacts with :pixelsize=NDaniel Eklöf2021-09-22-0/+7
|
* doc: foot.ini: mention how dpi-aware interacts with bitmap fontsDaniel Eklöf2021-09-22-5/+11
|
* main/client: add no-op "-e" command-line optionCraig Barnes2021-09-18-0/+14
|
* doc: Document that the default section can be reopened as [main]Arnavion2021-09-09-3/+4
|
* main: verify primary font is monospaced at startupDaniel Eklöf2021-08-31-0/+11
| | | | | | | | | | Load a couple of ASCII glyphs and check if their advance widths matches. If not, warn the user that the font is probably not monospaced. This can be disabled by setting tweak.font-monospace-warn=no. Closes #704.
* meson: terminfo install location now defaults to $datadir/terminfoDaniel Eklöf2021-08-30-60/+0
| | | | | | | | | | | | | | | | | | | | | | | | | The meson command line option -Dcustom-terminfo-install-location has been changed in the following ways: * If unset, $datadir/terminfo is used, and TERMINFO is *not* exported * If set, that value (relative to $prefix) is used, and TERMINFO *is* exported. * The special value ‘no’ is removed. -Ddefault-terminfo now also changes the terminfo names generated when -Dterminfo=enabled. Furthermore, the documentation for the TERMINFO environment variable has been removed from the foot.1 and footclient.1 man pages (but as mentioned above, foot *will* still set it if -Dcustom-terminfo-install-location has been used). INSTALL.md has been updated to now recommend using ncurses’ terminfo definitions, if available. But also to document the other alternatives; installing the terminfo definitions in a custom location, or installing them with a diferent name. It also describes the general problem, and the disadvantages of each alternative (but without going into too much depth).
* doc: how to pass TERMINFO through ‘doas’Daniel Eklöf2021-08-27-10/+24
| | | | See #692
* doc: foot{,,client}: document TERMINFODaniel Eklöf2021-08-27-0/+46
| | | | Closes #691
* terminfo: install to $datadir/foot/terminfo by default, append to TERMINFO_DIRSDaniel Eklöf2021-08-17-5/+17
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | As of 2021-07-31, ncurses ships its own version of foot’s terminfo. Since: * It doesn’t have the non-standard Sync,Tc,setrgbf,setrgbb capabilities. * It doesn’t set hs,fsl,dsl (statusbar). * We want to be able to update our termminfo without waiting for an ncurses release. * Foot should be installable and usable on Linux systems that doesn’t have the latest ncurses. we still want to ship our own version. We can however not install it to the default terminfo location (e.g. /usr/share/terminfo), since it will collide with the ncurses provided files. Our options are to either rename our terminfo to something else, or to keep the name, but install our terminfo files somewhere else. The first option would be the easy one. However, I think it makes sense to use the same name. For example, a user that SSH’s into a remote system that does *not* have our own version installed, but *does* have the ncurses one, will gracefully fall back to that one, which is better than manually having to set e.g. TERM=xterm-256color. Now, if we want to use the same name, we need to install it somewhere else. But where? And how do we ensure our version is preferred over the ncurses one? I opted to $datadir/foot/terminfo (e.g. /usr/share/foot/terminfo) by default. It makes it namespaced to foot (i.e. we’re not introducing a new “standard” terminfo location), thus guaranteeing it wont collide with ncurses. To enable applications to find it, we export TERMINFO_DIRS. This is a list of *additional* directories to search for terminfo files. If it’s already defined, we *append* to it. The nice thing with this is, if there’s no terminfo in that location (e.g. when you SSH into a remote), the default terminfo location is *also* searched. But only *after* having searched through TERMINFO_DIRS. In short: our version is preferred, but the ncurses one (or an older version of our terminfo package!) will be used if ours cannot be found. To enable packagers full control over the new behavior, the existing meson command line options have been modified, and a new option added: -Dterminfo=disabled|enabled|auto: *build* and *install* the terminfo files. -Dcustom-terminfo-install-location=<path>: *where* the terminfo files are expected to be found. This *needs* to be set *even* if -Dterminfo=disabled. For example, if the packaging script builds and packages the terminfo files separate from the regular foot build. The path is *relative to $prefix*, and defaults to $datadir/foot/terminfo. This is the value that will be appended to TERMINFO_DIRS. Note that you can set it to ‘no’, in which case foot will *not* set/modify TERMINFO_DIRS. Only do this if you don’t intend to package foot’s terminfo files at all (i.e. you plan on using the ncurses ones only). -Ddefault-terminfo=foot. Allows overriding the default TERM value. This should only be changed if the target platform doesn’t support terminfo files. Closes #671
* config: add url.uri-charactersDaniel Eklöf2021-08-09-0/+7
| | | | | | | | | | | | This option specifies the characters allowed in the auto-detected URLs. Any character not in this set constitutes an URL delimiter, and will never be included in auto-detected URLs. This option does not affect OSC-8 URLs. Closes #654
* doc: foot.ini: include paths are allowed to begin with ~/Daniel Eklöf2021-07-30-6/+4
|
* doc: foot.ini: indent listsDaniel Eklöf2021-07-30-14/+14
|
* Only brighten palette colors with bold-text-in-bright=palette-basedDavid Rosca2021-07-26-2/+2
|
* doc: meson: no need to check for scdoc againDaniel Eklöf2021-07-24-1/+0
| | | | We’re already checking for scdoc in the top-level meson.build
* doc: foot.ini: mention that csd.font is sized using the title bar sizeDaniel Eklöf2021-07-24-1/+3
|
* config: add csd.font optionDaniel Eklöf2021-07-24-0/+4
|
* doc: ctlseq: improve description of OSC 52 responseDaniel Eklöf2021-07-22-2/+2
|
* render: Allow cells to bleed into their neighborTimur Celik2021-07-17-22/+12
| | | | | | | | | | | | | | | | This patch adds a `confined` flag to each cell to track if the last rendered glyph bled into it's right neighbor. To keep things simple, bleeding into any other neighbor cell than the immediate right one is not allowed. This should cover most use cases. Before rendering a row we now do a prepass and mark all cells unclean that are affected by a bleeding neighbor. If there are consecutive bleeding cells, the whole group must be re-rendered even if only a single cell has changed. The patch also deprecates both old overflowing glyph options *allow-overflowing-double-width-glyphs* and *pua-double-width* in favor of a single new one named *overflowing-glyphs*.
* doc: fix typo in foot man pageBen Brown2021-07-08-1/+1
|
* config: add locked-title=no|yesDaniel Eklöf2021-07-04-0/+4
| | | | Closes #386
* doc: foot.ini.5: typo: relay-size-ms -> resize-delay-msDaniel Eklöf2021-07-02-2/+2
|
* config: rename at-most-2 (value for grapheme-width-method) to double-widthDaniel Eklöf2021-07-01-4/+4
|
* config: add tweak.grapheme-width-method=wcswidth|at-most-2Daniel Eklöf2021-07-01-0/+18
|
* log: add LOG_CLASS_NONE and use as initializer for log_levelCraig Barnes2021-06-26-2/+2
| | | | | | | | | | | | This means that logging will be completely disabled until log_init() has been called, which is useful to prevent log spam when running UNITTEST{} blocks in debug builds. Note that this doesn't change the default log level at runtime, which was already being set to LOG_CLASS_INFO in main.c and client.c. The new log level is also exposed to the command-line interface as `--log-level=none`, which allows disabling logging entirely.
* doc: benchark: laptop results for 1.8.0Daniel Eklöf2021-06-25-28/+585
|
* doc: benchmark: add --dat to vtebench command lineDaniel Eklöf2021-06-25-1/+1
|
* doc: benchmarks: update desktop results with 1.8.0Daniel Eklöf2021-06-25-19/+566
|
* doc: foot.ini: grapheme-shaping: mention regular compose charactersDaniel Eklöf2021-06-24-2/+4
|
* wip: grapheme shapingDaniel Eklöf2021-06-24-0/+22
|
* doc: footclient.1: document -o,--overrideDaniel Eklöf2021-06-23-0/+4
|