aboutsummaryrefslogtreecommitdiff
path: root/INSTALL.md (follow)
Commit message (Collapse)AuthorAgeLines
* pgo: full-inner: do not set LC_CTYPE=en_US.UTF-8Daniel Eklöf2021-10-02-0/+4
| | | | | | | 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.
* install.md: document pgo/*.sh scriptsDaniel Eklöf2021-09-12-0/+26
|
* install: terminfo: pipe sed output to ticDaniel Eklöf2021-08-30-2/+2
| | | | Related to #700
* install: document how to manually pre-process the terminfo source fileDaniel Eklöf2021-08-30-6/+3
| | | | Related to #700
* meson: terminfo install location now defaults to $datadir/terminfoDaniel Eklöf2021-08-30-39/+50
| | | | | | | | | | | | | | | | | | | | | | | | | 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).
* slave: set TERMINFO instead of TERMINFO_DIRSDaniel Eklöf2021-08-18-18/+18
| | | | | | | | | 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
* terminfo: install to $datadir/foot/terminfo by default, append to TERMINFO_DIRSDaniel Eklöf2021-08-17-33/+109
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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=<path>: *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
* meson: add -Ddocs=disabled|enabled|auto command line optionDaniel Eklöf2021-07-24-1/+5
| | | | | When enabled (the default, if scdoc is found), we build and install the man pages, example foot.ini, readme, changelog and license files.
* install: add -Dgrapheme-clustering to the list of custom meson optionsDaniel Eklöf2021-06-24-0/+1
|
* install: add the new ‘terminfo-install-location’ optionDaniel Eklöf2021-06-23-4/+28
| | | | | | | 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.
* INSTALL: fix an unclosed markdown quoteDaniel Martí2021-05-13-5/+5
| | | | | | | | 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.
* install: add ‘ninja test’ to all build typesDaniel Eklöf2021-03-28-0/+3
| | | | | | | 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.
* install: clang-11.x compatible PGO instructionsDaniel Eklöf2021-03-26-11/+17
| | | | | | | | | | | | | | | | | | | | | | | 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
* install: add ‘llvm’ as an optional build dependencyDaniel Eklöf2021-03-26-0/+1
| | | | It is needed for PGO builds with Clang.
* Add: Bash completion for foot and footclientSimon Schricker2021-03-17-0/+1
| | | | | | | * use toe for terminfo, thanks Craig. * adds optional dependency on bash-completion for positional arguments Co-authored-by: Craig Barnes <craigbarnes@protonmail.com>
* install: add libnotify and xdg-utils as optional dependenciesDaniel Eklöf2021-02-14-0/+6
|
* install: add -Dterminfo to list of compile-time optionsDaniel Eklöf2021-02-09-3/+4
|
* install: remove -march=nativeDaniel Eklöf2020-12-21-8/+4
| | | | | This simplifies the instructions. People interested in performance are likely to know how to use it.
* install.md: mention that packagers should not use -march=nativeDaniel Eklöf2020-12-21-0/+4
|
* install.md: add -Wno-profile-instr-unprofiled to clang flags in PGO buildsDaniel Eklöf2020-12-21-1/+4
|
* install: fix typo in ‘ninja’Daniel Eklöf2020-12-21-1/+1
|
* meson: use wrap files for fcft/tllist subprojectsCraig Barnes2020-12-19-18/+3
| | | | See: https://mesonbuild.com/Wrap-dependency-system-manual.html
* install: simplify sentenceDaniel Eklöf2020-12-08-1/+1
|
* install: highlight option default value in options listDaniel Eklöf2020-12-07-1/+1
|
* install: highlight option name in options listDaniel Eklöf2020-12-07-3/+3
|
* install: add ‘options’ section, describing compile-time optionsDaniel Eklöf2020-12-07-0/+10
|
* install: add --sixel to suggested command line for generate-alt-random-writesDaniel Eklöf2020-11-24-0/+1
|
* install: minor tweaks to PGO instructionsDaniel Eklöf2020-11-22-3/+5
|
* install: re-write release build instructionsDaniel Eklöf2020-11-22-42/+51
|
* install: re-write description of recommended flags, and add size comparisonDaniel Eklöf2020-11-22-10/+27
|
* install: no need to run input *that* many timesDaniel Eklöf2020-11-22-1/+1
|
* install: add --attr-{bold,italic,underline} to generate-alt-random-writesDaniel Eklöf2020-11-22-1/+4
|
* remove pre-generated input corpus for PGODaniel Eklöf2020-11-22-2/+22
|
* install: add --colors-256 to generate-alt-random-writesDaniel Eklöf2020-11-22-1/+1
|
* install: small rewording and restructuring of PGO instructionsDaniel Eklöf2020-11-22-12/+10
|
* install: update PGO instructionsDaniel Eklöf2020-11-22-4/+43
|
* install: simplify sentenceDaniel Eklöf2020-11-14-1/+1
|
* install: remove -fno-plt from recommended CFLAGSDaniel Eklöf2020-11-14-2/+2
| | | | It appears to _worsen_ the performance...
* Fix documentation snippetsjeromenerf2020-11-06-2/+3
| | | | | - zsh doesn't like "export var+=value", make it two steps - meson was complaining with "ERROR: Must specify at least one directory name.", so add the relative "../.."
* install: say _why_ ncurses and scdoc is neededDaniel Eklöf2020-09-24-2/+2
|
* Fix typosLennard Hofmann2020-08-15-2/+2
|
* install: tllist is a *build* dependency, not a *runtime* dependencyDaniel Eklöf2020-07-31-1/+1
|
* readme: move 'requirements' into INSTALL.mdDaniel Eklöf2020-07-28-0/+42
|
* readme: move installation instructions to INSTALL.mdDaniel Eklöf2020-07-28-0/+194