added 'SetXProp' action and (@PROP=foo) clientpattern

these two allow 'tagging' of arbitrary windows with 'tags' (or 'labels'). such 'tagged' windows can then be used in ':NextWindow (@PROP=foo)' commands to quickly cycle through a subset of available windows.
since the 'tags' are applied as real xproperties to a window they survive a restart of fluxbox or even another windowmanager. the user can also set the tags by using xprop(1).

the next step regarding the UI should be to visualize the tags of a window.

2 files changed, 17 insertions, 0 deletions

diff --git a/doc/asciidoc/client-patterns.txt b/doc/asciidoc/client-patterns.txt
index 85dac7b..5b00e0c 100644
--- a/doc/asciidoc/client-patterns.txt
+++ b/doc/asciidoc/client-patterns.txt
@@ -64,6 +64,9 @@ The following values are accepted for 'propertyname':::
 *Layer*;;
         The string name of the window's layer, which is one of
         *AboveDock*, *Dock*, *Top*, *Normal*, *Bottom*, *Desktop*
+*@XPROP*;;
+        A string, corresponding to any xproperty (Use either the *xprop(1)*
+        utility or the 'SetXProp' command to set a xproperty to a window)
 
 .Matches any windows with the CLASSNAME of "xterm"
 ..........
@@ -79,3 +82,9 @@ The following values are accepted for 'propertyname':::
 ...........
 (Head=[mouse]) (Layer!=[current])
 ...........
+
+.Matches any windows having a xproperty named FOO with "bar" in it
+..............
+(@FOO=.*bar.*)
+..............
+
diff --git a/doc/asciidoc/fluxbox-keys.txt b/doc/asciidoc/fluxbox-keys.txt
index 41ad1e2..16bc18c 100644
--- a/doc/asciidoc/fluxbox-keys.txt
+++ b/doc/asciidoc/fluxbox-keys.txt
@@ -327,6 +327,10 @@ two arguments;;
         heads. If this takes the window beyond the total number of heads, it
         will wrap around to the beginning.
 
+*SetXProp* 'PROP=value'::
+        Sets the xproperty 'PROP' of the current window to 'value'. Delete the
+        content of 'PROP' by using 'PROP='.
+
 Workspace Commands
 ~~~~~~~~~~~~~~~~~~
 These commands affect the entire workspace (or "desktop" as it is sometimes
@@ -643,8 +647,12 @@ Mod4 t :If {Some Matches (xterm)} {NextWindow (xterm)} {Exec xterm}
 
 # Set a different wallpaper on every workspace:
 ChangeWorkspace :Exec fbsetbg ~/.fluxbox/bg$(xprop -root _NET_CURRENT_DESKTOP | awk '{print $3}').png
+
+# Focusses the next window with it's xproperty 'PROP' set to 'foo'
+Mod4 p Mod4 Tab :NextWindow (@PROP=foo)
 ..................
 
+
 AUTHORS
 -------
 - Jim Ramsay <i.am at jimramsay com> (>fluxbox-1.0.0)