From bd332e7b7e42ad4a474df927600fa4b3b668c82d Mon Sep 17 00:00:00 2001
From: Dave Davenport <qball@gmpclient.org>
Date: Sun, 6 Sep 2020 11:59:41 +0200
Subject: [PATCH] [Doc] Add small (Extra) highlight section to rofi-theme

---
 doc/rofi-theme.5          | 35 +++++++++++++++++++++++++++++++++++
 doc/rofi-theme.5.markdown | 23 +++++++++++++++++++++++
 2 files changed, 58 insertions(+)

diff --git a/doc/rofi-theme.5 b/doc/rofi-theme.5
index 0443e784..18c800eb 100644
--- a/doc/rofi-theme.5
+++ b/doc/rofi-theme.5
@@ -1011,6 +1011,41 @@ Do not reduce the number of columns shown when number of visible elements is not
 .PP
 Each element is a \fB\fCbox\fR called \fB\fCelement\fR\&. Each \fB\fCelement\fR can contain an \fB\fCelement\-icon\fR and \fB\fCelement\-text\fR\&.
 
+.SS listview text highlight:
+.PP
+The \fB\fCelement\-text\fR widget in the \fB\fClistview\fR is the one used to show the text.
+On this widget set the \fB\fChighlight\fR property (only place this property is used) to change
+the style of highlighting.
+The \fB\fChighlight\fR property consist of the \fB\fCtext\-style\fR property and a color.
+
+.PP
+To disable highlighting:
+
+.PP
+.RS
+
+.nf
+  element\-text {
+    highlight: None;
+  }
+
+.fi
+.RE
+
+.PP
+To set to red underlined:
+
+.PP
+.RS
+
+.nf
+  element\-text {
+    highlight: underline red;
+  }
+
+.fi
+.RE
+
 .SH Layout
 .PP
 The new format allows the layout of the \fBrofi\fP window to be tweaked extensively.
diff --git a/doc/rofi-theme.5.markdown b/doc/rofi-theme.5.markdown
index ab941949..64c05ecd 100644
--- a/doc/rofi-theme.5.markdown
+++ b/doc/rofi-theme.5.markdown
@@ -701,6 +701,29 @@ The following properties are currently supported:
 
 Each element is a `box` called `element`. Each `element` can contain an `element-icon` and `element-text`.
 
+### listview text highlight:
+
+The `element-text` widget in the `listview` is the one used to show the text.
+On this widget set the `highlight` property (only place this property is used) to change
+the style of highlighting.
+The `highlight` property consist of the `text-style` property and a color.
+
+To disable highlighting:
+
+```css
+  element-text {
+    highlight: None;
+  }
+```
+
+To set to red underlined:
+
+```css
+  element-text {
+    highlight: underline red;
+  }
+```
+
 ## Layout
 
 The new format allows the layout of the **rofi** window to be tweaked extensively.