PolytreeDE/rofi
1
0
Fork 0
mirror of https://github.com/davatorium/rofi.git synced 2024-11-18 13:54:36 -05:00
Code Releases Activity

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

Browse source
This commit is contained in:
Dave Davenport 2022-07-31 16:28:05 +02:00
parent 406a6954aa
commit 8e8765e2ce
4 changed files with 62 additions and 49 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

18
doc/rofi-script.5
View file

@ -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

17
doc/rofi-script.5.markdown
View file

@ -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.

39
doc/rofi.1
View file

@ -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

37
doc/rofi.1.markdown
View file

@ -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