<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc/foot.1.scd, branch 1.12.0</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=1.12.0</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=1.12.0'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2022-04-22T15:00:04Z</updated>
<entry>
<title>doc + meson.build: update information about foot.ini, small cleanup</title>
<updated>2022-04-22T15:00:04Z</updated>
<author>
<name>Merlin Büge</name>
<email>merlin.buege@tuhh.de</email>
</author>
<published>2022-04-21T08:04:11Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=e6f884a9e1313b530130593e1743cb763b91f6fe'/>
<id>urn:sha1:e6f884a9e1313b530130593e1743cb763b91f6fe</id>
<content type='text'>
- 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
</content>
</entry>
<entry>
<title>doc: fix some small typos</title>
<updated>2022-04-06T13:46:59Z</updated>
<author>
<name>Merlin Büge</name>
<email>merlin.buege@tuhh.de</email>
</author>
<published>2022-04-03T23:28:03Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ee6007aa073d486e0433fe225ffede020498084d'/>
<id>urn:sha1:ee6007aa073d486e0433fe225ffede020498084d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Document socket activation feature</title>
<updated>2022-02-26T15:09:30Z</updated>
<author>
<name>Max Gautier</name>
<email>mg@max.gautier.name</email>
</author>
<published>2022-01-15T16:37:31Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=4ec172a4ad3e64489945a42b3bf6adb147e8e2d3'/>
<id>urn:sha1:4ec172a4ad3e64489945a42b3bf6adb147e8e2d3</id>
<content type='text'>
- Particular mention to included systemd user units
</content>
</entry>
<entry>
<title>doc: foot.1: describe how to search for the previous search string</title>
<updated>2022-01-29T16:50:43Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:39:46Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=1537fd02bdff5216be5a16239ed9183f7bbb3b7a'/>
<id>urn:sha1:1537fd02bdff5216be5a16239ed9183f7bbb3b7a</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: shortcuts: mention that there are more actions than listed here</title>
<updated>2022-01-29T16:50:43Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:39:12Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=749d4c076696efdfddca9d8b4cf27ded90160aad'/>
<id>urn:sha1:749d4c076696efdfddca9d8b4cf27ded90160aad</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: add missing ‘*’</title>
<updated>2022-01-27T17:54:48Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:54:48Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=2cc0a450b4f4b0f7c213c1f54859914cf373ceab'/>
<id>urn:sha1:2cc0a450b4f4b0f7c213c1f54859914cf373ceab</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: use tab for indentation</title>
<updated>2022-01-27T17:54:38Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:54:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=034f4171a4a19c8b0e3fb2bf3810e7a5a4f5e04d'/>
<id>urn:sha1:034f4171a4a19c8b0e3fb2bf3810e7a5a4f5e04d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: add URL mode bindings to the list of default keyboard shortcuts</title>
<updated>2022-01-27T17:45:53Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:45:53Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=90b906d159ecd03ee25e7fa91a8303fda38a7967'/>
<id>urn:sha1:90b906d159ecd03ee25e7fa91a8303fda38a7967</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: add “enter URL mode” shortcut</title>
<updated>2022-01-27T17:45:41Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:45:41Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=701d5fe5a40d2054a4113791fd60f92288357b2a'/>
<id>urn:sha1:701d5fe5a40d2054a4113791fd60f92288357b2a</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: add the new XF86{Copy,Paste} key bindings</title>
<updated>2022-01-27T17:45:22Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-27T17:45:22Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ef855aa13224ca4d4382730b141118f268884cf0'/>
<id>urn:sha1:ef855aa13224ca4d4382730b141118f268884cf0</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: XTGETTCAP</title>
<updated>2022-01-14T12:45:23Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-01-14T12:36:31Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=49a8c7fc765f6ed2874e270fa2166850b48eeb9c'/>
<id>urn:sha1:49a8c7fc765f6ed2874e270fa2166850b48eeb9c</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: reporting bugs: move “search existing issues”</title>
<updated>2021-10-16T13:30:21Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-10-16T13:30:21Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f9782848e5e881c900b5d199c0e4935e9da62d56'/>
<id>urn:sha1:f9782848e5e881c900b5d199c0e4935e9da62d56</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.1: reporting bugs: re-order and tweak</title>
<updated>2021-10-16T13:25:11Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-10-16T13:25:11Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=a75f1f7ab4d62e72ada0e1815dc00e4d40e34be6'/>
<id>urn:sha1:a75f1f7ab4d62e72ada0e1815dc00e4d40e34be6</id>
<content type='text'>
* Tell people to search existing bugs first (open + closed)
* Re-order instructions: most important ones first
</content>
</entry>
<entry>
<title>main/client: add no-op "-e" command-line option</title>
<updated>2021-09-18T22:40:40Z</updated>
<author>
<name>Craig Barnes</name>
<email>craigbarnes@protonmail.com</email>
</author>
<published>2021-09-18T22:40:40Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ef7919e64d09d4b29a1557641883e78f5896841d'/>
<id>urn:sha1:ef7919e64d09d4b29a1557641883e78f5896841d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>meson: terminfo install location now defaults to $datadir/terminfo</title>
<updated>2021-08-30T17:09:13Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-29T09:06:45Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9434066546a8409117083bd64ad43f97a3a236e2'/>
<id>urn:sha1:9434066546a8409117083bd64ad43f97a3a236e2</id>
<content type='text'>
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).
</content>
</entry>
<entry>
<title>doc: how to pass TERMINFO through ‘doas’</title>
<updated>2021-08-27T18:25:26Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-27T18:25:26Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=fd78fa98b4765771b65140bc6edfbd472b4f666b'/>
<id>urn:sha1:fd78fa98b4765771b65140bc6edfbd472b4f666b</id>
<content type='text'>
See #692
</content>
</entry>
<entry>
<title>doc: foot{,,client}: document TERMINFO</title>
<updated>2021-08-27T11:31:15Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-27T11:16:49Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=6e8da20ee22e07d271a47a53e43f35ba41e55281'/>
<id>urn:sha1:6e8da20ee22e07d271a47a53e43f35ba41e55281</id>
<content type='text'>
Closes #691
</content>
</entry>
<entry>
<title>terminfo: install to $datadir/foot/terminfo by default, append to TERMINFO_DIRS</title>
<updated>2021-08-17T19:04:30Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-07T14:42:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=76391868650240b2314a66d182e4d07cf8491f54'/>
<id>urn:sha1:76391868650240b2314a66d182e4d07cf8491f54</id>
<content type='text'>
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=&lt;path&gt;: *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
</content>
</entry>
<entry>
<title>doc: fix typo in foot man page</title>
<updated>2021-07-08T09:43:51Z</updated>
<author>
<name>Ben Brown</name>
<email>ben@demerara.io</email>
</author>
<published>2021-07-08T09:43:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9a14e5d8182ac18b24eeaa80c73c0fdc71c43092'/>
<id>urn:sha1:9a14e5d8182ac18b24eeaa80c73c0fdc71c43092</id>
<content type='text'>
</content>
</entry>
<entry>
<title>log: add LOG_CLASS_NONE and use as initializer for log_level</title>
<updated>2021-06-26T21:15:09Z</updated>
<author>
<name>Craig Barnes</name>
<email>craigbarnes@protonmail.com</email>
</author>
<published>2021-06-26T21:15:09Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=5dca0458a09ebc586fda49c50533976f055d8de2'/>
<id>urn:sha1:5dca0458a09ebc586fda49c50533976f055d8de2</id>
<content type='text'>
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.
</content>
</entry>
</feed>
