From 8a5a04cc1a49f270b14400e1274cdebbfe050aee Mon Sep 17 00:00:00 2001
From: Johan Malm <jgm323@gmail.com>
Date: Tue, 24 Jun 2025 20:44:32 +0100
Subject: [PATCH] labwc-action(5): describe If action <prompt>

---
 docs/labwc-actions.5.scd | 21 +++++++++++++++++++++
 docs/menu.xml            | 10 ++++++++++
 2 files changed, 31 insertions(+)

diff --git a/docs/labwc-actions.5.scd b/docs/labwc-actions.5.scd
index fa38698a..7aa78507 100644
--- a/docs/labwc-actions.5.scd
+++ b/docs/labwc-actions.5.scd
@@ -423,6 +423,7 @@ Actions that execute other actions. Used in keyboard/mouse bindings.
 	```
 	<action name="If">
 	  <query/>
+	  <prompt message=""/>
 	  <then><action/></then>
 	  <else><action/></else>
 	</action>
@@ -494,6 +495,26 @@ Actions that execute other actions. Used in keyboard/mouse bindings.
 
 		This argument is optional.
 
+	*prompt*
+		Display a yes/no prompt dialog (labnag by default). If 'yes' is
+		selected, the *then* branch will be taken; and similarly with
+		'no' and *else*. This argument is optional. Note that the syntax
+		is different to that of Openbox where a prompt element is not
+		tied to If-actions but would just be a child of the downstream
+		action. The reason for this difference is increased flexibility
+		and functionality gained by optionally using an *else* branch.
+
+		```
+		<keybind key="W-q">
+		  <action name="If">
+		    <prompt message="Quit?"/>
+		    <then>
+		      <action name="Exit"/>
+		    </then>
+		  </action>
+		</keybind>
+		```
+
 	*then*
 		A list of actions to be executed if the window matches any
 		query. This argument is optional.
diff --git a/docs/menu.xml b/docs/menu.xml
index d1ea8607..536d63a4 100644
--- a/docs/menu.xml
+++ b/docs/menu.xml
@@ -65,6 +65,16 @@
   <item label="Exit">
     <action name="Exit" />
   </item>
+  <!--
+  # A prompt can be used as follows:
+  <item label="Exit">
+    <action name="If"/>
+      <prompt message="Do you really want to exit the compositor?"/>
+      <then>
+        <action name="Exit"/>
+      </then>
+  </item>
+  -->
 </menu>
 
 <menu id="some-custom-menu">
-- 
2.52.0