code refactoring

^ib() added
^pa() added


git-svn-id: http://dzen.googlecode.com/svn/trunk@154 f2baff5b-bf2c-0410-a398-912abdc3d8b2

1 files changed, 33 insertions, 5 deletions

diff --git a/README.dzen b/README.dzen
index 0f1790e..36226c4 100644
--- a/README.dzen
+++ b/README.dzen
@@ -390,11 +390,20 @@ displays.
 Currently the following commands are supported:
 
 
+Colors:
+-------
+
     ^^fg(color)         set foreground color
     ^^fg()              without arguments, sets default fg color
     ^^bg(color)         set background color
     ^^bg()              without arguments, sets default bg color
 
+Graphics:
+---------
+
+    ^^i(path)           draw icon specified by path
+                       Supported formats: XBM and optionally XPM
+
     ^^r(WIDTHxHEIGHT)   draw a rectangle with the dimensions 
                        WIDTH and HEIGHT
     ^^ro(WIDTHxHEIGHT)  rectangle outline
@@ -402,10 +411,17 @@ Currently the following commands are supported:
     ^^c(RADIUS)         draw a circle with size RADIUS pixels
     ^^co(RADIUS)        circle outline
 
-    ^^p(PIXEL)          increment momentary position by PIXEL
+Positioning:
+------------
 
-    ^^i(path)           draw icon specified by path
-                       Supported formats: XBM and optionally XPM
+    ^^p(PIXEL)          position next input amount of PIXELs to the right
+                       a.k.a. relative positioning
+    ^^pa(PIXEL)         position next input at PIXEL
+                       a.k.a. absolute positioning
+                       For maximum predictability ^^pa() should only be
+                       used with '-ta l' or '-sa l'
+Other:
+------
 
     ^^tw()              draw to title window
                        This command has some annoyances, as only 
@@ -414,6 +430,20 @@ Currently the following commands are supported:
                        only once and as first command per line
                        Subject to be improved in the future.
 
+    ^^ib(VALUE)         ignore background setting, VALUE can be either
+                       1 to ignore or 0 to not ignore the bg color set
+                       with ^^bg(color)
+                       This command is useful in combination with ^^pa()
+                       in order to position the input inside other already
+                       drawn input.
+
+Example: 
+^^ib(1)^^pa(4)^^fg(red)^^ro(100x15)^^pa(6)^^fg(blue)^^r(20x10)^^fg(orange)^^pa(28)^^r(40x10)^^pa(70)^^p(2)^^fg(darkgreen)^^co(12)^^p(2)^^c(12)
+Giving:
+^ib(1)^pa(4)^fg(red)^ro(100x15)^pa(6)^fg(blue)^r(20x10)^fg(orange)^pa(28)^r(40x10)^pa(70)^p(2)^fg(darkgreen)^co(12)^p(2)^c(12)
+
+
+
 These commands can appear anywhere and in any combination in dzen's
 input. 
 
@@ -428,8 +458,6 @@ you can easily draw your own icons.
         ^fg(Khaki)higher load than lightweight XBM files, so use
         ^fg(Khaki)them with care in tight loops.
 
-Rectangles will be truncated to the maximum possible size if you specify
-a size bigger than dzen's window.
 
 Doubling the '^^' character removes the special meaning from it.