aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2025-07-31 15:37:19 +0000
committerDaniel Eklöf <daniel@ekloef.se>2025-08-01 07:38:05 +0000
commitb13a8f12d2d360e0923ee30ff40f25b245576bb5 (patch)
tree13b7ce03099a5f6cdb60692cfaf9e2cff546f775 /doc
parentchangelog: SIGUSR changes in the server (diff)
server/client: add support for sending SIGUSR to footclient
This patch adds the IPC infrastructure necessary to propagate SIGUSR1/SIGUSR2 from a footclient process to the server process. By targeting a particular footclient instance, only that particular instance changes theme. This is different from when targeting the server process, where all instances change theme. Closes #2156
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.1.scd6
-rw-r--r--doc/footclient.1.scd15
2 files changed, 18 insertions, 3 deletions
diff --git a/doc/foot.1.scd b/doc/foot.1.scd
index 2aef83ca..8d968a6e 100644
--- a/doc/foot.1.scd
+++ b/doc/foot.1.scd
@@ -694,14 +694,14 @@ variables to unset may be defined in *foot.ini*(5).
The following signals have special meaning in foot:
- SIGUSR1: switch to color theme 1 (i.e. use the *[colors]* section).
-- SIGUSR2: switch to color theme 2 (i.e. use the *[colors2]* section)-
+- SIGUSR2: switch to color theme 2 (i.e. use the *[colors2]* section).
Note: you can send SIGUSR1/SIGUSR2 to a *foot --server* process too,
in which case all client instances will switch theme. Furthermore, all
future client instances will also use the selected theme.
-Sending SIGUSR1/SIGUSR2 to a footclient instance is currently not
-supported.
+You can also send SIGUSR1/SIGUSR2 to a footclient instance, see
+*footclient*(1) for details.
# BUGS
diff --git a/doc/footclient.1.scd b/doc/footclient.1.scd
index 365689af..e4f6d350 100644
--- a/doc/footclient.1.scd
+++ b/doc/footclient.1.scd
@@ -189,6 +189,21 @@ variables may be defined in *foot.ini*(5).
In addition to the variables listed above, custom environment
variables to unset may be defined in *foot.ini*(5).
+# Signals
+
+The following signals have special meaning in footclient:
+
+- SIGUSR1: switch to color theme 1 (i.e. use the *[colors]* section).
+- SIGUSR2: switch to color theme 2 (i.e. use the *[colors2]* section).
+
+When sending SIGUSR1/SIGUSR2 to a footclient instance, the theme is
+changed in that instance only. This is different from when you send
+SIGUSR1/SIGUSR2 to the server process, where all instances change the
+theme.
+
+Note: for obvious reasons, this is not supported when footclient is
+started with *--no-wait*.
+
# SEE ALSO
*foot*(1)