[Doc] Update manpage urls and add new-selection setting.

4 files changed, 62 insertions, 49 deletions

diff --git a/doc/rofi-script.5 b/doc/rofi-script.5
index 689f4155..6e8b9b17 100644
--- a/doc/rofi-script.5
+++ b/doc/rofi-script.5
@@ -6,8 +6,9 @@
 
 .SH DESCRIPTION
 .PP
-\fBrofi\fP supports modes that use simple scripts in the background to generate a list and process the result from user
-actions.  This provide a simple interface to make simple extensions to rofi.
+\fBrofi\fP supports modes that use simple scripts in the background to generate a
+list and process the result from user actions.  This provide a simple interface
+to make simple extensions to rofi.
 
 .SH USAGE
 .PP
@@ -30,10 +31,11 @@ The name should be unique.
 
 .SH API
 .PP
-Rofi calls the executable without arguments on startup.  This should generate a list of options, separated by a newline
-(\fB\fC\\n\fR) (This can be changed by the script).
-If the user selects an option, rofi calls the executable with the text of that option as the first argument.
-If the script returns no entries, rofi quits.
+Rofi calls the executable without arguments on startup.  This should generate a
+list of options, separated by a newline (\fB\fC\\n\fR) (This can be changed by the
+script). If the user selects an option, rofi calls the executable with the text
+of that option as the first argument. If the script returns no entries, rofi
+quits.
 
 .PP
 A simple script would be:
@@ -124,7 +126,9 @@ The following extra options exists:
 .IP \(bu 2
 \fBuse-hot-keys\fP: If set to true, it enabled the Custom keybindings for script. Warning this breaks the normal rofi flow.
 .IP \(bu 2
-\fBkeep-selection\fP: If set, the selection is not moved to the first entry, but the current position is maintained.
+\fBkeep-selection\fP: If set, the selection is not moved to the first entry, but the current position is maintained. The filter is cleared.
+.IP \(bu 2
+\fBnew-selection\fP: If \fB\fCkeep-selection\fR is set, this allows you to override the selected entry (absolute position).
 .IP \(bu 2
 \fBdata\fP:         Passed data to the next execution of the script via \fBROFI_DATA\fP\&.
 .IP \(bu 2
diff --git a/doc/rofi-script.5.markdown b/doc/rofi-script.5.markdown
index 805886d0..d021f781 100644
--- a/doc/rofi-script.5.markdown
+++ b/doc/rofi-script.5.markdown
@@ -7,8 +7,9 @@
 
 ## DESCRIPTION
 
-**rofi** supports modes that use simple scripts in the background to generate a list and process the result from user
-actions.  This provide a simple interface to make simple extensions to rofi.
+**rofi** supports modes that use simple scripts in the background to generate a
+list and process the result from user actions.  This provide a simple interface
+to make simple extensions to rofi.
 
 
 ## USAGE
@@ -25,10 +26,11 @@ The name should be unique.
 
 ## API
 
-Rofi calls the executable without arguments on startup.  This should generate a list of options, separated by a newline
-(`\n`) (This can be changed by the script).
-If the user selects an option, rofi calls the executable with the text of that option as the first argument.
-If the script returns no entries, rofi quits.
+Rofi calls the executable without arguments on startup.  This should generate a
+list of options, separated by a newline (`\n`) (This can be changed by the
+script). If the user selects an option, rofi calls the executable with the text
+of that option as the first argument. If the script returns no entries, rofi
+quits.
 
 A simple script would be:
 
@@ -88,7 +90,8 @@ The following extra options exists:
  * **delim**:       Set the delimiter for for next rows. Default is '\n' and this option should finish with this. Only call this on first call of script, it is remembered for consecutive calls.
  * **no-custom**:   If set to 'true'; only accept listed entries, ignore custom input.
  * **use-hot-keys**: If set to true, it enabled the Custom keybindings for script. Warning this breaks the normal rofi flow.
- * **keep-selection**: If set, the selection is not moved to the first entry, but the current position is maintained.
+ * **keep-selection**: If set, the selection is not moved to the first entry, but the current position is maintained. The filter is cleared.
+ * **new-selection**: If `keep-selection` is set, this allows you to override the selected entry (absolute position). 
  * **data**:         Passed data to the next execution of the script via **ROFI_DATA**.
  * **theme**:       Small theme snippet to f.e. change the background color of a widget.
 
diff --git a/doc/rofi.1 b/doc/rofi.1
index 956203e7..f4ea767e 100644
--- a/doc/rofi.1
+++ b/doc/rofi.1
@@ -10,9 +10,9 @@
 
 .SH DESCRIPTION
 .PP
-\fBrofi\fP is an X11 pop-up window switcher, run dialog, dmenu replacement, and more. It focuses on
-being fast to use and have minimal distraction. It supports keyboard and mouse navigation, type to
-filter, tokenized search and more.
+\fBrofi\fP is an X11 pop-up window switcher, run dialog, dmenu replacement, and
+more. It focuses on being fast to use and have minimal distraction. It supports
+keyboard and mouse navigation, type to filter, tokenized search and more.
 
 .SH USAGE
 .PP
@@ -57,7 +57,8 @@ running firefox, or launch it when it is not running.
 
 .SS Emulating dmenu
 .PP
-\fBrofi\fP can emulate \fBdmenu(1)\fP (a dynamic menu for X11) when launched with the \fB\fC-dmenu\fR flag.
+\fBrofi\fP can emulate \fBdmenu(1)\fP (a dynamic menu for X11) when launched with
+the \fB\fC-dmenu\fR flag.
 
 .PP
 For more information see \fBrofi-dmenu(5)\fP\&.
@@ -191,8 +192,8 @@ Below is a list of the most important options:
 \fB\fC-help\fR
 
 .PP
-The help option shows the full list of command-line options and the current set values.
-These include dynamic (run-time generated) options.
+The help option shows the full list of command-line options and the current set
+values. These include dynamic (run-time generated) options.
 
 .PP
 \fB\fC-version\fR
@@ -277,9 +278,10 @@ See the \fBrofi-dmenu(5)\fP manpage for more information.
 \fB\fC-show\fR \fImode\fP
 
 .PP
-Open \fBrofi\fP in a certain mode. Available modes are \fB\fCwindow\fR, \fB\fCrun\fR, \fB\fCdrun\fR, \fB\fCssh\fR, \fB\fCcombi\fR\&.
-The special argument \fB\fCkeys\fR can be used to open a searchable list of supported key bindings
-(see \fIKEY BINDINGS\fP)
+Open \fBrofi\fP in a certain mode. Available modes are \fB\fCwindow\fR, \fB\fCrun\fR, \fB\fCdrun\fR,
+\fB\fCssh\fR, \fB\fCcombi\fR\&. The special argument \fB\fCkeys\fR can be used to open a searchable
+list of supported key bindings
+(see the \fBrofi-keys(5)\fP manpage)
 
 .PP
 To show the run-dialog:
@@ -315,7 +317,8 @@ rofi -modes "run,ssh" -show run
 .RE
 
 .PP
-Custom modes can be added using the internal \fB\fCscript\fR mode. Each such mode has two parameters:
+Custom modes can be added using the internal \fB\fCscript\fR mode. Each such mode has
+two parameters:
 
 .PP
 .RS
@@ -339,8 +342,8 @@ rofi -modes "window,run,ssh,Workspaces:i3_switch_workspaces.sh" -show Workspaces
 .RE
 
 .PP
-Notes: The i3 window manager dislikes commas in the command when specifying an exec command.
-For that case, \fB\fC#\fR can be used as a separator.
+Notes: The i3 window manager dislikes commas in the command when specifying an
+exec command. For that case, \fB\fC#\fR can be used as a separator.
 
 .PP
 \fBTIP\fP: The name is allowed to contain spaces:
@@ -1358,7 +1361,7 @@ If no match, the input is handled by the first combined modes.
 .SH FAQ
 .SS The text in the window switcher is not nicely aligned.
 .PP
-Try using a mono-space font.
+Try using a mono-space font or tabs + the tab-stops setting..
 
 .SS The window is completely black.
 .PP
@@ -1527,7 +1530,7 @@ SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 .SH WEBSITE
 .PP
 \fBrofi\fP website can be found here
-\[la]https://davedavenport.github.io/rofi/\[ra]
+\[la]https://github.com/davatorium/rofi/\[ra]
 
 .SH SUPPORT
 .PP
@@ -1546,11 +1549,11 @@ For more information see \fBrofi-debugging(5)\fP manpage.
 .SH ISSUE TRACKER
 .PP
 The \fBrofi\fP issue tracker can be found here
-\[la]https://github.com/DaveDavenport/rofi/issues\[ra]
-
-.PP
+\[la]https://github.com/davatorium/rofi/issues\[ra]
+Before creating an issue, consider posting a question on the discussion forum
+\[la]https://github.com/davatorium/rofi/discussions\[ra] first.
 When creating an issue, please read this
-\[la]https://github.com/DaveDavenport/rofi/blob/master/.github/CONTRIBUTING.md\[ra]
+\[la]https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUTING.md\[ra]
 first.
 
 .SH SEE ALSO
diff --git a/doc/rofi.1.markdown b/doc/rofi.1.markdown
index 9f02f93d..783fb606 100644
--- a/doc/rofi.1.markdown
+++ b/doc/rofi.1.markdown
@@ -11,9 +11,9 @@
 
 ## DESCRIPTION
 
-**rofi** is an X11 pop-up window switcher, run dialog, dmenu replacement, and more. It focuses on
-being fast to use and have minimal distraction. It supports keyboard and mouse navigation, type to
-filter, tokenized search and more.
+**rofi** is an X11 pop-up window switcher, run dialog, dmenu replacement, and
+more. It focuses on being fast to use and have minimal distraction. It supports
+keyboard and mouse navigation, type to filter, tokenized search and more.
 
 
 ## USAGE
@@ -48,7 +48,8 @@ running firefox, or launch it when it is not running.
 
 ### Emulating dmenu
 
-**rofi** can emulate **dmenu(1)** (a dynamic menu for X11) when launched with the `-dmenu` flag.
+**rofi** can emulate **dmenu(1)** (a dynamic menu for X11) when launched with
+the `-dmenu` flag.
 
 For more information see **rofi-dmenu(5)**.
 
@@ -122,8 +123,8 @@ Below is a list of the most important options:
 
 `-help`
 
-The help option shows the full list of command-line options and the current set values.
-These include dynamic (run-time generated) options.
+The help option shows the full list of command-line options and the current set
+values. These include dynamic (run-time generated) options.
 
 `-version`
 
@@ -172,9 +173,10 @@ See the **rofi-dmenu(5)** manpage for more information.
 
 `-show` *mode*
 
-Open **rofi** in a certain mode. Available modes are `window`, `run`, `drun`, `ssh`, `combi`.
-The special argument `keys` can be used to open a searchable list of supported key bindings
-(see *KEY BINDINGS*)
+Open **rofi** in a certain mode. Available modes are `window`, `run`, `drun`,
+`ssh`, `combi`. The special argument `keys` can be used to open a searchable
+list of supported key bindings
+(see the **rofi-keys(5)** manpage)
 
 To show the run-dialog:
 
@@ -191,7 +193,8 @@ To only show the `run` and `ssh` launcher:
 
     rofi -modes "run,ssh" -show run
 
-Custom modes can be added using the internal `script` mode. Each such mode has two parameters:
+Custom modes can be added using the internal `script` mode. Each such mode has
+two parameters:
 
     <name>:<script>
 
@@ -199,8 +202,8 @@ Example: Have a mode called 'Workspaces' using the `i3_switch_workspaces.sh` scr
 
     rofi -modes "window,run,ssh,Workspaces:i3_switch_workspaces.sh" -show Workspaces
 
-Notes: The i3 window manager dislikes commas in the command when specifying an exec command.
-For that case, `#` can be used as a separator.
+Notes: The i3 window manager dislikes commas in the command when specifying an
+exec command. For that case, `#` can be used as a separator.
 
 **TIP**: The name is allowed to contain spaces:
 
@@ -877,7 +880,7 @@ If no match, the input is handled by the first combined modes.
 
 ### The text in the window switcher is not nicely aligned.
 
-Try using a mono-space font.
+Try using a mono-space font or tabs + the tab-stops setting..
 
 ### The window is completely black.
 
@@ -967,7 +970,7 @@ been released.
 
 ## WEBSITE
 
-**rofi** website can be found [here](https://davedavenport.github.io/rofi/)
+**rofi** website can be found [here](https://github.com/davatorium/rofi/)
 
 ## SUPPORT
 
@@ -982,9 +985,9 @@ For more information see **rofi-debugging(5)** manpage.
 
 ## ISSUE TRACKER
 
-The **rofi** issue tracker can be found [here](https://github.com/DaveDavenport/rofi/issues)
-
-When creating an issue, please read [this](https://github.com/DaveDavenport/rofi/blob/master/.github/CONTRIBUTING.md)
+The **rofi** issue tracker can be found [here](https://github.com/davatorium/rofi/issues)
+Before creating an issue, consider posting a question on the [discussion forum](https://github.com/davatorium/rofi/discussions) first.
+When creating an issue, please read [this](https://github.com/davatorium/rofi/blob/master/.github/CONTRIBUTING.md)
 first.
 
 ## SEE ALSO