aboutsummaryrefslogtreecommitdiff
path: root/doc (follow)
Commit message (Collapse)AuthorAgeLines
* 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
|
* doc: foot.1: remove trailing space, add ‘=’ between option name and its valueDaniel Eklöf2021-06-23-2/+2
|
* config: add csd.button-color optionDaniel Eklöf2021-06-20-6/+10
| | | | | | | | This option controls the foreground color of the minimize/maximize/close buttons. I.e. the color used to draw the minimize/maximize/close glyphs. It defaults to default background color.
* config: add underline-offset optionDaniel Eklöf2021-06-17-4/+18
| | | | | | | | This option allows the user to configure a custom underline offset. That is, use the user provided offset instead of the font provided one. Closes #490
* [foot-ctlseqs] 8-bit control characters are C1nick black2021-06-14-1/+1
|
* Merge branch 'xtversion'Daniel Eklöf2021-06-13-0/+5
|\ | | | | | | Closes #359
| * doc: ctlseq: add XTVERSIONDaniel Eklöf2021-06-13-0/+5
| |
* | doc: foot-ctlseqs: mention that SS2/SS3 only affect the next characterCraig Barnes2021-06-12-2/+2
| |
* | doc: foot-ctlseqs: rename SS0/SS1 to SO/SICraig Barnes2021-06-12-2/+2
|/ | | | | | | | | | | There's no mention of SS0 or SS1 functions in ECMA-48 or ECMA-35. 0x0E/0x0F are SO/SI (Shift In/Out) in "7-bit environments" or LS0/LS1 (Locking Shift 0/1) in "8-bit environments". The former is the one that applies to foot, since it generally follows "7-bit" conventions due to its use of UTF-8. See also: ECMA-35 §7.2 and §9.2.
* Override options from command lineRyan Farley2021-06-12-0/+4
| | | | | | | | | Allow any configuration option to be overridden with -o/--override 'section.key=value' arguments, as suggested in #554 update completitions for override slight refactoring to ease footclient support
* osc: implement iTerm2’s OSC-9 - desktop notificationsDaniel Eklöf2021-06-04-0/+3
|
* doc: foot{,client}: updates from feedback from @craigbarnesDaniel Eklöf2021-06-02-8/+8
|
* doc: footclient.1: -t,--term: add references to ENVIRONMENT and TERMINFO sectionsDaniel Eklöf2021-06-02-1/+2
|
* doc: footclient.1: add TERMINFO sectionDaniel Eklöf2021-06-02-0/+33
|
* doc: foot.1: -t,--term: add references to ENVIRONMENT and TERMINFO sectionsDaniel Eklöf2021-06-02-1/+2
|
* doc: foot.1: add TERMINFO sectionDaniel Eklöf2021-06-02-0/+33
|
* config: add boolean option tweak.pua-double-widthDaniel Eklöf2021-06-01-1/+13
| | | | | | | When enabled, PUA (Private Usage Area) codepoints are always treated as double-width glyphs, regardless of the actual glyph width. Requires allow-overflowing-double-width-glyphs=yes
* doc: add ENVIRONMENT section to foot(1) and footclient(1) man pagesCraig Barnes2021-05-30-0/+67
| | | | Closes #556
* config: add ‘include’ directiveDaniel Eklöf2021-05-28-0/+16
| | | | | | | | | | | | | | | This allows you to include sub-configurations. For example, theme files. The ‘include’ directive is a top-level keyword. I.e. it cannot be used inside sections. * The included file must be specified with an absolute path * The included file is parsed in its own scope * Nested includes are allowed * Multiple include directives are allowed Closes #555
* notify: add ${window-title}Daniel Eklöf2021-05-27-0/+5
|
* config: notify: change default value to use ${app-id}Daniel Eklöf2021-05-27-1/+1
| | | | | Make the default value of ‘notify’ use ${app-id} for icon and application name.
* Merge branch 'ctrl-c-cancel'Craig Barnes2021-05-25-3/+4
|\
| * config: bind ctrl+c to "cancel" in search/url mode by defaultCraig Barnes2021-05-25-3/+4
| | | | | | | | Closes #544
* | doc: foot.ini: fix default key combos for "cursor-right-word" actionCraig Barnes2021-05-24-1/+1
|/
* config: url.protocols: make it comma separated, for consistencyDaniel Eklöf2021-05-22-4/+5
|
* config: add url.protocolsDaniel Eklöf2021-05-22-0/+7
| | | | | | | This makes the protocols recognized by auto-detected URLs configurable. Closes #531