<feed xmlns='http://www.w3.org/2005/Atom'>
<title>mirrors/foot.git/INSTALL.md, branch 1.9.2</title>
<subtitle>A fast, lightweight and minimalistic Wayland terminal emulator</subtitle>
<id>https://git.0x0f.dev/mirrors/foot.git/atom?h=1.9.2</id>
<link rel='self' href='https://git.0x0f.dev/mirrors/foot.git/atom?h=1.9.2'/>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/'/>
<updated>2021-10-02T12:46:02Z</updated>
<entry>
<title>pgo: full-inner: do not set LC_CTYPE=en_US.UTF-8</title>
<updated>2021-10-02T12:46:02Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-10-02T12:43:02Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=9389f337d0f75bcdeaf95cbfc9c8525db0e2007b'/>
<id>urn:sha1:9389f337d0f75bcdeaf95cbfc9c8525db0e2007b</id>
<content type='text'>
That locale may not exist. Instead, require the user/build script to
explicitly set an UTF-8 locale.

Document this in INSTALL.md, and in the bundled PKGBUILD.
</content>
</entry>
<entry>
<title>install.md: document pgo/*.sh scripts</title>
<updated>2021-09-12T14:57:07Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-09-12T14:57:07Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=aa0f2a71cce125ae30c2baa05e7a1802d30fe1f0'/>
<id>urn:sha1:aa0f2a71cce125ae30c2baa05e7a1802d30fe1f0</id>
<content type='text'>
</content>
</entry>
<entry>
<title>install: terminfo: pipe sed output to tic</title>
<updated>2021-08-30T17:42:02Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-30T17:42:02Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=55433d77976d9b48e1c0d23fb4bc40e9191ac69a'/>
<id>urn:sha1:55433d77976d9b48e1c0d23fb4bc40e9191ac69a</id>
<content type='text'>
Related to #700
</content>
</entry>
<entry>
<title>install: document how to manually pre-process the terminfo source file</title>
<updated>2021-08-30T17:35:56Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-30T17:35:56Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=051745d7b1654ebfa11ff556bb8413ca8f2de996'/>
<id>urn:sha1:051745d7b1654ebfa11ff556bb8413ca8f2de996</id>
<content type='text'>
Related to #700
</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>slave: set TERMINFO instead of TERMINFO_DIRS</title>
<updated>2021-08-18T18:18:35Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-08-18T18:18:35Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=8a7264e90577205e81cccb76117e93282d65697c'/>
<id>urn:sha1:8a7264e90577205e81cccb76117e93282d65697c</id>
<content type='text'>
This seems to be slightly better supported than TERMINFO_DIRS. It also
simplifies our code, since it’s no longer an issue of whether to
append or not - we just set TERMINFO, and ignore whatever it was set
to before.

Also closes #687
</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>meson: add -Ddocs=disabled|enabled|auto command line option</title>
<updated>2021-07-24T11:12:10Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-07-24T11:09:25Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=7c686208a18f93ec1f955c289045251af5ef6056'/>
<id>urn:sha1:7c686208a18f93ec1f955c289045251af5ef6056</id>
<content type='text'>
When enabled (the default, if scdoc is found), we build and install
the man pages, example foot.ini, readme, changelog and license files.
</content>
</entry>
<entry>
<title>install: add -Dgrapheme-clustering to the list of custom meson options</title>
<updated>2021-06-24T15:57:34Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-06-24T15:57:34Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=4a6dea04c2ddf15b64300bc6db37dc7055f91d0c'/>
<id>urn:sha1:4a6dea04c2ddf15b64300bc6db37dc7055f91d0c</id>
<content type='text'>
</content>
</entry>
<entry>
<title>install: add the new ‘terminfo-install-location’ option</title>
<updated>2021-06-23T15:04:12Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-06-23T14:55:26Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=501548080d4752b22b650ac9ec82ac5e9d6d9610'/>
<id>urn:sha1:501548080d4752b22b650ac9ec82ac5e9d6d9610</id>
<content type='text'>
And flesh out the description of the ‘terminfo’ option, and how it
relates to the new ‘terminfo-install-location’.

Also add instructions on how to manually generate the terminfo files.
</content>
</entry>
<entry>
<title>INSTALL: fix an unclosed markdown quote</title>
<updated>2021-05-13T08:49:38Z</updated>
<author>
<name>Daniel Martí</name>
<email>mvdan@mvdan.cc</email>
</author>
<published>2021-05-13T08:49:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=8ae8635add276565baf6bf7ab17b563bc106121a'/>
<id>urn:sha1:8ae8635add276565baf6bf7ab17b563bc106121a</id>
<content type='text'>
While skimming this doc, I noticed that "-Dterminfo" wasn't rendering
properly as it was lacking its closing backquote.

While at it, tweak the Arch wiki link, as it redirects to replace
/index.php with /title.
</content>
</entry>
<entry>
<title>install: add ‘ninja test’ to all build types</title>
<updated>2021-03-28T15:24:35Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-03-28T15:24:35Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=a88a86f797c22dc8a678eb3174df647731650c79'/>
<id>urn:sha1:a88a86f797c22dc8a678eb3174df647731650c79</id>
<content type='text'>
While we don’t (yet) have any unit tests for foot, users can build
foot with e.g. fcft and/or tllist as sub-projects. *They* have tests,
and when doing PGO builds, those test binaries *must* be executed, or
we get link failures in the final build.
</content>
</entry>
<entry>
<title>install: clang-11.x compatible PGO instructions</title>
<updated>2021-03-26T21:16:55Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-03-26T19:43:21Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=3fd9256c0207cd7ff0b36b69282d70463be4dfb3'/>
<id>urn:sha1:3fd9256c0207cd7ff0b36b69282d70463be4dfb3</id>
<content type='text'>
LLVM/Clang 11.x throws errors for _files_ without any profiling data:

  error: ../../async.c: Function control flow change detected (hash mismatch) async_write Hash = 72057641800614222 [-Werror,-Wbackend-plugin]

This caused multiple issues with the current PGO instructions:

* The `pgo` binary failed to link with `meson configure -Db_pgo=use`
  when doing a full PGO build (since it isn't used in this case);
* `footclient` fails to link for the same reason.
* `foot` fails to link for the same reason in **partial** PGO builds.

The solution is to make sure all binaries that are built in the final
phase (`-Db_pgo=use`) have been executed in the _generate_ phase.

Doing this also means we can drop `-Wno-missing-profile` and friends.

Also add `--sixel` to the `generate-alt-random-writes` command line in
the description for a full PGO build.

Closes #418
</content>
</entry>
<entry>
<title>install: add ‘llvm’ as an optional build dependency</title>
<updated>2021-03-26T21:16:54Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-03-26T19:43:03Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=243578d308e2ce27fed24250dac5b363be1c05c5'/>
<id>urn:sha1:243578d308e2ce27fed24250dac5b363be1c05c5</id>
<content type='text'>
It is needed for PGO builds with Clang.
</content>
</entry>
<entry>
<title>Add: Bash completion for foot and footclient</title>
<updated>2021-03-17T12:10:28Z</updated>
<author>
<name>Simon Schricker</name>
<email>s.schricker@sillage.at</email>
</author>
<published>2021-03-13T18:04:33Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=b169623b642d44109bb073b7b7fe2f1e88a5da69'/>
<id>urn:sha1:b169623b642d44109bb073b7b7fe2f1e88a5da69</id>
<content type='text'>
* use toe for terminfo, thanks Craig.
* adds optional dependency on bash-completion for positional arguments

Co-authored-by: Craig Barnes &lt;craigbarnes@protonmail.com&gt;
</content>
</entry>
<entry>
<title>install: add libnotify and xdg-utils as optional dependencies</title>
<updated>2021-02-14T11:10:38Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-02-14T11:10:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=4ff07a0d18109d6064d5374ba05cc246a024db24'/>
<id>urn:sha1:4ff07a0d18109d6064d5374ba05cc246a024db24</id>
<content type='text'>
</content>
</entry>
<entry>
<title>install: add -Dterminfo to list of compile-time options</title>
<updated>2021-02-09T18:46:06Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2021-02-09T18:46:06Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=3d71b7444283d20c33d9d1fc022758c5c6a567c8'/>
<id>urn:sha1:3d71b7444283d20c33d9d1fc022758c5c6a567c8</id>
<content type='text'>
</content>
</entry>
<entry>
<title>install: remove -march=native</title>
<updated>2020-12-21T12:01:38Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2020-12-21T12:01:38Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=aa13dfb4e84df8565c6834f89d3ae294079d0d91'/>
<id>urn:sha1:aa13dfb4e84df8565c6834f89d3ae294079d0d91</id>
<content type='text'>
This simplifies the instructions. People interested in performance are
likely to know how to use it.
</content>
</entry>
<entry>
<title>install.md: mention that packagers should not use -march=native</title>
<updated>2020-12-21T11:24:47Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2020-12-21T11:24:47Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=4fe95e6354dc7ed9009d53d8a46ad2d5e327d0d6'/>
<id>urn:sha1:4fe95e6354dc7ed9009d53d8a46ad2d5e327d0d6</id>
<content type='text'>
</content>
</entry>
<entry>
<title>install.md: add -Wno-profile-instr-unprofiled to clang flags in PGO builds</title>
<updated>2020-12-21T11:24:29Z</updated>
<author>
<name>Daniel Eklöf</name>
<email>daniel@ekloef.se</email>
</author>
<published>2020-12-21T11:24:29Z</published>
<link rel='alternate' type='text/html' href='https://git.0x0f.dev/mirrors/foot.git/commit/?id=5a1dcbb04dcd4246b1b822311f0f37c5a8d2988d'/>
<id>urn:sha1:5a1dcbb04dcd4246b1b822311f0f37c5a8d2988d</id>
<content type='text'>
</content>
</entry>
</feed>
