<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/doc/foot.1.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-20T14:40:36Z</updated>
<entry>
<title>slave: set $TERM_PROGRAM and $TERM_PROGRAM_VERSION environment variables</title>
<updated>2023-03-20T14:40:36Z</updated>
<author>
<name>Craig Barnes</name>
<email>craigbarnes@protonmail.com</email>
</author>
<published>2023-03-20T14:40:36Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=5b2f02d826d8043b6b89860c56802ea5fed0f3bd'/>
<id>urn:sha1:5b2f02d826d8043b6b89860c56802ea5fed0f3bd</id>
<content type='text'>
These are already being set by iTerm2, WezTerm, tmux and likely some
others. Even though using yet more environment variables seems rather
questionable, if we don't set these we run the risk of inheriting them
from other terminals.

See also:

* https://gitlab.com/gnachman/iterm2/-/blob/97a6078df8e822da165e91737a01c0b9e115dd16/sources/PTYSession.m#L2568-2570
* https://github.com/tmux/tmux/blob/1d0f68dee9f71c504e03616fa472a408a6caa49b/environ.c#L263-L264
* https://github.com/search?q=TERM_PROGRAM&amp;type=code
</content>
</entry>
<entry>
<title>doc: foot: add PWD to list of env vars set in child process</title>
<updated>2022-12-04T18:49:02Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-12-04T18:49:02Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=1486c57bdb084e5c41f917fd542a3605dcaa90a0'/>
<id>urn:sha1:1486c57bdb084e5c41f917fd542a3605dcaa90a0</id>
<content type='text'>
</content>
</entry>
<entry>
<title>readme/foot.1: mention that we now need “-d info” to get log output</title>
<updated>2022-11-23T15:27:50Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-11-23T15:27:50Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=dfabc5d75423c863a7e9a930b9a8aac593784e02'/>
<id>urn:sha1:dfabc5d75423c863a7e9a930b9a8aac593784e02</id>
<content type='text'>
</content>
</entry>
<entry>
<title>change default log level to WARNING</title>
<updated>2022-11-22T15:22:22Z</updated>
<author>
<name>Antoine Beaupré</name>
<email>anarcat@debian.org</email>
</author>
<published>2022-11-18T16:07:16Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b80c7f75fea0c1a69471d1f67aa97b584d3e48b2'/>
<id>urn:sha1:b80c7f75fea0c1a69471d1f67aa97b584d3e48b2</id>
<content type='text'>
The default foot output looks like this, in Debian testing "bookworm"
at the time of writing:

    anarcat@angela:pubpaste$ foot true
    info: main.c:421: version: 1.13.1 +pgo +ime +graphemes -assertions
    info: main.c:428: arch: Linux x86_64/64-bit
    info: main.c:440: locale: fr_CA.UTF-8
    info: config.c:3003: loading configuration from /home/anarcat/.config/foot/foot.ini
    info: fcft.c:338: fcft: 3.1.5 +graphemes -runs +svg(nanosvg) -assertions
    info: fcft.c:377: fontconfig: 2.13.1, freetype: 2.12.1, harfbuzz: 5.2.0
    info: fcft.c:838: /home/anarcat/.local/share/fonts/Fira-4.202/otf/FiraMono-Regular.otf: size=8.00pt/8px, dpi=75.00
    info: wayland.c:1353: eDP-1: 2256x1504+0x0@60Hz 0x095F 13.32" scale=2 PPI=205x214 (physical) PPI=136x143 (logical), DPI=271.31
    info: wayland.c:1509: requesting SSD decorations
    info: fcft.c:838: /home/anarcat/.local/share/fonts/Fira-4.202/otf/FiraMono-Bold.otf: size=24.00pt/32px, dpi=96.00
    info: fcft.c:838: /home/anarcat/.local/share/fonts/Fira-4.202/otf/FiraMono-Regular.otf: size=24.00pt/32px, dpi=96.00
    info: fcft.c:838: /home/anarcat/.local/share/fonts/Fira-4.202/otf/FiraMono-Bold.otf: size=24.00pt/32px, dpi=96.00
    info: fcft.c:838: /home/anarcat/.local/share/fonts/Fira-4.202/otf/FiraMono-Regular.otf: size=24.00pt/32px, dpi=96.00
    info: terminal.c:700: cell width=19, height=39
    info: terminal.c:588: using 16 rendering threads
    info: wayland.c:859: using SSD decorations
    info: main.c:680: goodbye
    anarcat@angela:pubpaste$

That's 17 lines of output that are *mostly* useless for most use
cases. I might understand having this output during the project's
startup, when it's helpful for diagnostics, but now Foot just mostly
works everywhere, and I've never had a use for any of that stuff in
the (arguably short) time I've been using Foot so far.

And if I do, there's the `--log-level` commandline option to tweak
this. At first, I looked at tweaking the log level through the config
file. But as explained in this issue:

https://codeberg.org/dnkl/foot/issues/1142

... there's a chicken and egg problem there that makes it hard to
implement and possibly confusing for users as well.

There's also the possibility for users to change the shortcut with
which they start foot, for example a `.desktop` file so that menu
systems that support those start foot properly. But that only works in
that environment, and not through the so many things that will just
call `foot` and hope it will do the right thing.

In my case, I have `foot` hardcoded in a lot of places now, between
sway and waybar, and this is only going to grow. Others have suggested
adding the flag to a $TERMINAL global variable, but that won't help
.desktop users.

So, instead of playing whack-a-mole with the log levels, just make it
so that, by default, foot is silent. This is actually one of the
[basics of UNIX philosophy][1]:

&gt; Rule of Silence: When a program has nothing surprising to say, it
&gt; should say nothing.

And yes, I am aware I am severely violating that principle by writing
a way too long commit log for a one-line patch, but there you go, I
figured it was good to document the why of this properly.

[1]: https://web.archive.org/web/20031102053334/http://www.faqs.org/docs/artu/ch01s06.html
</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>config: add ctrl+shift+v and XF86 paste to SEARCH_CLIPBOARD_PASTE</title>
<updated>2022-04-26T18:37:30Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2022-04-26T16:34:18Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=aa4c7c5a30a792a9519b971ff14582dc2704b6bc'/>
<id>urn:sha1:aa4c7c5a30a792a9519b971ff14582dc2704b6bc</id>
<content type='text'>
We now bind ctrl+v, ctrl+shift+v, ctrl+y and XF86Paste to pasting from
the clipboard into the scrollback search buffer.

Why all these? Because we can, and because all are common shortcuts
for pasting:

* ctrl+v: “normal” apps use this by default
* ctrl+shift+v: used in terminals (including foot)
* ctrl+y: Emacs
* XF86Paste: special keyboard key, for pasting
</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>
<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>
</feed>
