summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorKenneth Ho <ken.fsfoundry.org@gmail.com>2019-07-03 03:27:46 +0800
committerDave Davenport <DaveDavenport@users.noreply.github.com>2019-07-02 21:27:46 +0200
commitbe21fbae5d11916619f1b259a4b2191fcb19dae8 (patch)
tree4e48f7b0569ed2157a101abaddf40bad344bc306 /doc
parent2ddb525ff3710a06f7091849710fab8482e39503 (diff)
add pythonic rows selection to -a and -u (#985)
Diffstat (limited to 'doc')
-rw-r--r--doc/rofi.120
-rw-r--r--doc/rofi.1.markdown18
2 files changed, 26 insertions, 12 deletions
diff --git a/doc/rofi.1 b/doc/rofi.1
index bdd0a5ac..0e0cdb98 100644
--- a/doc/rofi.1
+++ b/doc/rofi.1
@@ -998,13 +998,29 @@ Makes dmenu searches case\-insensitive
\fB\-a\fR \fIX\fR
.
.P
-Active row, mark row X as active (starting at 0)\. You can specify single element: \-a 3 A range: \-a 3\-8 or a set of rows: \-a 0,2 or any combination: \-a 0,2\-3,9
+Active row, mark \fIX\fR as active. Where \fIX\fR is a comma-separated list of python(1)-style indices and ranges, e.g.
+indices start at \fB0\fR, \fB\-1\fR refers to the last row with \fB\-2\fR preceding it, ranges are left-open and right-close, and so on. You can specify:
+.
+.IP "\(bu" 4
+A single row: \'\fB5\fR\'
+.
+.IP "\(bu" 4
+A range of (last 3) rows: \'\fB\-3:\fR\'
+.
+.IP "\(bu" 4
+4 rows starting from row 7: \'\fB7:11\fR\' (or in legacy notation: \'\fB7\-10\fR\')
+.
+.IP "\(bu" 4
+A set of rows: \'\fB2,0,\-9\fR\'
+.
+.IP "\(bu" 4
+Or any combination: \'\fB\5,-3:,7:11,2,0,\-9\fR\'
.
.P
\fB\-u\fR \fIX\fR
.
.P
-Urgent row, mark row X as urgent (starting at 0)\. You can specify single element: \-u 3 A range: \-u 3\-8 or a set of rows: \-u 0,2 or any combination: \-u 0,2\-3,9
+Urgent row, mark \fIX\fR as urgent\. See \fB\-a\fR option\ for details.
.
.P
\fB\-only\-match\fR
diff --git a/doc/rofi.1.markdown b/doc/rofi.1.markdown
index 4472ef0f..e4225ee3 100644
--- a/doc/rofi.1.markdown
+++ b/doc/rofi.1.markdown
@@ -572,19 +572,17 @@ Makes dmenu searches case-insensitive
`-a` *X*
-Active row, mark row X as active (starting at 0).
-You can specify single element: -a 3
-A range: -a 3-8
-or a set of rows: -a 0,2
-or any combination: -a 0,2-3,9
+Active row, mark *X* as active. Where *X* is a comma-separated list of python(1)-style indices and ranges, e.g. indices start at 0, -1 refers to the last row with -2 preceding it, ranges are left-open and right-close, and so on. You can specify:
+
+ * A single row: '5'
+ * A range of (last 3) rows: '-3:'
+ * 4 rows starting from row 7: '7:11' (or in legacy notation: '7-10')
+ * A set of rows: '2,0,-9'
+ * Or any combination: '5,-3:,7:11,2,0,-9'
`-u` *X*
-Urgent row, mark row X as urgent (starting at 0).
-You can specify single element: -u 3
-A range: -u 3-8
-or a set of rows: -u 0,2
-or any combination: -u 0,2-3,9
+Urgent row, mark *X* as urgent. See `-a` option for details.
`-only-match`