Update rofi-theme manpage

2 files changed, 113 insertions, 89 deletions

diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5
index a5acbc18..b184f5dd 100644
--- a/doc/rofi-theme.5
+++ b/doc/rofi-theme.5
@@ -268,6 +268,9 @@ an orientation
 .IP "\(bu" 4
 a list of keywords
 .
+.IP "\(bu" 4
+Inherit
+.
 .IP "" 0
 .
 .P
@@ -493,6 +496,9 @@ Format: \fB{Integer}px\fR
 Format: \fB{Real}em\fR
 .
 .IP "\(bu" 4
+Format: \fB{Real}ch\fR
+.
+.IP "\(bu" 4
 Format: \fB{Real}%\fR
 .
 .IP "" 0
@@ -504,7 +510,10 @@ A distance can be specified in 3 different units:
 \fBpx\fR: Screen pixels\.
 .
 .IP "\(bu" 4
-\fBem\fR: Relative to text width\.
+\fBem\fR: Relative to text height\.
+.
+.IP "\(bu" 4
+\fBch\fR: Relative to width of a single number\.
 .
 .IP "\(bu" 4
 \fB%\fR: Percentage of the \fBmonitor\fR size\.
@@ -682,6 +691,28 @@ Format: \fB[ keyword, keyword ]\fR
 .P
 A list starts with a \'[\' and ends with a \']\'\. The entries in the list are comma\-separated\. The \fBkeyword\fR in the list refers to an widget name\.
 .
+.SH "Inherit"
+.
+.IP "\(bu" 4
+Format: \fBinherit\fR
+.
+.IP "" 0
+.
+.P
+Inherits the property from its parent widget\.
+.
+.IP "" 4
+.
+.nf
+
+#mainbox {
+    border\-color: inherit;
+}
+.
+.fi
+.
+.IP "" 0
+.
 .SH "ELEMENTS PATHS"
 Element paths exists of two parts, the first part refers to the actual widget by name\. Some widgets have an extra state\.
 .
@@ -692,7 +723,7 @@ For example:
 .
 .nf
 
-#window mainbox listview element \.selected {
+#element selected {
 }
 .
 .fi
@@ -700,7 +731,7 @@ For example:
 .IP "" 0
 .
 .P
-Here \fB#window mainbox listview element\fR is the name of the widget, \fBselected\fR is the state of the widget\.
+Here \fB#element selected\fR is the name of the widget, \fBselected\fR is the state of the widget\.
 .
 .P
 The difference between dots and spaces is purely cosmetic\. These are all the same:
@@ -709,11 +740,11 @@ The difference between dots and spaces is purely cosmetic\. These are all the sa
 .
 .nf
 
-#window mainbox listview element \.selected {
-}
-#window\.mainbox\.listview\.element\.selected {
+#element \.selected {
+
+#element\.selected {
 }
-#window mainbox listview element selected {
+#element selected {
 }
 .
 .fi
@@ -728,29 +759,23 @@ The current widgets available in \fBrofi\fR:
 .IP "\(bu" 4
 .
 .IP "\(bu" 4
-\fB#window\.box\fR: the container holding the window
+\fB#overlay\fR: the overlay widget\.
 .
 .IP "\(bu" 4
-\fB#window\.overlay\fR: the overlay widget
 .
 .IP "\(bu" 4
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.box\fR: the main vertical @box
+\fB#box\fR: the horizontal @box packing the widgets
 .
 .IP "\(bu" 4
+\fB#case\-indicator\fR: the case/sort indicator @textbox
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.inputbar\.box\fR: the horizontal @box packing the widgets
+\fB#prompt\fR: the prompt @textbox
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.inputbar\.case\-indicator\fR: the case/sort indicator @textbox
-.
-.IP "\(bu" 4
-\fB#window\.mainbox\.inputbar\.prompt\fR: the prompt @textbox
-.
-.IP "\(bu" 4
-\fB#window\.mainbox\.inputbar\.entry\fR: the main entry @textbox
+\fB#entry\fR: the main entry @textbox
 .
 .IP "" 0
 
@@ -758,13 +783,10 @@ The current widgets available in \fBrofi\fR:
 .IP "\(bu" 4
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.listview\.box\fR: the listview container
+\fB#scrollbar\fR: the listview scrollbar
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.listview\.scrollbar\fR: the listview scrollbar
-.
-.IP "\(bu" 4
-\fB#window\.mainbox\.listview\.element\fR: the entries in the listview
+\fB#element\fR: the entries in the listview
 .
 .IP "" 0
 
@@ -772,10 +794,7 @@ The current widgets available in \fBrofi\fR:
 .IP "\(bu" 4
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.sidebar\.box\fR: the main horizontal @box packing the buttons
-.
-.IP "\(bu" 4
-\fB#window\.mainbox\.sidebar\.button\fR: the buttons @textbox for each mode
+\fB#button\fR: the buttons @textbox for each mode
 .
 .IP "" 0
 
@@ -783,10 +802,7 @@ The current widgets available in \fBrofi\fR:
 .IP "\(bu" 4
 .
 .IP "\(bu" 4
-\fB#window\.mainbox\.message\.textbox\fR: the message textbox
-.
-.IP "\(bu" 4
-\fB#window\.mainbox\.message\.box\fR: the box containing the message
+\fB#textbox\fR: the message textbox
 .
 .IP "" 0
 
@@ -812,10 +828,10 @@ Optional flag(s) indicating state of the widget, used for theming\.
 These are appended after the name or class of the widget\.
 .
 .SS "Example:"
-\fB#window\.mainbox\.sidebar\.button selected\.normal { }\fR
+\fB#button selected\.normal { }\fR
 .
 .P
-\fB#window\.mainbox\.listview\.element selected\.urgent { }\fR
+\fB#element selected\.urgent { }\fR
 .
 .P
 Currently only the entrybox and scrollbar have states:
@@ -839,7 +855,7 @@ Example:
 .
 .nf
 
-#name\.to\.textbox selected\.active {
+#nametotextbox selected\.active {
     background: #003642;
     foreground: #008ed4;
 }
@@ -913,7 +929,7 @@ The following properties are currently supported:
 .SS "scrollbar:"
 .
 .IP "\(bu" 4
-\fBforeground\fR: color
+\fBbackground\-color\fR: color
 .
 .IP "\(bu" 4
 \fBhandle\-width\fR: distance
@@ -922,7 +938,7 @@ The following properties are currently supported:
 \fBhandle\-color\fR: color
 .
 .IP "\(bu" 4
-\fBforeground\fR: color
+\fBborder\-color\fR: color
 .
 .IP "" 0
 .
@@ -1014,24 +1030,27 @@ The current layout of \fBrofi\fR is structured as follows:
 |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|
 | #window {BOX:vertical}                                                             |
 | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|  |
-| | #window\.mainbox  {BOX:vertical}                                               |  |
+| | #mainbox  {BOX:vertical}                                                      |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |  |
-| | | #window\.mainbox\.inputbar {BOX:horizontal}                                 | |  |
-| | | |\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-| | |  |
-| | | | prompt | | entry                                                 | |ci| | |  |
-| | | |\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-| | |  |
+| | | #inputbar {BOX:horizontal}                                                | |  |
+| | | |\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-| | |  |
+| | | | #prompt | | #entry                                              | |#ci| | |  |
+| | | |\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-| | |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |  |
 | |                                                                               |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |  |
-| | | #window\.mainbox\.message                                                   | |  |
+| | | #message                                                                  | |  |
+| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | |  |
+| | | | #textbox                                                              | | |  |
+| | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |  |
 | |                                                                               |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|  |
-| | | #window\.mainbox\.listview                                                    |  |
+| | | #listview                                                                   |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|  |
 | |                                                                               |  |
 | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |  |
-| | | #window\.mainbox\.sidebar {BOX:horizontal}                                  | |  |
+| | | #sidebar {BOX:horizontal}                                                 | |  |
 | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|   |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|  |\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | |  |
 | | | | Button        |   | Button        |  | Button       | | Button        | | |  |
 | | | |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|   |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-|  |\-\-\-\-\-\-\-\-\-\-\-\-\-\-| |\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-| | |  |
@@ -1112,34 +1131,31 @@ Below is an example of a theme emulating dmenu:
 #window {
     anchor:     north;
     location:   north;
-}
-
-#window box {
     width:      100%;
     padding:    4px;
     children:   [ horibox ];
 }
 
-#window horibox box {
+#horibox {
     orientation: horizontal;
     children:   [ prompt, entry, listview ];
 }
 
-#window horibox listview box {
+#listview {
     layout:     horizontal;
     spacing:    5px;
     lines:      10;
 }
 
-#window horibox entry {
+#entry {
     expand:     false;
     width:      10em;
 }
 
-#window horibox listview element {
+#element {
     padding: 0px 2px;
 }
-#window horibox listview element selected {
+#element selected {
     background: SteelBlue;
 }
 .
diff --git a/doc/rofi-theme.5.markdown b/doc/rofi-theme.5.markdown
index 1786cd38..dadc7df9 100644
--- a/doc/rofi-theme.5.markdown
+++ b/doc/rofi-theme.5.markdown
@@ -186,6 +186,7 @@ The current theme format supports different types:
  * a reference
  * an orientation
  * a list of keywords
+ * Inherit
 
 Some of these types are a combination of other types.
 
@@ -319,12 +320,14 @@ It currently supports:
 
 * Format: `{Integer}px`
 * Format: `{Real}em`
+* Format: `{Real}ch`
 * Format: `{Real}%`
 
 A distance can be specified in 3 different units:
 
 * `px`: Screen pixels.
-* `em`: Relative to text width.
+* `em`: Relative to text height.
+* `ch`: Relative to width of a single number.
 * `%`:  Percentage of the **monitor** size.
 
 Distances used in the horizontal direction use the monitor width. Distances in
@@ -422,6 +425,19 @@ Specify the orientation of the widget.
 A list starts with a '[' and ends with a ']'. The entries in the list are comma-separated.
 The `keyword` in the list refers to an widget name.
 
+## Inherit
+
+ * Format: `inherit`
+
+Inherits the property from its parent widget.
+
+```
+#mainbox {
+    border-color: inherit;
+}
+```
+
+
 ## ELEMENTS PATHS
 
 Element paths exists of two parts, the first part refers to the actual widget by name.
@@ -430,20 +446,20 @@ Some widgets have an extra state.
 For example:
 
 ```
-#window mainbox listview element .selected {
+#element selected {
 }
 ```
 
-Here `#window mainbox listview element` is the name of the widget, `selected` is the state of the widget.
+Here `#element selected` is the name of the widget, `selected` is the state of the widget.
 
 The difference between dots and spaces is purely cosmetic. These are all the same:
 
 ```
-#window mainbox listview element .selected {
-}
-#window.mainbox.listview.element.selected {
+#element .selected {
+
+#element.selected {
 }
-#window mainbox listview element selected {
+#element selected {
 }
 ```
 
@@ -454,25 +470,20 @@ The difference between dots and spaces is purely cosmetic. These are all the sam
 The current widgets available in **rofi**:
 
 * `#window`
-  * `#window.box`: the container holding the window
-  * `#window.overlay`: the overlay widget
-  * `#window.mainbox`
-     * `#window.mainbox.box`: the main vertical @box
-     * `#window.mainbox.inputbar`
-       * `#window.mainbox.inputbar.box`: the horizontal @box packing the widgets
-       * `#window.mainbox.inputbar.case-indicator`: the case/sort indicator @textbox
-       * `#window.mainbox.inputbar.prompt`: the prompt @textbox
-       * `#window.mainbox.inputbar.entry`: the main entry @textbox
-     * `#window.mainbox.listview`
-        * `#window.mainbox.listview.box`: the listview container
-        * `#window.mainbox.listview.scrollbar`: the listview scrollbar
-        * `#window.mainbox.listview.element`: the entries in the listview
-     * `#window.mainbox.sidebar`
-       * `#window.mainbox.sidebar.box`: the main horizontal @box packing the buttons
-       * `#window.mainbox.sidebar.button`: the buttons @textbox for each mode
-     * `#window.mainbox.message`
-       * `#window.mainbox.message.textbox`: the message textbox
-       * `#window.mainbox.message.box`: the box containing the message
+  * `#overlay`: the overlay widget.
+  * `#mainbox`: The mainbox box.
+    * `#inputbar`: The input bar box.
+      * `#box`: the horizontal @box packing the widgets
+      * `#case-indicator`: the case/sort indicator @textbox
+      * `#prompt`: the prompt @textbox
+      * `#entry`: the main entry @textbox
+    * `#listview`: The listview. 
+       * `#scrollbar`: the listview scrollbar
+       * `#element`: the entries in the listview
+    * `#sidebar`: the main horizontal @box packing the buttons.
+      * `#button`: the buttons @textbox for each mode
+    * `#message`: The container holding the textbox.
+      * `#textbox`: the message textbox
 
 Note that these path names match the default theme. Themes that provide a custom layout will have different
 element paths.
@@ -488,9 +499,9 @@ These are appended after the name or class of the widget.
 
 ### Example:
 
-`#window.mainbox.sidebar.button selected.normal { }`
+`#button selected.normal { }`
 
-`#window.mainbox.listview.element selected.urgent { }`
+`#element selected.urgent { }`
 
 Currently only the entrybox and scrollbar have states:
 
@@ -513,7 +524,7 @@ These can be mixed.
 Example:
 
 ```
-#name.to.textbox selected.active {
+#nametotextbox selected.active {
     background: #003642;
     foreground: #008ed4;
 }
@@ -711,34 +722,31 @@ Below is an example of a theme emulating dmenu:
 #window {
     anchor:     north;
     location:   north;
-}
-
-#window box {
     width:      100%;
     padding:    4px;
     children:   [ horibox ];
 }
 
-#window horibox box {
+#horibox {
     orientation: horizontal;
     children:   [ prompt, entry, listview ];
 }
 
-#window horibox listview box {
+#listview {
     layout:     horizontal;
     spacing:    5px;
     lines:      10;
 }
 
-#window horibox entry {
+#entry {
     expand:     false;
     width:      10em;
 }
 
-#window horibox listview element {
+#element {
     padding: 0px 2px;
 }
-#window horibox listview element selected {
+#element selected {
     background: SteelBlue;
 }
 ```