Set window title based on mode name.

For dmenu allow customize with `-window-title`.

Fixes: #969

5 files changed, 839 insertions, 1225 deletions

diff --git a/doc/rofi.1 b/doc/rofi.1
index 9198e598..45d63398 100644
--- a/doc/rofi.1
+++ b/doc/rofi.1
@@ -1,1658 +1,1233 @@
-.\" generated with Ronn/v0.7.3
-.\" http://github.com/rtomayko/ronn/tree/0.7.3
-.
-.TH "ROFI" "1" "August 2019" "" ""
-.
+.TH "ROFI" "" "August 2019" "" ""
 .SH "NAME"
-\fBrofi\fR \- A window switcher, application launcher, ssh dialog and dmenu replacement
-.
-.SH "SYNOPSIS"
+\fBROFI\fR
+.SH NAME
+.P
+\fBrofi\fR \- A window switcher,  application launcher, ssh dialog and dmenu replacement
+.SH SYNOPSIS
+.P
 \fBrofi\fR [ \-show \fImode\fR ]|[ \-dmenu ]|[ \-e \fImsg\fR ] [ CONFIGURATION ]
-.
-.SH "DESCRIPTION"
-\fBrofi\fR 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"
-\fBrofi\fR\'s main functionality is to assist in your workflow, allowing you to quickly switch between windows, start applications or log into a remote machine via ssh\. There are different \fImodi\fR for different types of actions\.
-.
-.P
-\fBrofi\fR can also function as (drop\-in) replacement for \fBdmenu(1)\fR\.
-.
-.SS "Running rofi"
-To launch \fBrofi\fR directly in a certain mode, specify a mode with \fBrofi \-show <mode>\fR\. To show the run dialog:
-.
-.IP "" 4
-.
+.SH DESCRIPTION
+.P
+\fBrofi\fR 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
+.P
+\fBrofi\fR\|'s main functionality is to assist in your workflow, allowing you to quickly switch
+between windows, start applications or log into a remote machine via ssh\. There are different \fImodi\fR for different types of
+actions\.
+.P
+\fBrofi\fR can also function as (drop\-in) replacement for \fBdmenu(1)\fR\|\.
+.SS Running rofi
+.P
+To launch \fBrofi\fR directly in a certain mode, specify a mode with \fBrofi \-show <mode>\fP\|\.
+To show the run dialog:
+.P
+.RS 2
 .nf
-
 rofi \-show run
-.
 .fi
-.
-.IP "" 0
-.
-.SS "Emulating dmenu"
-\fBrofi\fR can emulate \fBdmenu(1)\fR (a dynamic menu for X) when launched with the \fB\-dmenu\fR flag\.
-.
-.P
-The website for \fBdmenu\fR can be found here \fIhttp://tools\.suckless\.org/dmenu/\fR\.
-.
-.P
-\fBrofi\fR does not aim to be 100% compatible with dmenu\. There are simply too many different flavors of dmenu\. The idea is that the basic usage command\-line flags are obeyed, theme\-related flags are not\. Besides, \fBrofi\fR offers some extended features (like multi\-select, highlighting, message bar, extra key bindings)\.
-.
-.SS "Display Error message"
+.RE
+.SS Emulating dmenu
+.P
+\fBrofi\fR can emulate \fBdmenu(1)\fR (a dynamic menu for X) when launched with the \fB\-dmenu\fP flag\.
+.P
+The website for \fBdmenu\fP can be found here \fIhttp://tools\.suckless\.org/dmenu/\fR\|\.
+.P
+\fBrofi\fR does not aim to be 100% compatible with dmenu\. There are simply too many different flavors of dmenu\.
+The idea is that the basic usage command\-line flags are obeyed, theme\-related flags are not\.
+Besides, \fBrofi\fR offers some extended features (like multi\-select, highlighting, message bar, extra key bindings)\.
+.SS Display Error message
+.P
 \fBrofi\fR error dialog can also be called from the command line\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 rofi \-e "my message"
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Markup support can be enabled, see CONFIGURATION options\.
-.
-.SH "CONFIGURATION"
+.SH CONFIGURATION
+.P
 There are currently three methods of setting configuration options (evaluated in order below):
-.
-.IP "\(bu" 4
-System configuration file (for example \fB/etc/rofi\.conf\fR)\.
-.
-.IP "\(bu" 4
-Xresources: A method of storing key values in the Xserver\. See here \fIhttps://en\.wikipedia\.org/wiki/X_resources\fR for more information\.
-.
-.IP "\(bu" 4
+.RS 0
+.IP \(bu 2
+System configuration file (for example \fB/etc/rofi\.conf\fP)\.
+.IP \(bu 2
+Xresources: A method of storing key values in the Xserver\. See
+here \fIhttps://en\.wikipedia\.org/wiki/X_resources\fR for more information\.
+.IP \(bu 2
 Rasi theme file: The new \fItheme\fR format can be used to set configuration values\.
-.
-.IP "\(bu" 4
-Configuration File: This uses the same format as the Xresources file\. By default it looks in \fBXDG_USER_CONFIG_DIR\fR/rofi/config, but can be overridden on commandline\. By default XDG_USER_CONFIG_DIR defaults to \fB$HOME/\.config\fR\. (See \fBrofi \-h\fR for current location)\. This is the recommended way of configuring \fBrofi\fR\.
-.
-.IP "\(bu" 4
-Command\-line options: Arguments passed to \fBrofi\fR\.
-.
-.IP "" 0
-.
-.P
-\fBTIP\fR: To get a template config file run: \fBrofi \-dump\-xresources > rofi\-example\.config\fR\. \fBNOTE\fR: In version 1\.4\.0 we support configuration in a new format, a config for this can be generated by: \fBrofi \-dump\-config > config\.rasi\fR \fBNOTE\fR: If you want to use the new configuration format, the config file should be named \fBconfig\.rasi\fR\.
-.
-.P
-The Xresources file expects options starting with \fBrofi\.\fR followed by its name\. An example to set the number of lines:
-.
-.IP "" 4
-.
-.nf
+.IP \(bu 2
+Configuration File: This uses the same format as the Xresources file\.
+By default it looks in \fBXDG_USER_CONFIG_DIR\fP/rofi/config, but can be overridden on commandline\.
+By default XDG_USER_CONFIG_DIR defaults to \fB$HOME/\.config\fP\|\. (See \fBrofi \-h\fP for current location)\.
+This is the recommended way of configuring \fBrofi\fR\|\.
+.IP \(bu 2
+Command\-line options: Arguments passed to \fBrofi\fR\|\.
 
+.RE
+.P
+\fBTIP\fR: To get a template config file run: \fBrofi \-dump\-xresources > rofi\-example\.config\fP\|\.
+\fBNOTE\fR: In version 1\.4\.0 we support configuration in a new format, a config for this can be generated by: \fBrofi
+\-dump\-config > config\.rasi\fP
+\fBNOTE\fR: If you want to use the new configuration format, the config file should be named \fBconfig\.rasi\fP\|\.
+.P
+The Xresources file expects options starting with \fBrofi\.\fP followed by its name\. An example to set the number of lines:
+.P
+.RS 2
+.nf
 rofi\.lines: 10
-.
 .fi
-.
-.IP "" 0
-.
-.P
-Command line options override settings from Xresources file\. The same option set as argument — prefixed with a \'\-\':
-.
-.IP "" 4
-.
+.RE
+.P
+Command line options override settings from Xresources file\. The same option set as argument — prefixed with a '\-':
+.P
+.RS 2
 .nf
-
 rofi \-lines 10
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 To get a list of available options formatted as Xresources entries, run:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 rofi \-dump\-xresources
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 The configuration system supports the following types:
-.
-.IP "\(bu" 4
+.RS 0
+.IP \(bu 2
 string
-.
-.IP "\(bu" 4
+.IP \(bu 2
 integer (signed and unsigned)
-.
-.IP "\(bu" 4
+.IP \(bu 2
 char
-.
-.IP "\(bu" 4
+.IP \(bu 2
 Boolean
-.
-.IP "" 0
-.
+
+.RE
 .P
 Boolean options have a non\-default command\-line syntax\. Example to enable option X:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 \-X
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 To disable option X:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 \-no\-X
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Below is a list of the most important options:
-.
-.SS "General"
-\fB\-help\fR
-.
+.SS General
 .P
-The help option shows the full list of commandline options and the current set value\. These include dynamic (run\-time generated) options\.
-.
+\fB\-help\fP
 .P
-\fB\-dump\-xresources\fR
-.
+The help option shows the full list of commandline options and the current set value\.
+These include dynamic (run\-time generated) options\.
 .P
-Dump the current active configuration in Xresources format to the command\-line\. This does not validate all passed values (for example, colors)\.
-.
+\fB\-dump\-xresources\fP
 .P
-\fB\-threads\fR \fInum\fR
-.
+Dump the current active configuration in Xresources format to the command\-line\.
+This does not validate all passed values (for example, colors)\.
+.P
+\fB\-threads\fP \fInum\fR
 .P
 Specify the number of threads \fBrofi\fR should use:
-.
-.IP "\(bu" 4
+.RS 0
+.IP \(bu 2
 0: Autodetect the number of supported hardware threads\.
-.
-.IP "\(bu" 4
+.IP \(bu 2
 1: Disable threading
-.
-.IP "\(bu" 4
+.IP \(bu 2
 2\.\.N: Specify the maximum number of threads to use in the thread pool\.
-.
-.IP "" 0
-.
+
+.RE
+.P
+\fB\-dmenu\fP
 .P
-\fB\-dmenu\fR
-.
+Run \fBrofi\fR in dmenu mode\. This allows for interactive scripts\.
+In \fBdmenu\fP mode, \fBrofi\fR reads from STDIN, and output to STDOUT\.
+A simple example, displaying three pre\-defined options:
 .P
-Run \fBrofi\fR in dmenu mode\. This allows for interactive scripts\. In \fBdmenu\fR mode, \fBrofi\fR reads from STDIN, and output to STDOUT\. A simple example, displaying three pre\-defined options:
-.
-.IP "" 4
-.
+.RS 2
 .nf
-
-echo \-e "Option #1\enOption #2\enOption #3" | rofi \-dmenu
-.
+echo \-e "Option #1\\nOption #2\\nOption #3" | rofi \-dmenu
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Or get the options from a script:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 ~/my_script\.sh | rofi \-dmenu
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
-\fB\-show\fR \fImode\fR
-.
+\fB\-show\fP \fImode\fR
 .P
-Open \fBrofi\fR in a certain mode\. Available modes are \fBwindow\fR, \fBrun\fR, \fBdrun\fR, \fBssh\fR, \fBcombi\fR\. The special argument \fBkeys\fR can be used to open a searchable list of supported key bindings (see \fIKEY BINDINGS\fR)
-.
+Open \fBrofi\fR in a certain mode\. Available modes are \fBwindow\fP, \fBrun\fP, \fBdrun\fP, \fBssh\fP, \fBcombi\fP\|\.
+The special argument \fBkeys\fP can be used to open a searchable list of supported key bindings
+(see \fIKEY BINDINGS\fR)
 .P
 To show the run\-dialog:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 rofi \-show run
-.
 .fi
-.
-.IP "" 0
-.
+.RE
+.P
+\fB\-modi\fP \fImode1,mode1\fR
 .P
-\fB\-modi\fR \fImode1,mode1\fR
-.
+Specify an ordered, comma\-separated list of modes to enable\.
+Enabled modes can be changed at runtime\. Default key is Ctrl+Tab\.
+If no modes are specified, all modes will be enabled\.
+To only show the run and ssh launcher:
 .P
-Specify an ordered, comma\-separated list of modes to enable\. Enabled modes can be changed at runtime\. Default key is Ctrl+Tab\. If no modes are specified, all modes will be enabled\. To only show the run and ssh launcher:
-.
-.IP "" 4
-.
+.RS 2
 .nf
-
 rofi \-modi "run,ssh" \-show run
-.
 .fi
-.
-.IP "" 0
-.
-.P
-Custom modes can be added using the internal \'script\' mode\. Each mode has two parameters:
-.
-.IP "" 4
-.
+.RE
+.P
+Custom modes can be added using the internal 'script' mode\. Each mode has two parameters:
+.P
+.RS 2
 .nf
-
 <name>:<script>
-.
 .fi
-.
-.IP "" 0
-.
-.P
-Example: Have a mode \'Workspaces\' using the \fBi3_switch_workspaces\.sh\fR script:
-.
-.IP "" 4
-.
+.RE
+.P
+Example: Have a mode 'Workspaces' using the \fBi3_switch_workspaces\.sh\fP script:
+.P
+.RS 2
 .nf
-
 rofi \-modi "window,run,ssh,Workspaces:i3_switch_workspaces\.sh" \-show Workspaces
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
-Notes: The I3 Window manager does not like commas in the command when specifying an exec command\. For that case \'#\' can be used as an separator\.
-.
+Notes: The I3 Window manager does not like commas in the command when specifying an exec command\.
+For that case '#' can be used as an separator\.
 .P
-\fB\-case\-sensitive\fR
-.
+\fB\-case\-sensitive\fP
 .P
-Start in case sensitive mode\. This option can be changed at run\-time using the \fB\-kb\-toggle\-case\-sensitivity\fR key binding\.
-.
+Start in case sensitive mode\.
+This option can be changed at run\-time using the \fB\-kb\-toggle\-case\-sensitivity\fP key binding\.
 .P
-\fB\-cycle\fR
-.
+\fB\-cycle\fP
 .P
-Cycle through the result list\. Default is \'true\'\.
-.
+Cycle through the result list\. Default is 'true'\.
 .P
-\fB\-filter\fR \fIfilter\fR
-.
+\fB\-filter\fP \fIfilter\fR
 .P
 Filter the list by setting text in input bar to \fIfilter\fR
-.
 .P
-\fB\-config\fR \fIfilename\fR
-.
+\fB\-config\fP \fIfilename\fR
 .P
 Load an alternative configuration file\.
-.
 .P
-\fB\-cache\-dir\fR \fIfilename\fR
-.
+\fB\-cache\-dir\fP \fIfilename\fR
 .P
 Directory that is used to place temporary files, like history\.
-.
 .P
-\fB\-scroll\-method\fR \fImethod\fR
-.
+\fB\-scroll\-method\fP \fImethod\fR
 .P
 Select the scrolling method\. 0: Per page, 1: continuous\.
-.
 .P
-\fB\-[no\-]show\-match\fR
-.
+\fB\-[no\-]show\-match\fP
 .P
 Show the indicator that shows what part of the string is matched\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 Default: *true*
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
-\fB\-no\-lazy\-grab\fR
-.
+\fB\-no\-lazy\-grab\fP
 .P
 Disables lazy grab, this forces the keyboard being grabbed before gui is shown\.
-.
 .P
-\fB\-no\-plugins\fR
-.
+\fB\-no\-plugins\fP
 .P
 Disable plugin loading\.
-.
 .P
-\fB\-plugin\-path\fR \fIdirectory\fR
-.
+\fB\-plugin\-path\fP \fIdirectory\fR
 .P
 Specify the directory where \fBrofi\fR should look for plugins\.
-.
 .P
-\fB\-show\-icons\fR
-.
+\fB\-show\-icons\fP
 .P
 Show application icons in drun and window modes\.
-.
 .P
-\fB\-icon\-theme\fR
-.
+\fB\-icon\-theme\fP
+.P
+Specify icon theme to be used\.
+If not specified default theme from DE is used, \fIAdwaita\fR and \fIgnome\fR themes act as
+fallback themes\.
+.SS Matching
 .P
-Specify icon theme to be used\. If not specified default theme from DE is used, \fIAdwaita\fR and \fIgnome\fR themes act as fallback themes\.
-.
-.SS "Matching"
-\fB\-matching\fR \fImethod\fR
-.
+\fB\-matching\fP \fImethod\fR
 .P
-Specify the matching algorithm used\. Current the following methods are supported\.
-.
-.IP "\(bu" 4
+Specify the matching algorithm used\.
+Current the following methods are supported\.
+.RS 0
+.IP \(bu 2
 \fBnormal\fR: match the int string
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBregex\fR: match a regex input
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBglob\fR: match a glob pattern
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBfuzzy\fR: do a fuzzy match
-.
-.IP
-Default: \fInormal\fR
-.
-.IP "" 0
-.
+ Default: \fInormal\fR
+
+.RE
 .P
 Note: glob matching might be slow for larger lists
-.
 .P
-\fB\-tokenize\fR
-.
+\fB\-tokenize\fP
 .P
 Tokenize the input\.
-.
 .P
-\fB\-drun\-categories\fR \fIcategory\fR,\fIcategory\fR
-.
+\fB\-drun\-categories\fP \fIcategory\fR,\fIcategory\fR
 .P
 Only show desktop files that are present in the listed categories\.
-.
-.P
-\fB\-drun\-match\-fields\fR \fIfield1\fR,\fIfield2\fR,\.\.\.
-.
-.P
-When using drun, match only with the specified Desktop entry fields\. The different fields are:
-.
-.IP "\(bu" 4
-\fBname\fR: the application\'s name
-.
-.IP "\(bu" 4
-\fBgeneric\fR: the application\'s generic name
-.
-.IP "\(bu" 4
-\fBexec\fR: the application\'s executable
-.
-.IP "\(bu" 4
-\fBcategories\fR: the application\'s categories
-.
-.IP "\(bu" 4
+.P
+\fB\-drun\-match\-fields\fP \fIfield1\fR,\fIfield2\fR,\.\.\.
+.P
+When using drun, match only with the specified Desktop entry fields\.
+The different fields are:
+.RS 0
+.IP \(bu 2
+\fBname\fR: the application's name
+.IP \(bu 2
+\fBgeneric\fR: the application's generic name
+.IP \(bu 2
+\fBexec\fR: the application's  executable
+.IP \(bu 2
+\fBcategories\fR: the application's categories
+.IP \(bu 2
 \fBcomment\fR: the application comment
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBall\fR: all of the above
-.
-.IP
-Default: \fIname,generic,exec,categories\fR
-.
-.IP "" 0
-.
+  Default: \fIname,generic,exec,categories\fR
+
+.RE
 .P
-\fB\-drun\-display\-format\fR
-.
+\fB\-drun\-display\-format\fP
 .P
 The format string for the drun dialog:
-.
-.IP "\(bu" 4
-\fBname\fR: the application\'s name
-.
-.IP "\(bu" 4
-\fBgeneric\fR: the application\'s generic name
-.
-.IP "\(bu" 4
-\fBexec\fR: the application\'s executable
-.
-.IP "\(bu" 4
-\fBcategories\fR: the application\'s categories
-.
-.IP "\(bu" 4
+.RS 0
+.IP \(bu 2
+\fBname\fR: the application's name
+.IP \(bu 2
+\fBgeneric\fR: the application's generic name
+.IP \(bu 2
+\fBexec\fR: the application's  executable
+.IP \(bu 2
+\fBcategories\fR: the application's categories
+.IP \(bu 2
 \fBcomment\fR: the application comment
-.
-.IP "" 0
-.
+
+.RE
 .P
 Pango markup can be used to formatting the output\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
-Default: {name} [<span weight=\'light\' size=\'small\'><i>({generic})</i></span>]
-.
+Default: {name} [<span weight='light' size='small'><i>({generic})</i></span>]
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
-Note: Only fields enabled in \fB\-drun\-match\-fields\fR can be used in the format string\.
-.
+Note: Only fields enabled in \fB\-drun\-match\-fields\fP can be used in the format string\.
 .P
-\fB\-[no\-]drun\-show\-actions\fR
-.
+\fB\-[no\-]drun\-show\-actions\fP
 .P
 Show actions present in the Desktop files\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 Default: false
-.
 .fi
-.
-.IP "" 0
-.
-.P
-\fB\-window\-match\-fields\fR \fIfield1\fR,\fIfield2\fR,\.\.\.
-.
-.P
-When using window mode, match only with the specified fields\. The different fields are:
-.
-.IP "\(bu" 4
-\fBtitle\fR: window\'s title
-.
-.IP "\(bu" 4
-\fBclass\fR: window\'s class
-.
-.IP "\(bu" 4
-\fBrole\fR: window\'s role
-.
-.IP "\(bu" 4
-\fBname\fR: window\'s name
-.
-.IP "\(bu" 4
-\fBdesktop\fR: window\'s current desktop
-.
-.IP "\(bu" 4
+.RE
+.P
+\fB\-window\-match\-fields\fP \fIfield1\fR,\fIfield2\fR,\.\.\.
+.P
+When using window mode, match only with the specified fields\.
+The different fields are:
+.RS 0
+.IP \(bu 2
+\fBtitle\fR: window's title
+.IP \(bu 2
+\fBclass\fR: window's class
+.IP \(bu 2
+\fBrole\fR: window's role
+.IP \(bu 2
+\fBname\fR: window's name
+.IP \(bu 2
+\fBdesktop\fR: window's current desktop
+.IP \(bu 2
 \fBall\fR: all of the above
-.
-.IP
-Default: \fIall\fR
-.
-.IP "" 0
-.
-.P
-\fB\-matching\-negate\-char\fR \fIchar\fR
-.
-.P
-Set the character used to negate the query (i\.e\. if it does \fBnot\fR match the next keyword )\. Set to \'\ex0\' to disable\.
-.
-.IP "" 4
-.
-.nf
+  Default: \fIall\fR
 
-Default: \'\-\'
-.
+.RE
+.P
+\fB\-matching\-negate\-char\fP \fIchar\fR
+.P
+Set the character used to negate the query (i\.e\. if it does \fBnot\fR match the next keyword )\.
+Set to '\\x0' to disable\.
+.P
+.RS 2
+.nf
+Default: '\-'
 .fi
-.
-.IP "" 0
-.
-.SS "Layout"
-Most of the following options are \fBdeprecated\fR and should not be used\. Please use the new theme format to customize \fBrofi\fR\. More information about the new format can be found in the \fBrofi\-theme(5)\fR manpage\.
-.
+.RE
+.SS Layout
 .P
-\fB\-lines\fR
-.
+Most of the following options are \fBdeprecated\fR and should not be used\. Please use the new theme format to customize
+\fBrofi\fR\|\. More information about the new format can be found in the \fBrofi\-theme(5)\fR manpage\.
+.P
+\fB\-lines\fP
 .P
 Maximum number of lines to show before scrolling\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 rofi \-lines 25
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Default: \fI15\fR
-.
 .P
-\fB\-columns\fR
-.
+\fB\-columns\fP
 .P
 Number of columns to show before scrolling\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 rofi \-columns 2
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Default: \fI1\fR
-.
 .P
-\fB\-width\fR [value]
-.
+\fB\-width\fP [value]
+.P
+Set width of menu\. \fB[value]\fP is specified in percentage\.
 .P
-Set width of menu\. \fB[value]\fR is specified in percentage\.
-.
-.IP "" 4
-.
+.RS 2
 .nf
-
 rofi \-width 60
-.
 .fi
-.
-.IP "" 0
-.
-.P
-If \fB[value]\fR is larger then 100, size is set in pixels\. Example to span a full\-HD monitor:
-.
-.IP "" 4
-.
+.RE
+.P
+If \fB[value]\fP is larger then 100, size is set in pixels\. Example to span a full\-HD monitor:
+.P
+.RS 2
 .nf
-
 rofi \-width 1920
-.
 .fi
-.
-.IP "" 0
-.
-.P
-If \fB[value]\fR is negative, it tries to estimates a character width\. To show 30 characters in a row:
-.
-.IP "" 4
-.
+.RE
+.P
+If \fB[value]\fP is negative, it tries to estimates a character width\. To show 30 characters in a row:
+.P
+.RS 2
 .nf
-
 rofi \-width \-30
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Character width is a rough estimate, and might not be correct, but should work for most monospaced fonts\.
-.
 .P
 Default: \fI50\fR
-.
 .P
-\fB\-location\fR
-.
+\fB\-location\fP
 .P
 Specify where the window should be located\. The numbers map to the following locations on screen:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
   1 2 3
   8 0 4
   7 6 5
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 Default: \fI0\fR
-.
 .P
-\fB\-fixed\-num\-lines\fR
-.
+\fB\-fixed\-num\-lines\fP
 .P
-Keep a fixed number of visible lines (See the \fB\-lines\fR option\.)
-.
+Keep a fixed number of visible lines (See the \fB\-lines\fP option\.)
 .P
-\fB\-padding\fR
-.
+\fB\-padding\fP
 .P
 Define the inner margin of the window\.
-.
 .P
 Default: \fI5\fR
-.
 .P
-\fB\-fullscreen\fR
-.
+\fB\-fullscreen\fP
 .P
 Use the full\-screen height and width\.
-.
 .P
-\fB\-sidebar\-mode\fR
-.
+\fB\-sidebar\-mode\fP
+.P
+Open in sidebar\-mode\. In this mode a list of all enabled modes is shown at the bottom\.
+(See \fB\-modi\fP option)
+To show sidebar, use:
 .P
-Open in sidebar\-mode\. In this mode a list of all enabled modes is shown at the bottom\. (See \fB\-modi\fR option) To show sidebar, use:
-.
-.IP "" 4
-.
+.RS 2
 .nf
-
 rofi \-show run \-sidebar\-mode \-lines 0
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
-\fB\-auto\-select\fR
-.
+\fB\-auto\-select\fP
 .P
 When one entry is left, automatically select it\.
-.
 .P
-\fB\-m\fR \fInum\fR
-.
+\fB\-m\fP \fInum\fR
 .P
-\fB\-m\fR \fIname\fR
-.
+\fB\-m\fP \fIname\fR
 .P
-\fB\-monitor\fR \fInum\fR
-.
+\fB\-monitor\fP \fInum\fR
 .P
-\fB\-monitor\fR \fIname\fR
-.
+\fB\-monitor\fP \fIname\fR
 .P
-Select monitor to display \fBrofi\fR on\. It accepts as input: \fIprimary\fR (if primary output is set), the \fIxrandr\fR output name, or integer number (in order of detection)\. Negative numbers are handled differently:
-.
-.IP "\(bu" 4
+Select monitor to display \fBrofi\fR on\.
+It accepts as input: \fIprimary\fR (if primary output is set), the \fIxrandr\fR output name, or integer number (in order of
+detection)\. Negative numbers are handled differently:
+.RS 0
+.IP \(bu 2
 \fB\-1\fR: the currently focused monitor\.
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fB\-2\fR: the currently focused window (that is, \fBrofi\fR will be displayed on top of the focused window)\.
-.
-.IP "\(bu" 4
-\fB\-3\fR: Position at mouse (overrides the location setting to get normal context menu behavior\.)
-.
-.IP "\(bu" 4
+.IP \(bu 2
+\fB\-3\fR: Position at mouse (overrides the location setting to get normal context menu
+behavior\.)
+.IP \(bu 2
 \fB\-4\fR: the monitor with the focused window\.
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fB\-5\fR: the monitor that shows the mouse pointer\.
-.
-.IP
 Default: \fI\-5\fR
-.
-.IP "" 0
-.
+
+.RE
 .P
-See \fBrofi \-h\fR output for the detected monitors, their position, and size\.
-.
+See \fBrofi \-h\fP output for the detected monitors, their position, and size\.
 .P
-\fB\-theme\fR \fIfilename\fR
-.
+\fB\-theme\fP \fIfilename\fR
 .P
 Path to the new theme file format\. This overrides the old theme settings\.
-.
 .P
-\fB\-theme\-str\fR \fIstring\fR
-.
+\fB\-theme\-str\fP \fIstring\fR
 .P
 Allow theme parts to be specified on the command line as an override\.
-.
 .P
 For example:
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
-rofi \-theme\-str \'#window { fullscreen: true; }\'
-.
+rofi \-theme\-str '#window { fullscreen: true; }'
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
 This option can be specified multiple times\.
-.
 .P
-\fB\-dpi\fR \fInumber\fR
-.
+\fB\-dpi\fP  \fInumber\fR
 .P
-Override the default DPI setting\. If set to \fB0\fR, it tries to auto\-detect based on X11 screen size (similar to i3 and GTK)\. If set to \fB1\fR, it tries to auto\-detect based on the size of the monitor that rofi is displayed on (similar to latest Qt 5)\.
-.
-.SS "PATTERN setting"
-\fB\-terminal\fR
-.
+Override the default DPI setting\.
+If set to \fB0\fP, it tries to auto\-detect based on X11 screen size (similar to i3 and GTK)\.
+If set to \fB1\fP, it tries to auto\-detect based on the size of the monitor that rofi is displayed on (similar to latest Qt 5)\.
+.SS PATTERN setting
+.P
+\fB\-terminal\fP
 .P
 Specify which terminal to start\.
-.
-.IP "" 4
-.
+.P
+.RS 2
 .nf
-
 rofi \-terminal xterm
-.
 .fi
-.
-.IP "" 0
-.
+.RE
 .P
-Pattern: \fI{terminal}\fR Default: \fIx\-terminal\-emulator\fR
-.
+Pattern: \fI{terminal}\fR
+Default: \fIx\-terminal\-emulator\fR
 .P
-\fB\-ssh\-client\fR \fIclient\fR
-.
+\fB\-ssh\-client\fP \fIclient\fR
 .P
 Override the used ssh client\.
-.
 .P
-Pattern: \fI{ssh\-client}\fR Default: \fIssh\fR
-.
-.SS "SSH settings"
-\fB\-ssh\-command\fR \fIcmd\fR
-.
+Pattern: \fI{ssh\-client}\fR
+Default: \fIssh\fR
+.SS SSH settings
 .P
-Set the command to execute when starting a ssh session\. The pattern \fI{host}\fR is replaced by the selected ssh entry\.
-.
+\fB\-ssh\-command\fP \fIcmd\fR
 .P
-Pattern: \fI{ssh\-client}\fR Default: \fI{terminal} \-e {ssh\-client} {host}\fR
-.
+Set the command to execute when starting a ssh session\.
+The pattern \fI{host}\fR is replaced by the selected ssh entry\.
 .P
-\fB\-parse\-hosts\fR
-.
+Pattern: \fI{ssh\-client}\fR
+Default: \fI{terminal} \-e {ssh\-client} {host}\fR
 .P
-Parse the \fB/etc/hosts\fR file for entries\.
-.
+\fB\-parse\-hosts\fP
+.P
+Parse the \fB/etc/hosts\fP file for entries\.
 .P
 Default: \fIdisabled\fR
-.
 .P
-\fB\-parse\-known\-hosts\fR \fB\-no\-parse\-known\-hosts\fR
-.
+\fB\-parse\-known\-hosts\fP
+\fB\-no\-parse\-known\-hosts\fP
 .P
-Parse the \fB~/\.ssh/known_hosts\fR file for entries\.
-.
+Parse the \fB~/\.ssh/known_hosts\fP file for entries\.
 .P
 Default: \fIenabled\fR
-.
-.SS "Run settings"
-\fB\-run\-command\fR \fIcmd\fR
-.
+.SS Run settings
+.P
+\fB\-run\-command\fP \fIcmd\fR
 .P
-Set command (\fI{cmd}\fR) to execute when running an application\. See \fIPATTERN\fR\.
-.
+Set command (\fI{cmd}\fR) to execute when running an application\.
+See \fIPATTERN\fR\|\.
 .P
 Default: \fI{cmd}\fR
-.
 .P
-\fB\-run\-shell\-command\fR \fIcmd\fR
-.
+\fB\-run\-shell\-command\fP \fIcmd\fR
 .P
-Set command to execute when running an application in a shell\. See \fIPATTERN\fR\.
-.
+Set command to execute when running an application in a shell\.
+See \fIPATTERN\fR\|\.
 .P
 Default: \fI{terminal} \-e {cmd}\fR
-.
 .P
-\fB\-run\-list\-command\fR \fIcmd\fR
-.
+\fB\-run\-list\-command\fP \fIcmd\fR
 .P
-If set, use an external tool to generate list of executable commands\. Uses \fBrun\-command\fR\.
-.
+If set, use an external tool to generate list of executable commands\. Uses \fBrun\-command\fP\|\.
 .P
 Default: \fI{cmd}\fR
-.
-.SS "Window switcher settings"
-\fB\-window\-format\fR \fIformat\fR
-.
+.SS Window switcher settings
+.P
+\fB\-window\-format\fP \fIformat\fR
 .P
 Format what is being displayed for windows\.
-.
 .P
 \fIformat\fR: {field[:len]}
-.
 .P
 \fIfield\fR:
-.
-.IP "\(bu" 4
+.RS 0
+.IP \(bu 2
 \fBw\fR: desktop name
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBt\fR: title of window
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBn\fR: name
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBr\fR: role
-.
-.IP "\(bu" 4
+.IP \(bu 2
 \fBc\fR: class
-.
-.IP "" 0
-.
+
+.RE
+.P
+\fIlen\fR: maximum field length (0 for auto\-size)\. If length and window \fIwidth\fR are negative, field length is \fIwidth \- len\fR\|\.
+if length is positive, the entry will be truncated or padded to fill that length\.
+.P
+default: {w}  {c}   {t}
 .P
-\fIlen\fR: maximum field length (0 for auto\-size)\. If length and window \fIwidth\fR are negative, field length is \fIwidth \- len\fR\. if len