From: Johan Malm <jgm323@gmail.com>
Date: Sun, 22 Aug 2021 18:11:54 +0000 (+0100)
Subject: theme: document setting iconify/close/max colors separately
X-Git-Url: https://git.mdlowis.com/?a=commitdiff_plain;h=289c784d5ea83ac81e30552739f53af26ad338ea;p=proto%2Flabwc.git

theme: document setting iconify/close/max colors separately
---

diff --git a/docs/labwc-theme.5.scd b/docs/labwc-theme.5.scd
index c22d5292..aa832f9e 100644
--- a/docs/labwc-theme.5.scd
+++ b/docs/labwc-theme.5.scd
@@ -50,6 +50,14 @@ A theme consists of a themerc file and optionally some xbm icons.
 	Color of the images in titlebar buttons in their default, unpressed,
 	state. This element is for non-focused windows.
 
+Note: The button elements (i.e. window.[in]active.button.\*) support defining
+different types of buttons individually by inserting the type ("iconify", "max"
+and "close") after the button node. For example:
+window.active.button.iconify.unpressed.image.color
+This syntax is not not documented on the openbox.org wiki, but is supported by
+openbox and is used by many popular themes. For the sake of brevity, these
+elements are not listed here, but are supported.
+
 *menu.items.bg.color*
 	Background color of inactive menu items
 
@@ -62,6 +70,19 @@ A theme consists of a themerc file and optionally some xbm icons.
 *menu.items.active.text.color*
 	Text color of active menu item
 
+# BUTTONS
+
+The images used for the titlebar buttons are 1-bit xbm (X Bitmaps). These are
+masks where 0=clear and 1=colored. The xbm image files are placed in the same
+directory within your theme as the themerc file. Here are all the possible xbm
+files looked for:
+
+- max.xbm
+- iconify.xbm
+- close.xbm
+
+More will be supported later.
+
 # DEFINITIONS
 
 The handle is the window edge decoration at the bottom of the window.
diff --git a/docs/themerc b/docs/themerc
index 0a27c43a..d159b8c5 100644
--- a/docs/themerc
+++ b/docs/themerc
@@ -13,6 +13,13 @@ window.inactive.title.bg.color: #f6f5f4
 window.active.button.unpressed.image.color: #000000
 window.inactive.button.unpressed.image.color: #000000
 
+#
+# Note that "iconify", "max", "close" buttons colors can be defined
+# individually by inserting the type after the button node, for example:
+#
+#     window.active.button.iconify.unpressed.image.color: #333333
+#
+
 # menu
 menu.items.bg.color: #fcfbfa
 menu.items.text.color: #000000