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

Update manpage.

Browse source
This commit is contained in:
Dave Davenport 2022-02-13 12:22:25 +01:00
parent eff3b86c94
commit fb1eefb298
8 changed files with 145 additions and 326 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

19
doc/rofi-dmenu.5
View file

@ -1,3 +1,4 @@
.nh
.TH ROFI\-DMENU 5 rofi\-dmenu .TH ROFI\-DMENU 5 rofi\-dmenu
.SH NAME .SH NAME
.PP .PP
@ -14,7 +15,7 @@ The website for \fB\fCdmenu\fR can be found here
.PP .PP
\fBrofi\fP does not aim to be 100% compatible with \fB\fCdmenu\fR\&. There are simply too many flavors of \fB\fCdmenu\fR\&. \fBrofi\fP does not aim to be 100% compatible with \fB\fCdmenu\fR\&. There are simply too many flavors of \fB\fCdmenu\fR\&.
The idea is that the basic usage command\-line flags are obeyed, theme\-related flags are not. The idea is that the basic usage command\-\&line flags are obeyed, theme\-\&related flags are not.
Besides, \fBrofi\fP offers some extended features (like multi\-select, highlighting, message bar, extra key bindings). Besides, \fBrofi\fP offers some extended features (like multi\-select, highlighting, message bar, extra key bindings).
.SH BASIC CONCEPT .SH BASIC CONCEPT
@ -306,20 +307,20 @@ rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-script(5),
.SH AUTHOR .SH AUTHOR
.PP .PP
Qball Cow Qball Cow qball@gmpclient.org
\[la]qball@gmpclient.org\[ra] \[la]mailto:qball@gmpclient.org\[ra]
.PP .PP
Rasmus Steinke Rasmus Steinke rasi@xssn.at
\[la]rasi@xssn.at\[ra] \[la]mailto:rasi@xssn.at\[ra]
.PP .PP
Quentin Glidic Quentin Glidic sardemff7+rofi@sardemff7.net
\[la]sardemff7+rofi@sardemff7.net\[ra] \[la]mailto:sardemff7+rofi@sardemff7.net\[ra]
.PP .PP
Original code based on work by: Sean Pringle Original code based on work by: Sean Pringle sean.pringle@gmail.com
\[la]sean.pringle@gmail.com\[ra] \[la]mailto:sean.pringle@gmail.com\[ra]
.PP .PP
For a full list of authors, check the AUTHORS file. For a full list of authors, check the AUTHORS file.

165
doc/rofi-keys.5
View file

@ -1,3 +1,4 @@
.nh
.TH ROFI\-KEYS 5 rofi\-keys .TH ROFI\-KEYS 5 rofi\-keys
.SH NAME .SH NAME
.PP .PP
@ -86,469 +87,469 @@ configuration {
Paste primary selection Paste primary selection
.PP .PP
\fBDefault\fP: Control+V,Shift+Insert \fBDefault\fP: Control+V,Shift+Insert
.SS \fBkb\-secondary\-paste\fP .SS \fBkb\-secondary\-paste\fP
.PP .PP
Paste clipboard Paste clipboard
.PP .PP
\fBDefault\fP: Control+v,Insert \fBDefault\fP: Control+v,Insert
.SS \fBkb\-clear\-line\fP .SS \fBkb\-clear\-line\fP
.PP .PP
Clear input line Clear input line
.PP .PP
\fBDefault\fP: Control+w \fBDefault\fP: Control+w
.SS \fBkb\-move\-front\fP .SS \fBkb\-move\-front\fP
.PP .PP
Beginning of line Beginning of line
.PP .PP
\fBDefault\fP: Control+a \fBDefault\fP: Control+a
.SS \fBkb\-move\-end\fP .SS \fBkb\-move\-end\fP
.PP .PP
End of line End of line
.PP .PP
\fBDefault\fP: Control+e \fBDefault\fP: Control+e
.SS \fBkb\-move\-word\-back\fP .SS \fBkb\-move\-word\-back\fP
.PP .PP
Move back one word Move back one word
.PP .PP
\fBDefault\fP: Alt+b,Control+Left \fBDefault\fP: Alt+b,Control+Left
.SS \fBkb\-move\-word\-forward\fP .SS \fBkb\-move\-word\-forward\fP
.PP .PP
Move forward one word Move forward one word
.PP .PP
\fBDefault\fP: Alt+f,Control+Right \fBDefault\fP: Alt+f,Control+Right
.SS \fBkb\-move\-char\-back\fP .SS \fBkb\-move\-char\-back\fP
.PP .PP
Move back one char Move back one char
.PP .PP
\fBDefault\fP: Left,Control+b \fBDefault\fP: Left,Control+b
.SS \fBkb\-move\-char\-forward\fP .SS \fBkb\-move\-char\-forward\fP
.PP .PP
Move forward one char Move forward one char
.PP .PP
\fBDefault\fP: Right,Control+f \fBDefault\fP: Right,Control+f
.SS \fBkb\-remove\-word\-back\fP .SS \fBkb\-remove\-word\-back\fP
.PP .PP
Delete previous word Delete previous word
.PP .PP
\fBDefault\fP: Control+Alt+h,Control+BackSpace \fBDefault\fP: Control+Alt+h,Control+BackSpace
.SS \fBkb\-remove\-word\-forward\fP .SS \fBkb\-remove\-word\-forward\fP
.PP .PP
Delete next word Delete next word
.PP .PP
\fBDefault\fP: Control+Alt+d \fBDefault\fP: Control+Alt+d
.SS \fBkb\-remove\-char\-forward\fP .SS \fBkb\-remove\-char\-forward\fP
.PP .PP
Delete next char Delete next char
.PP .PP
\fBDefault\fP: Delete,Control+d \fBDefault\fP: Delete,Control+d
.SS \fBkb\-remove\-char\-back\fP .SS \fBkb\-remove\-char\-back\fP
.PP .PP
Delete previous char Delete previous char
.PP .PP
\fBDefault\fP: BackSpace,Shift+BackSpace,Control+h \fBDefault\fP: BackSpace,Shift+BackSpace,Control+h
.SS \fBkb\-remove\-to\-eol\fP .SS \fBkb\-remove\-to\-eol\fP
.PP .PP
Delete till the end of line Delete till the end of line
.PP .PP
\fBDefault\fP: Control+k \fBDefault\fP: Control+k
.SS \fBkb\-remove\-to\-sol\fP .SS \fBkb\-remove\-to\-sol\fP
.PP .PP
Delete till the start of line Delete till the start of line
.PP .PP
\fBDefault\fP: Control+u \fBDefault\fP: Control+u
.SS \fBkb\-accept\-entry\fP .SS \fBkb\-accept\-entry\fP
.PP .PP
Accept entry Accept entry
.PP .PP
\fBDefault\fP: Control+j,Control+m,Return,KP\_Enter \fBDefault\fP: Control+j,Control+m,Return,KP\_Enter
.SS \fBkb\-accept\-custom\fP .SS \fBkb\-accept\-custom\fP
.PP .PP
Use entered text as command (in ssh/run modi) Use entered text as command (in ssh/run modi)
.PP .PP
\fBDefault\fP: Control+Return \fBDefault\fP: Control+Return
.SS \fBkb\-accept\-custom\-alt\fP .SS \fBkb\-accept\-custom\-alt\fP
.PP .PP
Use entered text as command (in ssh/run modi) Use entered text as command (in ssh/run modi)
.PP .PP
\fBDefault\fP: Control+Shift+Return \fBDefault\fP: Control+Shift+Return
.SS \fBkb\-accept\-alt\fP .SS \fBkb\-accept\-alt\fP
.PP .PP
Use alternate accept command. Use alternate accept command.
.PP .PP
\fBDefault\fP: Shift+Return \fBDefault\fP: Shift+Return
.SS \fBkb\-delete\-entry\fP .SS \fBkb\-delete\-entry\fP
.PP .PP
Delete entry from history Delete entry from history
.PP .PP
\fBDefault\fP: Shift+Delete \fBDefault\fP: Shift+Delete
.SS \fBkb\-mode\-next\fP .SS \fBkb\-mode\-next\fP
.PP .PP
Switch to the next mode. Switch to the next mode.
.PP .PP
\fBDefault\fP: Shift+Right,Control+Tab \fBDefault\fP: Shift+Right,Control+Tab
.SS \fBkb\-mode\-previous\fP .SS \fBkb\-mode\-previous\fP
.PP .PP
Switch to the previous mode. Switch to the previous mode.
.PP .PP
\fBDefault\fP: Shift+Left,Control+ISO\_Left\_Tab \fBDefault\fP: Shift+Left,Control+ISO\_Left\_Tab
.SS \fBkb\-mode\-complete\fP .SS \fBkb\-mode\-complete\fP
.PP .PP
Start completion for mode. Start completion for mode.
.PP .PP
\fBDefault\fP: Control+l \fBDefault\fP: Control+l
.SS \fBkb\-row\-left\fP .SS \fBkb\-row\-left\fP
.PP .PP
Go to the previous column Go to the previous column
.PP .PP
\fBDefault\fP: Control+Page\_Up \fBDefault\fP: Control+Page\_Up
.SS \fBkb\-row\-right\fP .SS \fBkb\-row\-right\fP
.PP .PP
Go to the next column Go to the next column
.PP .PP
\fBDefault\fP: Control+Page\_Down \fBDefault\fP: Control+Page\_Down
.SS \fBkb\-row\-up\fP .SS \fBkb\-row\-up\fP
.PP .PP
Select previous entry Select previous entry
.PP .PP
\fBDefault\fP: Up,Control+p,ISO\_Left\_Tab \fBDefault\fP: Up,Control+p,ISO\_Left\_Tab
.SS \fBkb\-row\-down\fP .SS \fBkb\-row\-down\fP
.PP .PP
Select next entry Select next entry
.PP .PP
\fBDefault\fP: Down,Control+n \fBDefault\fP: Down,Control+n
.SS \fBkb\-row\-tab\fP .SS \fBkb\-row\-tab\fP
.PP .PP
Go to next row, if one left, accept it, if no left next mode. Go to next row, if one left, accept it, if no left next mode.
.PP .PP
\fBDefault\fP: Tab \fBDefault\fP: Tab
.SS \fBkb\-page\-prev\fP .SS \fBkb\-page\-prev\fP
.PP .PP
Go to the previous page Go to the previous page
.PP .PP
\fBDefault\fP: Page\_Up \fBDefault\fP: Page\_Up
.SS \fBkb\-page\-next\fP .SS \fBkb\-page\-next\fP
.PP .PP
Go to the next page Go to the next page
.PP .PP
\fBDefault\fP: Page\_Down \fBDefault\fP: Page\_Down
.SS \fBkb\-row\-first\fP .SS \fBkb\-row\-first\fP
.PP .PP
Go to the first entry Go to the first entry
.PP .PP
\fBDefault\fP: Home,KP\_Home \fBDefault\fP: Home,KP\_Home
.SS \fBkb\-row\-last\fP .SS \fBkb\-row\-last\fP
.PP .PP
Go to the last entry Go to the last entry
.PP .PP
\fBDefault\fP: End,KP\_End \fBDefault\fP: End,KP\_End
.SS \fBkb\-row\-select\fP .SS \fBkb\-row\-select\fP
.PP .PP
Set selected item as input text Set selected item as input text
.PP .PP
\fBDefault\fP: Control+space \fBDefault\fP: Control+space
.SS \fBkb\-screenshot\fP .SS \fBkb\-screenshot\fP
.PP .PP
Take a screenshot of the rofi window Take a screenshot of the rofi window
.PP .PP
\fBDefault\fP: Alt+S \fBDefault\fP: Alt+S
.SS \fBkb\-ellipsize\fP .SS \fBkb\-ellipsize\fP
.PP .PP
Toggle between ellipsize modes for displayed data Toggle between ellipsize modes for displayed data
.PP .PP
\fBDefault\fP: Alt+period \fBDefault\fP: Alt+period
.SS \fBkb\-toggle\-case\-sensitivity\fP .SS \fBkb\-toggle\-case\-sensitivity\fP
.PP .PP
Toggle case sensitivity Toggle case sensitivity
.PP .PP
\fBDefault\fP: grave,dead\_grave \fBDefault\fP: grave,dead\_grave
.SS \fBkb\-toggle\-sort\fP .SS \fBkb\-toggle\-sort\fP
.PP .PP
Toggle sort Toggle sort
.PP .PP
\fBDefault\fP: Alt+grave \fBDefault\fP: Alt+grave
.SS \fBkb\-cancel\fP .SS \fBkb\-cancel\fP
.PP .PP
Quit rofi Quit rofi
.PP .PP
\fBDefault\fP: Escape,Control+g,Control+bracketleft \fBDefault\fP: Escape,Control+g,Control+bracketleft
.SS \fBkb\-custom\-1\fP .SS \fBkb\-custom\-1\fP
.PP .PP
Custom keybinding 1 Custom keybinding 1
.PP .PP
\fBDefault\fP: Alt+1 \fBDefault\fP: Alt+1
.SS \fBkb\-custom\-2\fP .SS \fBkb\-custom\-2\fP
.PP .PP
Custom keybinding 2 Custom keybinding 2
.PP .PP
\fBDefault\fP: Alt+2 \fBDefault\fP: Alt+2
.SS \fBkb\-custom\-3\fP .SS \fBkb\-custom\-3\fP
.PP .PP
Custom keybinding 3 Custom keybinding 3
.PP .PP
\fBDefault\fP: Alt+3 \fBDefault\fP: Alt+3
.SS \fBkb\-custom\-4\fP .SS \fBkb\-custom\-4\fP
.PP .PP
Custom keybinding 4 Custom keybinding 4
.PP .PP
\fBDefault\fP: Alt+4 \fBDefault\fP: Alt+4
.SS \fBkb\-custom\-5\fP .SS \fBkb\-custom\-5\fP
.PP .PP
Custom Keybinding 5 Custom Keybinding 5
.PP .PP
\fBDefault\fP: Alt+5 \fBDefault\fP: Alt+5
.SS \fBkb\-custom\-6\fP .SS \fBkb\-custom\-6\fP
.PP .PP
Custom keybinding 6 Custom keybinding 6
.PP .PP
\fBDefault\fP: Alt+6 \fBDefault\fP: Alt+6
.SS \fBkb\-custom\-7\fP .SS \fBkb\-custom\-7\fP
.PP .PP
Custom Keybinding 7 Custom Keybinding 7
.PP .PP
\fBDefault\fP: Alt+7 \fBDefault\fP: Alt+7
.SS \fBkb\-custom\-8\fP .SS \fBkb\-custom\-8\fP
.PP .PP
Custom keybinding 8 Custom keybinding 8
.PP .PP
\fBDefault\fP: Alt+8 \fBDefault\fP: Alt+8
.SS \fBkb\-custom\-9\fP .SS \fBkb\-custom\-9\fP
.PP .PP
Custom keybinding 9 Custom keybinding 9
.PP .PP
\fBDefault\fP: Alt+9 \fBDefault\fP: Alt+9
.SS \fBkb\-custom\-10\fP .SS \fBkb\-custom\-10\fP
.PP .PP
Custom keybinding 10 Custom keybinding 10
.PP .PP
\fBDefault\fP: Alt+0 \fBDefault\fP: Alt+0
.SS \fBkb\-custom\-11\fP .SS \fBkb\-custom\-11\fP
.PP .PP
Custom keybinding 11 Custom keybinding 11
.PP .PP
\fBDefault\fP: Alt+exclam \fBDefault\fP: Alt+exclam
.SS \fBkb\-custom\-12\fP .SS \fBkb\-custom\-12\fP
.PP .PP
Custom keybinding 12 Custom keybinding 12
.PP .PP
\fBDefault\fP: Alt+at \fBDefault\fP: Alt+at
.SS \fBkb\-custom\-13\fP .SS \fBkb\-custom\-13\fP
.PP .PP
Custom keybinding 13 Custom keybinding 13
.PP .PP
\fBDefault\fP: Alt+numbersign \fBDefault\fP: Alt+numbersign
.SS \fBkb\-custom\-14\fP .SS \fBkb\-custom\-14\fP
.PP .PP
Custom keybinding 14 Custom keybinding 14
.PP .PP
\fBDefault\fP: Alt+dollar \fBDefault\fP: Alt+dollar
.SS \fBkb\-custom\-15\fP .SS \fBkb\-custom\-15\fP
.PP .PP
Custom keybinding 15 Custom keybinding 15
.PP .PP
\fBDefault\fP: Alt+percent \fBDefault\fP: Alt+percent
.SS \fBkb\-custom\-16\fP .SS \fBkb\-custom\-16\fP
.PP .PP
Custom keybinding 16 Custom keybinding 16
.PP .PP
\fBDefault\fP: Alt+dead\_circumflex \fBDefault\fP: Alt+dead\_circumflex
.SS \fBkb\-custom\-17\fP .SS \fBkb\-custom\-17\fP
.PP .PP
Custom keybinding 17 Custom keybinding 17
.PP .PP
\fBDefault\fP: Alt+ampersand \fBDefault\fP: Alt+ampersand
.SS \fBkb\-custom\-18\fP .SS \fBkb\-custom\-18\fP
.PP .PP
Custom keybinding 18 Custom keybinding 18
.PP .PP
\fBDefault\fP: Alt+asterisk \fBDefault\fP: Alt+asterisk
.SS \fBkb\-custom\-19\fP .SS \fBkb\-custom\-19\fP
.PP .PP
Custom Keybinding 19 Custom Keybinding 19
.PP .PP
\fBDefault\fP: Alt+parenleft \fBDefault\fP: Alt+parenleft
.SS \fBkb\-select\-1\fP .SS \fBkb\-select\-1\fP
.PP .PP
Select row 1 Select row 1
.PP .PP
\fBDefault\fP: Super+1 \fBDefault\fP: Super+1
.SS \fBkb\-select\-2\fP .SS \fBkb\-select\-2\fP
.PP .PP
Select row 2 Select row 2
.PP .PP
\fBDefault\fP: Super+2 \fBDefault\fP: Super+2
.SS \fBkb\-select\-3\fP .SS \fBkb\-select\-3\fP
.PP .PP
Select row 3 Select row 3
.PP .PP
\fBDefault\fP: Super+3 \fBDefault\fP: Super+3
.SS \fBkb\-select\-4\fP .SS \fBkb\-select\-4\fP
.PP .PP
Select row 4 Select row 4
.PP .PP
\fBDefault\fP: Super+4 \fBDefault\fP: Super+4
.SS \fBkb\-select\-5\fP .SS \fBkb\-select\-5\fP
.PP .PP
Select row 5 Select row 5
.PP .PP
\fBDefault\fP: Super+5 \fBDefault\fP: Super+5
.SS \fBkb\-select\-6\fP .SS \fBkb\-select\-6\fP
.PP .PP
Select row 6 Select row 6
.PP .PP
\fBDefault\fP: Super+6 \fBDefault\fP: Super+6
.SS \fBkb\-select\-7\fP .SS \fBkb\-select\-7\fP
.PP .PP
Select row 7 Select row 7
.PP .PP
\fBDefault\fP: Super+7 \fBDefault\fP: Super+7
.SS \fBkb\-select\-8\fP .SS \fBkb\-select\-8\fP
.PP .PP
Select row 8 Select row 8
.PP .PP
\fBDefault\fP: Super+8 \fBDefault\fP: Super+8
.SS \fBkb\-select\-9\fP .SS \fBkb\-select\-9\fP
.PP .PP
Select row 9 Select row 9
.PP .PP
\fBDefault\fP: Super+9 \fBDefault\fP: Super+9
.SS \fBkb\-select\-10\fP .SS \fBkb\-select\-10\fP
.PP .PP
Select row 10 Select row 10
.PP .PP
\fBDefault\fP: Super+0 \fBDefault\fP: Super+0
.SH Mouse Bindings .SH Mouse Bindings
.SS \fBml\-row\-left\fP .SS \fBml\-row\-left\fP
@ -556,49 +557,49 @@ Select row 10
Go to the previous column Go to the previous column
.PP .PP
\fBDefault\fP: ScrollLeft \fBDefault\fP: ScrollLeft
.SS \fBml\-row\-right\fP .SS \fBml\-row\-right\fP
.PP .PP
Go to the next column Go to the next column
.PP .PP
\fBDefault\fP: ScrollRight \fBDefault\fP: ScrollRight
.SS \fBml\-row\-up\fP .SS \fBml\-row\-up\fP
.PP .PP
Select previous entry Select previous entry
.PP .PP
\fBDefault\fP: ScrollUp \fBDefault\fP: ScrollUp
.SS \fBml\-row\-down\fP .SS \fBml\-row\-down\fP
.PP .PP
Select next entry Select next entry
.PP .PP
\fBDefault\fP: ScrollDown \fBDefault\fP: ScrollDown
.SS \fBme\-select\-entry\fP .SS \fBme\-select\-entry\fP
.PP .PP
Select hovered row Select hovered row
.PP .PP
\fBDefault\fP: MousePrimary \fBDefault\fP: MousePrimary
.SS \fBme\-accept\-entry\fP .SS \fBme\-accept\-entry\fP
.PP .PP
Accept hovered row Accept hovered row
.PP .PP
\fBDefault\fP: MouseDPrimary \fBDefault\fP: MouseDPrimary
.SS \fBme\-accept\-custom\fP .SS \fBme\-accept\-custom\fP
.PP .PP
Accept hovered row with custom action Accept hovered row with custom action
.PP .PP
\fBDefault\fP: Control+MouseDPrimary \fBDefault\fP: Control+MouseDPrimary
.SH SEE ALSO .SH SEE ALSO
.PP .PP
@ -606,20 +607,20 @@ rofi(1), rofi\-sensible\-terminal(1), rofi\-theme(5), rofi\-script(5)
.SH AUTHOR .SH AUTHOR
.PP .PP
Qball Cow Qball Cow qball@gmpclient.org
\[la]qball@gmpclient.org\[ra] \[la]mailto:qball@gmpclient.org\[ra]
.PP .PP
Rasmus Steinke Rasmus Steinke rasi@xssn.at
\[la]rasi@xssn.at\[ra] \[la]mailto:rasi@xssn.at\[ra]
.PP .PP
Quentin Glidic Quentin Glidic sardemff7+rofi@sardemff7.net
\[la]sardemff7+rofi@sardemff7.net\[ra] \[la]mailto:sardemff7+rofi@sardemff7.net\[ra]
.PP .PP
Original code based on work by: Sean Pringle Original code based on work by: Sean Pringle sean.pringle@gmail.com
\[la]sean.pringle@gmail.com\[ra] \[la]mailto:sean.pringle@gmail.com\[ra]
.PP .PP
For a full list of authors, check the AUTHORS file. For a full list of authors, check the AUTHORS file.

17
doc/rofi-script.5
View file

@ -1,3 +1,4 @@
.nh
.TH ROFI\-SCRIPT 5 rofi\-script .TH ROFI\-SCRIPT 5 rofi\-script
.SH NAME .SH NAME
.PP .PP
@ -193,20 +194,20 @@ rofi(1), rofi\-sensible\-terminal(1), dmenu(1), rofi\-theme(5), rofi\-theme\-sel
.SH AUTHOR .SH AUTHOR
.PP .PP
Qball Cow Qball Cow qball@gmpclient.org
\[la]qball@gmpclient.org\[ra] \[la]mailto:qball@gmpclient.org\[ra]
.PP .PP
Rasmus Steinke Rasmus Steinke rasi@xssn.at
\[la]rasi@xssn.at\[ra] \[la]mailto:rasi@xssn.at\[ra]
.PP .PP
Quentin Glidic Quentin Glidic sardemff7+rofi@sardemff7.net
\[la]sardemff7+rofi@sardemff7.net\[ra] \[la]mailto:sardemff7+rofi@sardemff7.net\[ra]
.PP .PP
Original code based on work by: Sean Pringle Original code based on work by: Sean Pringle sean.pringle@gmail.com
\[la]sean.pringle@gmail.com\[ra] \[la]mailto:sean.pringle@gmail.com\[ra]
.PP .PP
For a full list of authors, check the AUTHORS file. For a full list of authors, check the AUTHORS file.

1
doc/rofi-sensible-terminal.1
View file

@ -1,3 +1,4 @@
.nh
.TH rofi\-sensible\-terminal 1 rofi\-sensible\-terminal .TH rofi\-sensible\-terminal 1 rofi\-sensible\-terminal
.SH NAME .SH NAME
.PP .PP

7
doc/rofi-theme-selector.1
View file

@ -1,3 +1,4 @@
.nh
.TH rofi\-theme\-selector 1 rofi\-theme\-selector .TH rofi\-theme\-selector 1 rofi\-theme\-selector
.SH NAME .SH NAME
.PP .PP
@ -30,8 +31,8 @@ $XDG\_DATA\_HOME/share/rofi/themes
.RE .RE
.PP .PP
${PREFIX} reflects the install location of rofi. In most cases this will be "/usr".<br> ${PREFIX} reflects the install location of rofi. In most cases this will be "/usr".
$XDG\_CONFIG\_HOME is normally unset. Default path is "$HOME/.config".<br> $XDG\_CONFIG\_HOME is normally unset. Default path is "$HOME/.config".
$XDG\_DATA\_HOME is normally unset. Default path is "$HOME/.local/share". $XDG\_DATA\_HOME is normally unset. Default path is "$HOME/.local/share".
.SH SEE ALSO .SH SEE ALSO
@ -40,5 +41,5 @@ rofi(1)
.SH AUTHORS .SH AUTHORS
.PP .PP
Qball Cow qball@gmpclient.org<br> Qball Cow qball@gmpclient.org
Rasmus Steinke rasi@xssn.at Rasmus Steinke rasi@xssn.at

50
doc/rofi-theme.5
View file

@ -1,3 +1,4 @@
.nh
.TH ROFI\-THEME 5 rofi\-theme .TH ROFI\-THEME 5 rofi\-theme
.SH NAME .SH NAME
.PP .PP
@ -133,7 +134,7 @@ abbreviation for \fBr\fPofi \fBa\fPdvanced \fBs\fPtyle \fBi\fPnformation.
.SH Basic Structure .SH Basic Structure
.PP .PP
Each element has a section with defined properties. Global properties can be defined in section \fB\fC* { }\fR\&. Each element has a section with defined properties. Global properties can be defined in section \fB\fC* { }\fR\&.
Sub\-section names begin with a hash symbol \fB\fC#\fR\&. Sub\-\&section names begin with a hash symbol \fB\fC#\fR\&.
.PP .PP
It is advised to define the \fIglobal properties section\fP on top of the file to It is advised to define the \fIglobal properties section\fP on top of the file to
@ -492,11 +493,7 @@ The different values are:
.IP \(bu 2 .IP \(bu 2
\fB\fC{PERCENTAGE}\fR can be between 0\-1.0, or 0%\-100% \fB\fC{PERCENTAGE}\fR can be between 0\-1.0, or 0%\-100%
.IP \(bu 2 .IP \(bu 2
\fB\fC{named\-color}\fR is one of the following colors:AliceBlue, AntiqueWhite, Aqua, Aquamarine, Azure, Beige, Bisque, Black, BlanchedAlmond, Blue, BlueViolet, Brown,
.PP
\fB\fC{named\-color}\fR is one of the following colors:
.PP
AliceBlue, AntiqueWhite, Aqua, Aquamarine, Azure, Beige, Bisque, Black, BlanchedAlmond, Blue, BlueViolet, Brown,
BurlyWood, CadetBlue, Chartreuse, Chocolate, Coral, CornflowerBlue, Cornsilk, Crimson, Cyan, DarkBlue, DarkCyan, BurlyWood, CadetBlue, Chartreuse, Chocolate, Coral, CornflowerBlue, Cornsilk, Crimson, Cyan, DarkBlue, DarkCyan,
DarkGoldenRod, DarkGray, DarkGrey, DarkGreen, DarkKhaki, DarkMagenta, DarkOliveGreen, DarkOrange, DarkOrchid, DarkRed, DarkGoldenRod, DarkGray, DarkGrey, DarkGreen, DarkKhaki, DarkMagenta, DarkOliveGreen, DarkOrange, DarkOrchid, DarkRed,
DarkSalmon, DarkSeaGreen, DarkSlateBlue, DarkSlateGray, DarkSlateGrey, DarkTurquoise, DarkViolet, DeepPink, DeepSkyBlue, DarkSalmon, DarkSeaGreen, DarkSlateBlue, DarkSlateGray, DarkSlateGrey, DarkTurquoise, DarkViolet, DeepPink, DeepSkyBlue,
@ -734,6 +731,7 @@ style property.
.PP .PP
When no unit is specified, pixels are assumed. When no unit is specified, pixels are assumed.
.RE .RE
.SH Position .SH Position
@ -742,22 +740,14 @@ Indicate a place on the window/monitor.
.RS .RS
.IP \(bu 2 .IP \(bu 2
.PP
Format: \fB\fC(center|east|north|west|south|north east|north west|south west|south east)\fR Format: \fB\fC(center|east|north|west|south|north east|north west|south west|south east)\fR
.PP \fB\fC
.RS
.nf
north west | north | north east north west | north | north east
\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-
west | center | east west | center | east
\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\- \-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-\-|\-\-\-\-\-\-\-\-\-\-\-\-
south west | south | south east south west | south | south east
\fR
.fi
.RE
.RE .RE
@ -992,7 +982,6 @@ The current widgets available in \fBrofi\fP:
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCwindow\fR \fB\fCwindow\fR
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCoverlay\fR: the overlay widget. \fB\fCoverlay\fR: the overlay widget.
@ -1000,7 +989,6 @@ The current widgets available in \fBrofi\fP:
\fB\fCmainbox\fR: The mainbox box. \fB\fCmainbox\fR: The mainbox box.
.IP \(bu 2 .IP \(bu 2
\fB\fCinputbar\fR: The input bar box. \fB\fCinputbar\fR: The input bar box.
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCbox\fR: the horizontal @box packing the widgets \fB\fCbox\fR: the horizontal @box packing the widgets
@ -1016,15 +1004,14 @@ The current widgets available in \fBrofi\fP:
\fB\fCnum\-filtered\-rows\fR: Shows the total number of rows after filtering. \fB\fCnum\-filtered\-rows\fR: Shows the total number of rows after filtering.
.RE .RE
.IP \(bu 2 .IP \(bu 2
\fB\fClistview\fR: The listview. \fB\fClistview\fR: The listview.
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCscrollbar\fR: the listview scrollbar \fB\fCscrollbar\fR: the listview scrollbar
.IP \(bu 2 .IP \(bu 2
\fB\fCelement\fR: a box in the listview holding the entries \fB\fCelement\fR: a box in the listview holding the entries
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCelement\-icon\fR: the widget in the listview's entry showing the (optional) icon \fB\fCelement\-icon\fR: the widget in the listview's entry showing the (optional) icon
@ -1035,26 +1022,29 @@ The current widgets available in \fBrofi\fP:
.RE .RE
.RE .RE
.IP \(bu 2 .IP \(bu 2
\fB\fCmode\-switcher\fR: the main horizontal @box packing the buttons. \fB\fCmode\-switcher\fR: the main horizontal @box packing the buttons.
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCbutton\fR: the buttons @textbox for each mode \fB\fCbutton\fR: the buttons @textbox for each mode
.RE .RE
.IP \(bu 2 .IP \(bu 2
\fB\fCmessage\fR: The container holding the textbox. \fB\fCmessage\fR: The container holding the textbox.
.RS .RS
.IP \(bu 2 .IP \(bu 2
\fB\fCtextbox\fR: the message textbox \fB\fCtextbox\fR: the message textbox
.RE .RE
.RE .RE
.RE .RE
.PP .PP
@ -1162,13 +1152,9 @@ Type of mouse cursor that is set when the mouse pointer is hovered over the widg
.SS window: .SS window:
.RS .RS
.IP \(bu 2 .IP \(bu 2
.PP
\fBfont\fP: string \fBfont\fP: string
The font used in the window The font used in the window
.IP \(bu 2 .IP \(bu 2
.PP
\fBtransparency\fP: string \fBtransparency\fP: string
Indicating if transparency should be used and what type: Indicating if transparency should be used and what type:
\fBreal\fP \- True transparency. Only works with a compositor. \fBreal\fP \- True transparency. Only works with a compositor.
@ -1176,32 +1162,20 @@ Indicating if transparency should be used and what type:
\fBscreenshot\fP \- Take a screenshot of the screen and use that. \fBscreenshot\fP \- Take a screenshot of the screen and use that.
\fBPath\fP to png file \- Use an image. \fBPath\fP to png file \- Use an image.
.IP \(bu 2 .IP \(bu 2
.PP
\fBlocation\fP: position \fBlocation\fP: position
The place of the anchor on the monitor The place of the anchor on the monitor
.IP \(bu 2 .IP \(bu 2
.PP
\fBanchor\fP: anchor \fBanchor\fP: anchor
The anchor position on the window The anchor position on the window
.IP \(bu 2 .IP \(bu 2
.PP
\fBfullscreen\fP: boolean \fBfullscreen\fP: boolean
Window is fullscreen. Window is fullscreen.
.IP \(bu 2 .IP \(bu 2
.PP
\fBwidth\fP: distance \fBwidth\fP: distance
The width of the window The width of the window
.IP \(bu 2 .IP \(bu 2
.PP
\fBx\-offset\fP: distance \fBx\-offset\fP: distance
.IP \(bu 2 .IP \(bu 2
.PP
\fBy\-offset\fP: distance \fBy\-offset\fP: distance
The offset of the window to the anchor point, allowing you to push the window left/right/up/down The offset of the window to the anchor point, allowing you to push the window left/right/up/down

152
doc/rofi.1
View file

@ -1,3 +1,4 @@
.nh
.TH ROFI 1 rofi .TH ROFI 1 rofi
.SH NAME .SH NAME
.PP .PP
@ -174,11 +175,7 @@ Specify the number of threads \fBrofi\fP should use:
.IP \(bu 2 .IP \(bu 2
1: Disable threading 1: Disable threading
.IP \(bu 2 .IP \(bu 2
2..n: Specify the maximum number of threads to use in the thread pool.Default: Autodetect
.PP
2..n: Specify the maximum number of threads to use in the thread pool.
.PP
Default: Autodetect
.RE .RE
@ -217,6 +214,9 @@ Or get the options from a script:
.fi .fi
.RE .RE
.PP
See the \fBrofi\-dmenu(5)\fP manpage for more information.
.PP .PP
\fB\fC\-show\fR \fImode\fP \fB\fC\-show\fR \fImode\fP
@ -458,11 +458,7 @@ The different fields are:
.IP \(bu 2 .IP \(bu 2
\fBcomment\fP: the application comment \fBcomment\fP: the application comment
.IP \(bu 2 .IP \(bu 2
\fBall\fP: all the aboveDefault: \fIname,generic,exec,categories,keywords\fP
.PP
\fBall\fP: all the above
.PP
Default: \fIname,generic,exec,categories,keywords\fP
.RE .RE
@ -535,11 +531,7 @@ The different fields are:
.IP \(bu 2 .IP \(bu 2
\fBdesktop\fP: window's current desktop \fBdesktop\fP: window's current desktop
.IP \(bu 2 .IP \(bu 2
\fBall\fP: all the aboveDefault: \fIall\fP
.PP
\fBall\fP: all the above
.PP
Default: \fIall\fP
.RE .RE
@ -672,11 +664,7 @@ behavior.)
.IP \(bu 2 .IP \(bu 2
\fB\-4\fP: the monitor with the focused window. \fB\-4\fP: the monitor with the focused window.
.IP \(bu 2 .IP \(bu 2
\fB\-5\fP: the monitor that shows the mouse pointer.Default: \fI\-5\fP
.PP
\fB\-5\fP: the monitor that shows the mouse pointer.
.PP
Default: \fI\-5\fP
.RE .RE
@ -991,7 +979,7 @@ Maximum number of entries to store in history. Defaults to 25. (WARNING: can cau
.PP .PP
Pops up a message dialog (used internally for showing errors) with \fImessage\fP\&. Pops up a message dialog (used internally for showing errors) with \fImessage\fP\&.
Message can be multi\-line. Message can be multi\-\&line.
.SS File browser settings .SS File browser settings
.PP .PP
@ -1108,96 +1096,11 @@ Please see \fBrofi\-theme(5)\fP manpage for more information on theming.
.SH KEY BINDINGS .SH KEY BINDINGS
.PP .PP
\fBrofi\fP has the following key bindings: Please see the \fBrofi\-keys(5)\fP manpage for the keybindings and how to set them up.
.RS
.IP \(bu 2
\fB\fCControl\-v, Insert\fR: Paste from clipboard
.IP \(bu 2
\fB\fCControl\-Shift\-v, Shift\-Insert\fR: Paste primary selection
.IP \(bu 2
\fB\fCControl\-u\fR: Clear the line
.IP \(bu 2
\fB\fCControl\-a\fR: Beginning of line
.IP \(bu 2
\fB\fCControl\-e\fR: End of line
.IP \(bu 2
\fB\fCControl\-f, Right\fR: Forward one character
.IP \(bu 2
\fB\fCAlt\-f, Control\-Right\fR: Forward one word
.IP \(bu 2
\fB\fCControl\-b, Left\fR: Back one character
.IP \(bu 2
\fB\fCAlt\-b, Control\-Left\fR: Back one word
.IP \(bu 2
\fB\fCControl\-d, Delete\fR: Delete character
.IP \(bu 2
\fB\fCControl\-Alt\-d\fR: Delete word
.IP \(bu 2
\fB\fCControl\-h, Backspace, Shift\-Backspace\fR: Backspace (delete previous character)
.IP \(bu 2
\fB\fCControl\-Alt\-h\fR: Delete previous word
.IP \(bu 2
\fB\fCControl\-j,Control\-m,Enter\fR: Accept entry
.IP \(bu 2
\fB\fCControl\-n,Down\fR: Select next entry
.IP \(bu 2
\fB\fCControl\-p,Up\fR: Select previous entry
.IP \(bu 2
\fB\fCPage Up\fR: Go to previous page
.IP \(bu 2
\fB\fCPage Down\fR: Go to next page
.IP \(bu 2
\fB\fCControl\-Page Up\fR: Go to previous column
.IP \(bu 2
\fB\fCControl\-Page Down\fR: Go to next column
.IP \(bu 2
\fB\fCControl\-Enter\fR: Use entered text as a command (in \fB\fCssh/run modi\fR)
.IP \(bu 2
\fB\fCShift\-Enter\fR: Launch the application in a terminal (in run mode)
.IP \(bu 2
\fB\fCControl\-Shift\-Enter\fR: As Control\-Enter and run the command in terminal (in run mode)
.IP \(bu 2
\fB\fCShift\-Enter\fR: Return the selected entry and move to the next item while keeping \fBrofi\fP open. (in dmenu)
.IP \(bu 2
\fB\fCShift\-Right\fR: Switch to the next mode. The list can be customized with the \fB\fC\-modi\fR argument.
.IP \(bu 2
\fB\fCShift\-Left\fR: Switch to the previous mode. The list can be customized with the \fB\fC\-modi\fR argument.
.IP \(bu 2
\fB\fCControl\-Tab\fR: Switch to the next mode. The list can be customized with the \fB\fC\-modi\fR argument.
.IP \(bu 2
\fB\fCControl\-Shift\-Tab\fR: Switch to the previous mode. The list can be customized with the \fB\fC\-modi\fR argument.
.IP \(bu 2
\fB\fCControl\-space\fR: Set selected item as input text.
.IP \(bu 2
\fB\fCShift\-Del\fR: Delete entry from history.
.IP \(bu 2
\fB\fCgrave\fR: Toggle case sensitivity.
.IP \(bu 2
\fB\fCAlt\-grave\fR: Toggle sorting.
.IP \(bu 2
\fB\fCAlt\-Shift\-S\fR: Take a screenshot and store it in the Pictures directory.
.IP \(bu 2
\fB\fCControl\-l\fR: File complete for run dialog.
.RE
.PP .PP
This list might not be complete, to get a full list of all key bindings The keybinding can also be used for actions, when the action is executed the
supported in your rofi, see \fB\fCrofi \-h\fR\&. The options starting with \fB\fC\-kb\fR are keybindings. mentioned keystroke is inserted:
.PP
Key bindings can be modified using the configuration systems. Multiple keys can be bound
to one action by comma separating them. For example \fB\fC\-kb\-primary\-paste "Conctrol+v,Insert"\fR
.PP
To get a searchable list of key bindings, run \fB\fCrofi \-show keys\fR\&.
.PP
A key binding starting with \fB\fC!\fR will act when all keys have been released.
.PP
You can bind certain events to key\-actions:
.SS Timeout .SS Timeout
.PP .PP
@ -1236,9 +1139,6 @@ configuration {
.fi .fi
.RE .RE
.PP
For a full list of bindings, see the \fBrofi\-keys(5)\fP manpage.
.SH Available Modi .SH Available Modi
.SS window .SS window
.PP .PP
@ -1464,18 +1364,6 @@ rofi \-show keys
.fi .fi
.RE .RE
.PP
Use \fB\fCqalc\fR to get a simple calculator in \fBrofi\fP:
.PP
.RS
.nf
rofi \-show calc \-modi "calc:qalc +u8 \-nocurrencies"
.fi
.RE
.SH i3 .SH i3
.PP .PP
In i3 In i3
@ -1620,21 +1508,21 @@ first.
.SH AUTHOR .SH AUTHOR
.RS .RS
.IP \(bu 2 .IP \(bu 2
Qball Cow Qball Cow qball@blame.services
\[la]qball@blame.services\[ra] \[la]mailto:qball@blame.services\[ra]
.IP \(bu 2 .IP \(bu 2
Rasmus Steinke Rasmus Steinke rasi@xssn.at
\[la]rasi@xssn.at\[ra] \[la]mailto:rasi@xssn.at\[ra]
.IP \(bu 2 .IP \(bu 2
Quentin Glidic Quentin Glidic sardemff7+rofi@sardemff7.net
\[la]sardemff7+rofi@sardemff7.net\[ra] \[la]mailto:sardemff7+rofi@sardemff7.net\[ra]
.RE .RE
.PP .PP
Original code based on work by: Sean Pringle Original code based on work by: Sean Pringle
\[la]https://github.com/seanpringle/simpleswitcher\[ra] \[la]https://github.com/seanpringle/simpleswitcher\[ra] sean.pringle@gmail.com
\[la]sean.pringle@gmail.com\[ra] \[la]mailto:sean.pringle@gmail.com\[ra]
.PP .PP
For a full list of authors, check the \fB\fCAUTHORS\fR file. For a full list of authors, check the \fB\fCAUTHORS\fR file.

60
doc/rofi.1.markdown
View file

@ -131,6 +131,8 @@ Or get the options from a script:
~/my_script.sh | rofi -dmenu ~/my_script.sh | rofi -dmenu
See the **rofi-dmenu(5)** manpage for more information.
`-show` *mode* `-show` *mode*
Open **rofi** in a certain mode. Available modes are `window`, `run`, `drun`, `ssh`, `combi`. Open **rofi** in a certain mode. Available modes are `window`, `run`, `drun`, `ssh`, `combi`.
@ -674,54 +676,10 @@ Please see **rofi-theme(5)** manpage for more information on theming.
## KEY BINDINGS ## KEY BINDINGS
**rofi** has the following key bindings: Please see the **rofi-keys(5)** manpage for the keybindings and how to set them up.
* `Control-v, Insert`: Paste from clipboard The keybinding can also be used for actions, when the action is executed the
* `Control-Shift-v, Shift-Insert`: Paste primary selection mentioned keystroke is inserted:
* `Control-u`: Clear the line
* `Control-a`: Beginning of line
* `Control-e`: End of line
* `Control-f, Right`: Forward one character
* `Alt-f, Control-Right`: Forward one word
* `Control-b, Left`: Back one character
* `Alt-b, Control-Left`: Back one word
* `Control-d, Delete`: Delete character
* `Control-Alt-d`: Delete word
* `Control-h, Backspace, Shift-Backspace`: Backspace (delete previous character)
* `Control-Alt-h`: Delete previous word
* `Control-j,Control-m,Enter`: Accept entry
* `Control-n,Down`: Select next entry
* `Control-p,Up`: Select previous entry
* `Page Up`: Go to previous page
* `Page Down`: Go to next page
* `Control-Page Up`: Go to previous column
* `Control-Page Down`: Go to next column
* `Control-Enter`: Use entered text as a command (in `ssh/run modi`)
* `Shift-Enter`: Launch the application in a terminal (in run mode)
* `Control-Shift-Enter`: As Control-Enter and run the command in terminal (in run mode)
* `Shift-Enter`: Return the selected entry and move to the next item while keeping **rofi** open. (in dmenu)
* `Shift-Right`: Switch to the next mode. The list can be customized with the `-modi` argument.
* `Shift-Left`: Switch to the previous mode. The list can be customized with the `-modi` argument.
* `Control-Tab`: Switch to the next mode. The list can be customized with the `-modi` argument.
* `Control-Shift-Tab`: Switch to the previous mode. The list can be customized with the `-modi` argument.
* `Control-space`: Set selected item as input text.
* `Shift-Del`: Delete entry from history.
* `grave`: Toggle case sensitivity.
* `Alt-grave`: Toggle sorting.
* `Alt-Shift-S`: Take a screenshot and store it in the Pictures directory.
* `Control-l`: File complete for run dialog.
This list might not be complete, to get a full list of all key bindings
supported in your rofi, see `rofi -h`. The options starting with `-kb` are keybindings.
Key bindings can be modified using the configuration systems. Multiple keys can be bound
to one action by comma separating them. For example `-kb-primary-paste "Conctrol+v,Insert"`
To get a searchable list of key bindings, run `rofi -show keys`.
A key binding starting with `!` will act when all keys have been released.
You can bind certain events to key-actions:
### Timeout ### Timeout
@ -750,8 +708,6 @@ configuration {
} }
``` ```
For a full list of bindings, see the **rofi-keys(5)** manpage.
## Available Modi ## Available Modi
### window ### window
@ -899,10 +855,6 @@ Show all key bindings:
rofi -show keys rofi -show keys
Use `qalc` to get a simple calculator in **rofi**:
rofi -show calc -modi "calc:qalc +u8 -nocurrencies"
## i3 ## i3
In [i3](http://i3wm.org/) you want to bind **rofi** to be launched on key release. Otherwise, it cannot grab the keyboard. In [i3](http://i3wm.org/) you want to bind **rofi** to be launched on key release. Otherwise, it cannot grab the keyboard.
@ -960,7 +912,7 @@ If you run custom C plugins, you can disable them using:
Disables the loading of plugins. Disables the loading of plugins.
To further debug the plugin, you can get a trace with (lots of) debug information. This debug output can be enabled for To further debug the plugin, you can get a trace with (lots of) debug information. This debug output can be enabled for
multiple parts in rofi using the glib debug framework. Debug domains can be enabled by setting the G_MESSAGES_DEBUG multiple parts in rofi using the glib debug framework. Debug domains can be enabled by setting the G\_MESSAGES\_DEBUG
environment variable. At the time of creation of this page, the following debug domains exist: environment variable. At the time of creation of this page, the following debug domains exist:
* all: Show debug information from all domains. * all: Show debug information from all domains.