<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc/foot.ini.5.scd, branch 1.14.0</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=1.14.0</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=1.14.0'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2023-03-28T21:45:18Z</updated>
<entry>
<title>fix typos</title>
<updated>2023-03-28T21:45:18Z</updated>
<author>
<name>Harri Nieminen</name>
<email>moiman@posteo.net</email>
</author>
<published>2023-03-28T21:31:49Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=ae26915916731813edc2aefeb18a5754e8c79cd4'/>
<id>urn:sha1:ae26915916731813edc2aefeb18a5754e8c79cd4</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: fix spelling mistake in [bell].urgent description</title>
<updated>2023-02-16T09:12:53Z</updated>
<author>
<name>Craig Barnes</name>
<email>craigbarnes@protonmail.com</email>
</author>
<published>2023-02-16T09:09:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f2356adee392edefa54009c9932a37e6c5a45b20'/>
<id>urn:sha1:f2356adee392edefa54009c9932a37e6c5a45b20</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: fix a typo</title>
<updated>2023-01-07T21:55:01Z</updated>
<author>
<name>Grigory Kirillov</name>
<email>txgk@bk.ru</email>
</author>
<published>2023-01-07T21:55:01Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=a38b8d02227f13ce1da5125905a262e298875a0d'/>
<id>urn:sha1:a38b8d02227f13ce1da5125905a262e298875a0d</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: change default grapheme-width-method from wcswidth to double-width</title>
<updated>2023-01-01T09:29:27Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-16T15:56:43Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=6259d59b4d82b0e8b7705759e04262130a3426c8'/>
<id>urn:sha1:6259d59b4d82b0e8b7705759e04262130a3426c8</id>
<content type='text'>
The old default, wcswidth, simply calls wcswidth() on the grapheme
cluster. This was supposedly the implementation with the highest
application compatibility. Except we never even tried to measure
it. It was just assumed.

A lot of modern applications have better implementations. Let’s try to
push support for better emoji support by changing our default method
from wcswith to double-width.

While far from correct (it’s not based on the Unicode tables), the
‘double-width’ method produces accurate results anyway.

double-width is like wcswidth(), in that it adds together the
individual wcwidths of all codepoints in the grapheme cluster. But, it
limits the maximum width to 2.
</content>
</entry>
<entry>
<title>config: add ‘font-size-adjustment=N[px|%]’ option</title>
<updated>2022-12-17T09:59:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-15T10:10:32Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f6ca8c90e11d9b1ecdfe8a5bf69b1b793376a91c'/>
<id>urn:sha1:f6ca8c90e11d9b1ecdfe8a5bf69b1b793376a91c</id>
<content type='text'>
This patch adds a new config option, font-size-adjustment.

It lets you configure how much the font size should be
incremented/decremented when zooming in or out (ctrl-+, ctrl+-).

Values can be specified in points, pixels or percent.

Closes #1188
</content>
</entry>
<entry>
<title>doc: foot.ini: add example, and mention string options can be quoted</title>
<updated>2022-12-06T18:36:07Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-02T14:03:07Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=646314469afd96eda346b6a296037d5430e5f121'/>
<id>urn:sha1:646314469afd96eda346b6a296037d5430e5f121</id>
<content type='text'>
</content>
</entry>
<entry>
<title>doc: foot.ini: improve documentation of cursor.color</title>
<updated>2022-10-17T18:16:53Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-10-17T18:16:53Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b0c30c7ed22acbf4033db18949ea43f50edd1382'/>
<id>urn:sha1:b0c30c7ed22acbf4033db18949ea43f50edd1382</id>
<content type='text'>
</content>
</entry>
<entry>
<title>render: delay reflow for ‘resize-delay-ms’ milliseconds</title>
<updated>2022-10-10T15:19:17Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-10-05T15:05:44Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=8179d73daa95dc3b3bdd76eaecc78e456bb4686a'/>
<id>urn:sha1:8179d73daa95dc3b3bdd76eaecc78e456bb4686a</id>
<content type='text'>
Reflowing a large scrollback is *slow*. During an interactive resize,
it can easily take long enough that the compositor fills the Wayland
socket with configure events. Eventually, the socket becomes full and
the compositor terminates the connection, causing foot to exit.

This patch is work-in-progress, and the first step towards alleviating
this.

It delays the reflow by:

* Snapshotting (copying) the original grid when an interactive resize
  is started.
* While resizing, we apply a simple truncation resize of the
  grid (like we handle the alt screen).
* When the resize is done, or paused for ‘resize-delay-ms’, the grid
  is reflowed.

TODO: we *must* not allow any changes to the temporary (truncated)
grid during the resize. Any changes to the grid would be lost when the
final reflow is applied. That is, we must completely pause the ptmx
pipe while a resize is in progress.

Future improvements:

The initial copy can be slow. We should be able to avoid it by
rewriting the reflow algorithm to not free anything. This is
complicated by the fact that some resources (e.g. sixel images) are
currently *moved* to the new grid. They’d instead have to be copied.
</content>
</entry>
<entry>
<title>Add support for creating utmp records</title>
<updated>2022-09-23T21:02:25Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-09-23T18:24:04Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=aa10b1d2da3ecf9672ae915a49073bd30ee0a785'/>
<id>urn:sha1:aa10b1d2da3ecf9672ae915a49073bd30ee0a785</id>
<content type='text'>
This patch adds support for creating utmp records using the ‘utempter’
helper binary from the ‘libutempter’ package.

* New config option ‘main.utempter’
* New meson command line option, -Ddefault-utempter-path. Defaults to
  auto-detecting the path.

The default value of the new ‘main.utempter’ config option depends on
the meson command line option ‘-Ddefault-utempter-path’.

If ‘main.utempter’ is *not* set to ‘none’, foot will try to execute
the utempter helper binary to create utmp records when a new terminal
is instantiated. The record is removed when the terminal instance is
destroyed.
</content>
</entry>
<entry>
<title>config: change default ‘pad’ to 0x0 (i.e. no padding)</title>
<updated>2022-09-03T10:17:46Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-09-03T10:16:41Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=2d1ded183ac1c79b93f2674fed3ec7c0def65075'/>
<id>urn:sha1:2d1ded183ac1c79b93f2674fed3ec7c0def65075</id>
<content type='text'>
</content>
</entry>
<entry>
<title>theme: change default color theme to solarized-dark-normal-brights</title>
<updated>2022-08-22T11:37:12Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-08-17T16:12:51Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=3cf11bfea9e4787998c538bd312c456fd8287fd1'/>
<id>urn:sha1:3cf11bfea9e4787998c538bd312c456fd8287fd1</id>
<content type='text'>
This is my variant of the solarized theme, were only the first eight
colors (i.e. the "normal") colors are from the solarized theme. The
remaining eight (the "bright" colors) are brightened versions of the
"normal" colors. This results in a theme that is usually in all
applications, not just those that are "aware" that the terminal color
theme is "solarized".
</content>
</entry>
<entry>
<title>config: add setting for underline thickness</title>
<updated>2022-08-20T20:16:32Z</updated>
<author>
<name>Yorick Peterse</name>
<email>git@yorickpeterse.com</email>
</author>
<published>2022-08-19T00:54:49Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=a0942f950df3b8826db4b1a3f149b7d0ed45adcf'/>
<id>urn:sha1:a0942f950df3b8826db4b1a3f149b7d0ed45adcf</id>
<content type='text'>
This adds an "underline-thickness" setting to the "main" section,
similar to the existing "underline-offset" setting. This setting is used
to specify a custom height for regular (= non-cursor) underlines.

Fixes #1136
</content>
</entry>
<entry>
<title>unicode-mode: ‘q’ aborts Unicode input mode</title>
<updated>2022-07-29T09:56:41Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-07-29T09:56:41Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=0cbd99710b9d9ff5116c39e1d989556a6d7c27a8'/>
<id>urn:sha1:0cbd99710b9d9ff5116c39e1d989556a6d7c27a8</id>
<content type='text'>
</content>
</entry>
<entry>
<title>input: add new Unicode input mode</title>
<updated>2022-07-29T07:26:31Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-07-28T16:09:16Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=8967dd9cfe51276d63ef8ff64e8fc76f80a6fa3d'/>
<id>urn:sha1:8967dd9cfe51276d63ef8ff64e8fc76f80a6fa3d</id>
<content type='text'>
This mode is activated through the new key-bindings.unicode-input and
search-bindings.unicode-input key bindings.

When active, the user can “build” a Unicode codepoint by typing its
hexadecimal value.

Note that there’s no visual feedback in this mode. This is
intentional. This mode is intended to be a fallback for users that
don’t use an IME.

Closes #1116
</content>
</entry>
<entry>
<title>config: add colors.search-box-{no-,}match</title>
<updated>2022-07-28T17:02:56Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-07-27T17:14:27Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=d79a3b9350ba864464229a1c188e2f696fac5a26'/>
<id>urn:sha1:d79a3b9350ba864464229a1c188e2f696fac5a26</id>
<content type='text'>
Closes #1112
</content>
</entry>
<entry>
<title>osc: add support for OSC 133;A (prompt markers)</title>
<updated>2022-06-16T17:02:10Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-06-15T16:44:23Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=bdb79e8b9fb36f627bb204ce2060dd5a877f3712'/>
<id>urn:sha1:bdb79e8b9fb36f627bb204ce2060dd5a877f3712</id>
<content type='text'>
This patch adds support for the OSC-133;A sequence, introduced by
FinalTerm and implemented by iTerm2, Kitty and more. See
https://iterm2.com/documentation-one-page.html#documentation-escape-codes.html.

The shell emits the OSC just before printing the prompt. This lets the
terminal know where, in the scrollback, there are prompts.

We implement this using a simple boolean in the row struct ("this row
has a prompt"). The prompt marker must be reflowed along with the text
on window resizes.

In an ideal world, erasing, or overwriting the cell where the OSC was
emitted, would remove the prompt mark. Since we don't store this
information in the cell struct, we can't do that. The best we can do
is reset it in erase_line(). This works well enough in the "normal"
screen, when used with a "normal" shell. It doesn't really work in
fullscreen apps, on the alt screen. But that doesn't matter since we
don't support jumping between prompts on the alt screen anyway.

To be able to jump between prompts, two new key bindings have been
added: prompt-prev and prompt-next, bound to ctrl+shift+z and
ctrl+shift+x respectively.

prompt-prev will jump to the previous, not currently visible, prompt,
by moving the viewport, ensuring the prompt is at the top of the
screen.

prompt-next jumps to the next prompt, visible or not. Again, by moving
the viewport to ensure the prompt is at the top of the screen. If
we're at the bottom of the scrollback, the viewport is instead moved
as far down as possible.

Closes #30
</content>
</entry>
<entry>
<title>doc: document the new ‘environment’ config section</title>
<updated>2022-06-13T09:55:23Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-05-28T17:28:36Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=5760bcb3bf168f7c4a695c667ef0316751452803'/>
<id>urn:sha1:5760bcb3bf168f7c4a695c667ef0316751452803</id>
<content type='text'>
</content>
</entry>
<entry>
<title>config: use $HOME instead of getpwuid() to retrieve users’s home dir</title>
<updated>2022-05-25T15:02:41Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-05-24T16:18:15Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=bc7214cd885f08306f2fa833af2b5c72a6cc88c4'/>
<id>urn:sha1:bc7214cd885f08306f2fa833af2b5c72a6cc88c4</id>
<content type='text'>
When searching for foot.ini, use $HOME instead of getpwuid() to
retrieve the user’s home directory.
</content>
</entry>
<entry>
<title>doc: foot.ini: drop empty line after *show-urls-launch*</title>
<updated>2022-04-23T18:08:09Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-04-23T18:08:09Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=f0f0fac77fd5a60af080e961468619e93e44ed09'/>
<id>urn:sha1:f0f0fac77fd5a60af080e961468619e93e44ed09</id>
<content type='text'>
</content>
</entry>
<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>
</feed>
