aboutsummaryrefslogtreecommitdiff
path: root/doc/foot.1.scd (follow)
Commit message (Collapse)AuthorAgeLines
* main/client: add no-op "-e" command-line optionCraig Barnes2021-09-18-0/+10
|
* meson: terminfo install location now defaults to $datadir/terminfoDaniel Eklöf2021-08-30-30/+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-5/+12
| | | | See #692
* doc: foot{,,client}: document TERMINFODaniel Eklöf2021-08-27-0/+23
| | | | Closes #691
* terminfo: install to $datadir/foot/terminfo by default, append to TERMINFO_DIRSDaniel Eklöf2021-08-17-1/+1
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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
* doc: fix typo in foot man pageBen Brown2021-07-08-1/+1
|
* log: add LOG_CLASS_NONE and use as initializer for log_levelCraig Barnes2021-06-26-1/+1
| | | | | | | | | | | | 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: foot.1: remove trailing space, add ‘=’ between option name and its valueDaniel Eklöf2021-06-23-2/+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
* doc: foot{,client}: updates from feedback from @craigbarnesDaniel Eklöf2021-06-02-4/+4
|
* 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
|
* doc: add ENVIRONMENT section to foot(1) and footclient(1) man pagesCraig Barnes2021-05-30-0/+43
| | | | Closes #556
* config: bind ctrl+c to "cancel" in search/url mode by defaultCraig Barnes2021-05-25-1/+1
| | | | Closes #544
* readme/doc: update details for IRC channelCraig Barnes2021-05-19-1/+1
|
* doc: foot.1 footclient.1: document exit statusDaniel Eklöf2021-05-04-1/+8
|
* Merge branch 'working-dir-command-line-option'Daniel Eklöf2021-02-14-1/+5
|\ | | | | | | Closes #347
| * doc: foot.1: add -D,--working-directory=DIRDaniel Eklöf2021-02-12-0/+4
| |
| * doc: foot.1: add missing short option to --login-shellDaniel Eklöf2021-02-12-1/+1
| |
* | doc: foot.1: mention that the key sequence alphabet can be configuredDaniel Eklöf2021-02-13-2/+2
|/
* doc: foot.1: document -d,--log-levelDaniel Eklöf2021-02-09-0/+4
|
* doc: foot.1: document the new URL modeDaniel Eklöf2021-02-07-0/+25
|
* main: remove deprecated "--geometry" optionCraig Barnes2021-01-13-3/+0
| | | | Closes #287
* doc: foot.1: add IRC channelDaniel Eklöf2020-11-27-0/+4
|
* doc: foot.1: no need to say foot.ini twiceDaniel Eklöf2020-11-26-1/+1
|
* foot/footclient: add short options to all command line optionsDaniel Eklöf2020-11-23-5/+5
| | | | | | | | | | | e81388336750a20a2da98a57e9726c8ba1b481e3 added “missing” short command line options to footclient. Except they weren’t missing; they were intentionally missing short options and only supported long options. This commit makes the new/missing short options “official”, by adding documentation, zsh completions and including them in usage().
* readme/doc:foot.1: document the (new) keypad behaviorDaniel Eklöf2020-11-11-0/+17
|
* search: add {clipboard,primary}-paste key bindingsDaniel Eklöf2020-11-01-0/+6
| | | | | | | | | | These bindings copy from the clipboard or primary selection into the search buffer. Default bindings: * clipboard-paste: ctrl+v, ctrl+y * primary-paste: shift+insert
* readme/doc: add shift+insert to list of default key bindingsDaniel Eklöf2020-10-10-0/+3
|
* doc: foot.1: remove ‘--’ from example command lineDaniel Eklöf2020-10-08-1/+1
|
* Add -W,--window-size-chars, and foot.ini:initial-window-size-charsDaniel Eklöf2020-09-08-1/+7
| | | | | | | | | | | * Add -W,--window-size-chars command line option * Add initial-window-size-chars foot.ini option * Add -w,--window-size-pixels command line option * Add initial-window-size-pixels foot.ini option * Deprecate -g,--geometry command line option in favor of -w,--window-size-pixels * Deprecate geometry option in foot.ini in favor of initial-window-size-pixels
* doc: rename footrc.5 to foot.ini.5, and update referencesDaniel Eklöf2020-08-27-4/+5
|
* doc: foot.1: move DESCRIPTION up before OPTIONSDaniel Eklöf2020-08-13-10/+10
|
* doc: foot.1: don't talk about using '--' on the command lineDaniel Eklöf2020-08-12-3/+2
| | | | This used to be necessary, but isn't anymore.
* server/client: use $WAYLAND_DISPLAY instead of $XDG_SESSION_ID in default socket pathDaniel Eklöf2020-08-02-4/+4
| | | | | | | | | Foot is a Wayland client and cannot be run outside of a Wayland session. As such, it makes more sense to use $WAYLAND_SESSION instead of $XDG_SESSION_ID in the default socket path since this makes it clearer which Wayland session we belong to. Closes #55.
* doc: foot.1: fix default path in -s,--serverDaniel Eklöf2020-08-02-4/+13
| | | | | | | | | | | | | | | | | | | The documentation incorrectly stated that the default path is $XDG_RUNTIME_DIR/foot.sock. The correct default path is * $XDG_RUNTIME_DIR/foot-$XDG_SESSION_ID.sock * $XDG_RUNTIME_DIR/foot-no-session.sock * /tmp/foot.sock Depending on whether XDG_RUNTIME_DIR and XDG_SESSION_ID has been set or not. This also removes the '<>' from the default when XDG_SESSION_ID is not set. Closes #53.
* doc+readme: make it clear(er) that RMB can be hold-and-draggedDaniel Eklöf2020-07-31-1/+3
|
* main: add --check-config command line optionDaniel Eklöf2020-07-29-0/+4
|
* doc: rename foot.5 -> footrc.5Daniel Eklöf2020-07-27-3/+3
|
* Correct the location of footrc in manpageJonas 'cherti' Große Sundrup2020-07-25-1/+1
|
* Fix typosbirger2020-07-25-2/+2
|
* main/client: be POSIXLY_CORRECT when parsing command lineDaniel Eklöf2020-05-08-3/+3
| | | | | | | | | | | | | | | | | | | | This means command line parsing stops when it encounters the first nonoption argument. The result is that one no longer need to use '--' to ensure arguments are passed to the shell/command, instead of parsed by foot. That is, instead of foot -- sh -c true one can now do foot sh -c true Arguments to foot *must* go before the command: foot --fullscreen sh -c true
* doc: foot.1: list what a bug report should containDaniel Eklöf2020-04-04-0/+9
|
* doc: foot.1: add link to issue reportingDaniel Eklöf2020-04-04-0/+4
|
* doc: foot.1: right mouse button extends current selectionDaniel Eklöf2020-04-04-0/+3
|
* doc: foot/footclient: fix highlighting of TITLE argument to --titleDaniel Eklöf2020-04-01-1/+1
|
* conf: add 'title' conf option and --title command line optionDaniel Eklöf2020-04-01-0/+3
|
* conf: add app-id config option and --app-id command line optionDaniel Eklöf2020-04-01-1/+5
|
* foot: add --maximized and --fullscreen command line optionsDaniel Eklöf2020-03-26-0/+8
|
* doc: foot.1: document ctrl+shift+nDaniel Eklöf2020-03-17-0/+5
|
* doc: foot.1: mention default value for '--log-colorize'Daniel Eklöf2020-03-17-1/+2
|
* doc: foot.1: fix typo - this isn't yambarDaniel Eklöf2020-03-17-1/+1
|
* doc/foot.1: keyboard shortcuts: add pointer to foot(5)Daniel Eklöf2020-03-09-2/+4
|
* config: change default geometry from 800x600 -> 700x500Daniel Eklöf2020-02-29-1/+1
| | | | | | | | If the display resolution *is* 800x600, using this size is bad since there will typically be panels and other things on the screen too. Not that 800x600 is something we expect to see in real life, but may happen on virtual displays.
* main: geometry defaults to 800x600 pixelsDaniel Eklöf2020-02-25-1/+1
|
* keymap: align backspace escapes with XTermDaniel Eklöf2020-02-21-0/+11
| | | | | | | | | | | | | | | Backspace now emits DEL for all non-ctrl modifier combos, and BS for all ctrl modifier combos. The alt modifier prefixes DEL/BS with ESC. This also removes my own hack of mapping ctrl+backspace to alt+backspace. Describe backspace behavior in both the README and the man page. TODO: implement DECBKM to allow applications to toggle the backspace behavior.
* doc: add --login-shellDaniel Eklöf2020-02-20-0/+3
|
* input: ctrl+= increases font size, not resets itDaniel Eklöf2020-02-10-2/+2
|
* doc: foot.1: keyboard shortcuts for font size adjumentDaniel Eklöf2020-02-09-0/+9
|
* main: add --print-pid=FILE|FDDaniel Eklöf2020-02-05-0/+7
| | | | | When specified, our PID is written to the specified file (or FD), after we've successfully started up.
* main: add --print-pid=FILE|FDDaniel Eklöf2020-02-05-0/+7
| | | | | | | When specified, our PID is written to the specified file (or FD), after we've successfully started up. Only applicable in server mode.
* Implement --holdDaniel Eklöf2020-02-03-0/+3
| | | | When specified, we don't exit when the slave/client process exits.
* doc: foot.1: document alt/meta charactersDaniel Eklöf2020-01-20-0/+16
|
* doc: foot.1: use BOLD for things that should by typed as-isDaniel Eklöf2020-01-20-3/+3
|
* doc: slight change of wording for mouse-drag-to-selectDaniel Eklöf2020-01-04-3/+3
|
* doc: document how to do block selectionsDaniel Eklöf2020-01-04-0/+2
|
* doc: add descriptions for ctrl+w and ctrl+shift+w in scrollback searchDaniel Eklöf2020-01-04-0/+9
|
* doc: add headers to keyboard shortcuts for normal+scrollback searchDaniel Eklöf2020-01-04-2/+3
|
* doc: foot.1: add -c,--configDaniel Eklöf2019-12-17-1/+4
|
* doc: foot.1: update with optional PATH argument to -s,--serverDaniel Eklöf2019-12-14-2/+6
|
* doc: foot.1: mention that selection is kept after ending a scrollback searchDaniel Eklöf2019-11-29-1/+2
|
* doc: foot.1: highlight 'command' in the synopsisDaniel Eklöf2019-11-19-1/+1
|
* doc: foot.1: fix highlighting of reference to footclientDaniel Eklöf2019-11-19-1/+1
|
* doc: foot.1: add description of the (mouse) wheelDaniel Eklöf2019-11-03-0/+2
|
* doc: foot.1: spellingDaniel Eklöf2019-11-03-1/+1
|
* man: foot.1: add reference to footclient(1)Daniel Eklöf2019-11-03-1/+1
|
* man: foot.1: add a DESCRIPTIONDaniel Eklöf2019-11-03-0/+11
|
* man: foot.1: document -s,--serverDaniel Eklöf2019-11-03-0/+22
|
* doc: user Courier New instead of Arial in font examplesDaniel Eklöf2019-09-21-1/+1
| | | | Since Courier New is monospaced, while Arial is not.
* main: -f,--font now accepts a list of fontsDaniel Eklöf2019-09-21-2/+13
| | | | | | | This makes -f,--font behave just like the configuration file option 'font'; the first font in the list is the primary font, and the remaining fonts are fallback fonts used when a glyph cannot be found in the primary font.
* man: document keyboard + mouse shortcutsDaniel Eklöf2019-08-30-0/+53
|
* add config + command line option for setting initial window width/heightDaniel Eklöf2019-08-23-0/+3
|
* doc: document how to specify command to execute instead of shellDaniel Eklöf2019-08-15-1/+5
|
* doc: add foot.5 (configuration)Daniel Eklöf2019-08-12-0/+9
|
* doc: add foot.1 man pageDaniel Eklöf2019-08-11-0/+29