From d08096b20166372ff8a811300276c11785553882 Mon Sep 17 00:00:00 2001
From: Craig Barnes <craigbarnes@protonmail.com>
Date: Sun, 30 May 2021 03:29:31 +0100
Subject: [PATCH 1/2] doc: add ENVIRONMENT section to foot(1) and footclient(1)
 man pages

Closes #556
---
 CHANGELOG.md         |  2 ++
 doc/foot.1.scd       | 43 +++++++++++++++++++++++++++++++++++++++++++
 doc/footclient.1.scd | 24 ++++++++++++++++++++++++
 3 files changed, 69 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6ff2c71f..60662d13 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -55,6 +55,7 @@
 * `${window-title}` to `notify`.
 * Support for including files in `foot.ini`
   (https://codeberg.org/dnkl/foot/issues/555).
+* `ENVIRONMENT` section in **foot**(1) and **footclient**(1) man pages.
 
 
 ### Changed
@@ -145,6 +146,7 @@
 ### Security
 ### Contributors
 * [r\_c\_f](https://codeberg.org/r_c_f)
+* [craigbarnes](https://codeberg.org/craigbarnes)
 
 
 ## 1.7.2
diff --git a/doc/foot.1.scd b/doc/foot.1.scd
index 8537ee5f..fc93029b 100644
--- a/doc/foot.1.scd
+++ b/doc/foot.1.scd
@@ -325,6 +325,49 @@ numbers, when in _application_ mode.
 
 See *foot.ini*(5)
 
+# ENVIRONMENT
+
+The following environment variables are used by foot:
+
+*SHELL*
+	The default child process to run, when no _command_ argument is
+	specified and the *shell* option in *foot.ini*(5) is not set.
+
+*XDG\_CONFIG\_HOME*
+	Used to determine the default location of *foot.ini*(5).
+
+*XDG\_CONFIG\_DIRS*
+	Used to determine the default fallback location of *foot.ini*(5),
+	when not found in *${XDG\_CONFIG\_HOME:-~/.config}*.
+
+*XDG\_RUNTIME\_DIR*
+	Used to construct the default _PATH_ for the *--server*
+	option, when no explicit argument is given (see above).
+
+*WAYLAND\_DISPLAY*
+	Used to construct the default _PATH_ for the *--server*
+	option, when no explicit argument is given (see above).
+
+*XCURSOR\_THEME*
+	The name of the *Xcursor*(3) theme to use for pointers (typically
+	set by the Wayland compositor).
+
+*XCURSOR\_SIZE*
+	The size to use for *Xcursor*(3) pointers (typically set by the
+	Wayland compositor).
+
+The following environment variables are set in the child process:
+
+*TERM*
+	terminfo/termcap identifier. This is used by client applications
+	to determine which capabilities a terminal supports. The value is
+	set according to either the *--term* command-line option or the
+	*term* config option in *foot.ini*(5).
+
+*COLORTERM*
+	This variable is set to *truecolor*, to indicate to client
+	applications that 24-bit RGB colors are supported.
+
 # BUGS
 
 Please report bugs to https://codeberg.org/dnkl/foot/issues
diff --git a/doc/footclient.1.scd b/doc/footclient.1.scd
index fcd2f5d1..a66c5765 100644
--- a/doc/footclient.1.scd
+++ b/doc/footclient.1.scd
@@ -88,6 +88,30 @@ failure in the foot server.
 In all other cases the exit code is that of the client application
 (i.e. the shell).
 
+# ENVIRONMENT
+
+The following environment variables are used by footclient:
+
+*XDG\_RUNTIME\_DIR*
+	Used to construct the default _PATH_ for the *--server-socket*
+	option, when no explicit argument is given (see above).
+
+*WAYLAND\_DISPLAY*
+	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:
+
+*TERM*
+	terminfo/termcap identifier. This is used by client applications
+	to determine which capabilities a terminal supports. The value is
+	set according to either the *--term* command-line option or the
+	*term* config option in *foot.ini*(5).
+
+*COLORTERM*
+	This variable is set to *truecolor*, to indicate to client
+	applications that 24-bit RGB colors are supported.
+
 # SEE ALSO
 
 *foot*(1)

From 4e3fdaa8f20041a567f3d60a29c71d4bcb82165c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Daniel=20Ekl=C3=B6f?= <daniel@ekloef.se>
Date: Sun, 30 May 2021 10:21:24 +0200
Subject: [PATCH 2/2] =?UTF-8?q?changelog:=20add=20bug=20ref=20to=20?=
 =?UTF-8?q?=E2=80=98environment=20section=20added=20to=20foot/footclient?=
 =?UTF-8?q?=E2=80=99?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 60662d13..7c7094aa 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -55,7 +55,8 @@
 * `${window-title}` to `notify`.
 * Support for including files in `foot.ini`
   (https://codeberg.org/dnkl/foot/issues/555).
-* `ENVIRONMENT` section in **foot**(1) and **footclient**(1) man pages.
+* `ENVIRONMENT` section in **foot**(1) and **footclient**(1) man pages
+  (https://codeberg.org/dnkl/foot/issues/556).
 
 
 ### Changed