doc: document the new ‘environment’ config section

This commit is contained in:
Daniel Eklöf 2022-05-28 19:28:36 +02:00
parent 755f96321a
commit 5760bcb3bf
No known key found for this signature in database
GPG key ID: 5BBD4992C116573F
3 changed files with 23 additions and 4 deletions

View file

@ -458,7 +458,7 @@ In all other cases, the exit code is that of the client application
# ENVIRONMENT
The following environment variables are used by foot:
## Variables used by foot
*SHELL*
The default child process to run, when no _command_ argument is
@ -492,7 +492,7 @@ The following environment variables are used by foot:
The size to use for *Xcursor*(3) pointers (typically set by the
Wayland compositor).
The following environment variables are set in the child process:
## Variables set in the child process
*TERM*
terminfo/termcap identifier. This is used by client applications
@ -504,6 +504,9 @@ The following environment variables are set in the child process:
This variable is set to *truecolor*, to indicate to client
applications that 24-bit RGB colors are supported.
In addition to the variables listed above, custom environment
variables may be defined in *foot.ini*(5).
# BUGS
Please report bugs to https://codeberg.org/dnkl/foot/issues

View file

@ -305,6 +305,19 @@ commented out will usually be installed to */etc/xdg/foot/foot.ini*.
(including SMT). Note that this is not always the best value. In
some cases, the number of physical _cores_ is better.
# SECTION: environment
This section is used to define environment variables that will be set
in the client application, in addition to the variables inherited from
the terminal process itself.
The format is simply:
*name*=_value_
Note: do not set *TERM* here; use the *term* option in the main
(default) section instead.
# SECTION: bell
*urgent*

View file

@ -136,7 +136,7 @@ terminfo entries manually, by copying *foot* and *foot-direct* to
# ENVIRONMENT
The following environment variables are used by footclient:
## Variables used by footclient
*XDG\_RUNTIME\_DIR*
Used to construct the default _PATH_ for the *--server-socket*
@ -146,7 +146,7 @@ The following environment variables are used by footclient:
Used to construct the default _PATH_ for the *--server-socket*
option, when no explicit argument is given (see above).
The following environment variables are set in the child process:
## Variables set in the child process
*TERM*
terminfo/termcap identifier. This is used by client applications
@ -158,6 +158,9 @@ The following environment variables are set in the child process:
This variable is set to *truecolor*, to indicate to client
applications that 24-bit RGB colors are supported.
In addition to the variables listed above, custom environment
variables may be defined in *foot.ini*(5).
# SEE ALSO
*foot*(1)