From: Johan Malm <jgm323@gmail.com>
Date: Tue, 23 Sep 2025 18:26:52 +0000 (+0100)
Subject: labwc-config(5): document <promptCommand>
X-Git-Url: https://git.mdlowis.com/?a=commitdiff_plain;h=5fdebedcd99d03a38c50f650a3d016c0850811d7;p=proto%2Flabwc.git

labwc-config(5): document <promptCommand>
---

diff --git a/docs/labwc-config.5.scd b/docs/labwc-config.5.scd
index 7ddf2d5b..52cd9638 100644
--- a/docs/labwc-config.5.scd
+++ b/docs/labwc-config.5.scd
@@ -179,6 +179,7 @@ this is for compatibility with Openbox.
   <reuseOutputMode>no</reuseOutputMode>
   <xwaylandPersistence>no</xwaylandPersistence>
   <primarySelection>yes</primarySelection>
+  <promptCommand>[see details below]</promptCommand>
 </core>
 ```
 
@@ -265,6 +266,53 @@ this is for compatibility with Openbox.
 	up/down) in Chromium and electron based clients without inadvertantly
 	pasting the primary clipboard. Default is yes.
 
+*<core><promptCommand>*
+	Set command to be invoked for an action prompt (*<action><prompt>*)
+
+	The following conversion specifiers are supported:
+	- *%m*: the *<prompt>* message option
+	- *%n*: "No" (in local language if translation is available)
+	- *%y*: "Yes" (in local language if translation is available)
+	- *%b*: osd.bg.color
+	- *%t*: osd.label.text.color
+
+	The default prompt command is:
+
+	```
+	labnag \\
+		--message '%m' \\
+		--button-dismiss '%n' \\
+		--button-dismiss '%y' \\
+		--background '%b' \\
+		--text '%t' \\
+		--border '%t' \\
+		--border-bottom '%t' \\
+		--button-background '%b' \\
+		--button-text '%t' \\
+		--border-bottom-size 1 \\
+		--button-border-size 3 \\
+		--timeout 0
+	```
+
+	Example 1: The prompt can be configured to use a different dialog client
+
+	```
+	<core>
+	  <promptCommand>zenity --question --text="%m"</promptCommand>
+	</core>
+	```
+
+	Example 2: A more complex zenity command could be used:
+
+	```
+	zenity \\
+		--question \\
+		--title="" \\
+		--text="%m" \\
+		--ok-label="%y" \\
+		--cancel-label="%n"
+	```
+
 ## PLACEMENT
 
 ```