theme: document setting iconify/close/max colors separately

diff --git a/docs/labwc-theme.5.scd b/docs/labwc-theme.5.scd
index c22d5292d76d48c5c9daa75b1d397c1236e6bbda..aa832f9e236bf74a50171be7fac97ea330963c86 100644 (file)
--- 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 0a27c43a05a7048f3d38d5f5d31b66f2ff472fc8..d159b8c590740d90dbece174d8f6b301672658dc 100644 (file)
--- 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