<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc/foot.ini.5.scd, branch 1.9.0</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=1.9.0</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=1.9.0'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2021-08-17T19:04:30Z</updated>
<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>config: add url.uri-characters</title>
<updated>2021-08-09T16:25:36Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-09T16:25:36Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=0c03e9a7668505c77bfcb31d999a46079574e7ae'/>
<id>urn:sha1:0c03e9a7668505c77bfcb31d999a46079574e7ae</id>
<content type='text'>
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
</content>
</entry>
<entry>
<title>doc: foot.ini: include paths are allowed to begin with ~/</title>
<updated>2021-07-30T12:57:35Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-30T12:53:12Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ed855c72dc4bd4e83afaa9b605fe8bb86d97fe67'/>
<id>urn:sha1:ed855c72dc4bd4e83afaa9b605fe8bb86d97fe67</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: indent lists</title>
<updated>2021-07-30T12:56:55Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-30T12:56:55Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=46d30406be14f82b28aa0809118109443f7b029d'/>
<id>urn:sha1:46d30406be14f82b28aa0809118109443f7b029d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>Only brighten palette colors with bold-text-in-bright=palette-based</title>
<updated>2021-07-26T17:13:46Z</updated>
<author>
<name>David Rosca</name>
<email>nowrep@gmail.com</email>
</author>
<published>2021-07-22T16:22:39Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=2c5a23867fd7bcfe4cf757cb690fcd6dc191ec6e'/>
<id>urn:sha1:2c5a23867fd7bcfe4cf757cb690fcd6dc191ec6e</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: mention that csd.font is sized using the title bar size</title>
<updated>2021-07-24T09:02:44Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-22T21:40:40Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=c38b3507bcda8567cdae5f1d81ddea336408a454'/>
<id>urn:sha1:c38b3507bcda8567cdae5f1d81ddea336408a454</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: add csd.font option</title>
<updated>2021-07-24T09:02:43Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-22T21:21:31Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=50f59fe575f339b36c1abdeb74f85be776fcdc47'/>
<id>urn:sha1:50f59fe575f339b36c1abdeb74f85be776fcdc47</id>
<content type='text'>
</content>
</entry>
<entry>
<title>render: Allow cells to bleed into their neighbor</title>
<updated>2021-07-17T11:22:44Z</updated>
<author>
<name>Timur Celik</name>
<email>mail@timurcelik.de</email>
</author>
<published>2021-06-15T09:45:27Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=91801ae55da017c2dd0f44c04b8d316a9a2090ef'/>
<id>urn:sha1:91801ae55da017c2dd0f44c04b8d316a9a2090ef</id>
<content type='text'>
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*.
</content>
</entry>
<entry>
<title>config: add locked-title=no|yes</title>
<updated>2021-07-04T15:59:40Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-04T15:59:40Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=fcb60abc132b12ccf8fb8ff215acc924a44773d6'/>
<id>urn:sha1:fcb60abc132b12ccf8fb8ff215acc924a44773d6</id>
<content type='text'>
Closes #386
</content>
</entry>
<entry>
<title>doc: foot.ini.5: typo: relay-size-ms -&gt; resize-delay-ms</title>
<updated>2021-07-02T14:53:49Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-02T14:53:49Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=d10132588530dd411efce2006d711f39203cd913'/>
<id>urn:sha1:d10132588530dd411efce2006d711f39203cd913</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: rename at-most-2 (value for grapheme-width-method) to double-width</title>
<updated>2021-07-01T06:00:23Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-01T06:00:23Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=5138f022146e447d8bb0be56a06e9065b35b6489'/>
<id>urn:sha1:5138f022146e447d8bb0be56a06e9065b35b6489</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: add tweak.grapheme-width-method=wcswidth|at-most-2</title>
<updated>2021-07-01T05:58:06Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-06-30T16:00:33Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9817e44c325f5d44f64bfa768107998134ea7f59'/>
<id>urn:sha1:9817e44c325f5d44f64bfa768107998134ea7f59</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: grapheme-shaping: mention regular compose characters</title>
<updated>2021-06-24T15:30:49Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-06-24T08:10:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f3e5c3deb943bde60364e129a63bea5d56cb6159'/>
<id>urn:sha1:f3e5c3deb943bde60364e129a63bea5d56cb6159</id>
<content type='text'>
</content>
</entry>
<entry>
<title>wip: grapheme shaping</title>
<updated>2021-06-24T15:30:45Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2020-08-20T17:25:35Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b9ef703eb14ba2357b847b62a715b4e97f690209'/>
<id>urn:sha1:b9ef703eb14ba2357b847b62a715b4e97f690209</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: add csd.button-color option</title>
<updated>2021-06-20T08:44:50Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-06-20T08:44:50Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=7334b53d833cd2695a3544ff166219e977138732'/>
<id>urn:sha1:7334b53d833cd2695a3544ff166219e977138732</id>
<content type='text'>
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.
</content>
</entry>
<entry>
<title>config: add underline-offset option</title>
<updated>2021-06-17T15:54:21Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-06-17T15:52:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=cf81fff062c8cac850f491ac722d6bb79a8bde14'/>
<id>urn:sha1:cf81fff062c8cac850f491ac722d6bb79a8bde14</id>
<content type='text'>
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
</content>
</entry>
<entry>
<title>config: add boolean option tweak.pua-double-width</title>
<updated>2021-06-01T15:51:09Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-05-31T15:10:05Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=4c954be7a6d86b21da512fc533eb3362ac737221'/>
<id>urn:sha1:4c954be7a6d86b21da512fc533eb3362ac737221</id>
<content type='text'>
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
</content>
</entry>
<entry>
<title>config: add ‘include’ directive</title>
<updated>2021-05-28T15:44:13Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-05-28T15:44:13Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9055d3d9219de819770f43fd8c297114aaf938d5'/>
<id>urn:sha1:9055d3d9219de819770f43fd8c297114aaf938d5</id>
<content type='text'>
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
</content>
</entry>
<entry>
<title>notify: add ${window-title}</title>
<updated>2021-05-27T10:11:47Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-05-27T10:11:47Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f1d75a1e1f3c5798fa97c0c858b4c5f5dd23514d'/>
<id>urn:sha1:f1d75a1e1f3c5798fa97c0c858b4c5f5dd23514d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: notify: change default value to use ${app-id}</title>
<updated>2021-05-27T09:41:57Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-05-27T09:41:57Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f9a13e2eec2c98c8853073607347f65f4291a7e5'/>
<id>urn:sha1:f9a13e2eec2c98c8853073607347f65f4291a7e5</id>
<content type='text'>
Make the default value of ‘notify’ use ${app-id} for icon and
application name.
</content>
</entry>
</feed>
