Update manpage and AUTHORS

AUTHORS

@@ -1,3 +1,5 @@
+Anton Löfgren
+bendem
 Benjamin Cremer
 Benjamin R. Haskell
 Bruno Braga
@@ -10,6 +12,7 @@ Deiwin Sarjas
 Dimitar Yordanov
 Edwin Pujols
 Eric Engeström
+fice-t
 Gabriel Holodak
 Gareth Poole
 Georgios Bitzes
@@ -23,6 +26,7 @@ Jasper Lievisse Adriaanse
 Klemens Schölhorn
 marduk
 Michael Vetter
+Niklas Haas
 N. Izumi
 Paulo Flabiano Smorigo
 Peter Cannici
@@ -32,11 +36,13 @@ Rasmus Steinke
 Roomcays
 Sebastian Reuße
 Simon Hanna
+Stanislav Seletskiy
 Thomas Adam
 Thorsten Wißmann
 Tilman Blumenbach
 Tobias Kortkamp
 Tom Hinton
+Wieland Hoffmann
 Yaroslav
 seanpringle
 vimeitor

doc/rofi-manpage.markdown

@@ -29,7 +29,6 @@
 [ -show *mode* ]
 [ -modi *mode1,mode2* ]
 [ -eh *element height* ]
-[ -lazy-filter-limit *limit* ]
 [ -e *message*]
 [ -a *row* ]
 [ -u *row* ]
@@ -59,33 +58,38 @@ filter, tokenized search and more.
 
 ## USAGE
 
-**rofi** can be used in two ways, single-shot (runs a mode then exits) or emulating dmenu.
+**rofi** main functionality is to assist in your workflow, allowing you to quickly (with a few keystrokes) switch
+between windows, start applications or log into a remote machine via ssh. There are different modi for different type of
+actions.
 
-### Single-shot mode
+**rofi** can also function as (drop in) replacement for **dmenu(1)**.
+
+### Running rofi
 
 To launch **rofi** directly in a certain mode, specify a mode with `rofi -show <mode>`.
 To show the run dialog:
 
     rofi -show run
 
+
 ### Emulating dmenu
 
-**rofi** can emulate `dmenu` (a dynamic menu for X) when launched with the `-dmenu` flag.
+**rofi** can emulate **dmenu(1)** (a dynamic menu for X) when launched with the `-dmenu` flag.
 
-The official website for `dmenu` can be found [here](http://tools.suckless.org/dmenu/).
+The "official" website for `dmenu` can be found [here](http://tools.suckless.org/dmenu/).
 
-## OPTIONS
+## CONFIGURATION
 
 There are currently three methods of setting configuration options (evaluated in order below):
 
+ * System configuration file (f.e. /etc/rofi.conf).
  * Xresources: A method of storing key values in the Xserver. See
    [here](https://en.wikipedia.org/wiki/X_resources) for more information.
    This is the recommended way of configuring **rofi**.
  * Configuration File: This uses the same format as the Xresources file.
    By default it looks in `XDG_USER_CONFIG_DIR`/rofi/config, but can be overriden on commandline.
-   By default XDG_USER_CONFIG_DIR defaults to `$HOME/.config`.
+   By default XDG_USER_CONFIG_DIR defaults to `$HOME/.config`. (See `rofi -h` for current location).
  * Command-line options: Arguments passed to **rofi**.
- * System configuration file (f.e. /etc/rofi.conf).
 
 The Xresources file expects options starting with `rofi.` followed by it's name. An Example to set the number of lines:
 
@@ -111,7 +115,7 @@ Boolean options have a non-default command-line syntax. Example to enable option
 
     -X
 
-to disable it:
+To disable option X:
 
     -no-X
 
@@ -122,7 +126,7 @@ Below is a list of the most important options:
 `-help`
 
 The help option shows the full list of commandline options and the current set value.
-These include dynamic options.
+These include dynamic (run-time generated) options.
 
 `-dump-xresources`
 
@@ -153,11 +157,9 @@ Or get the options from a script:
 
     ~/my_script.sh | rofi -dmenu
 
-Pressing the `accept-custom` binding (`control-enter` or `shift-enter`) sends the selected entry to STDOUT and moves to the next entry.
-
 `-show` *mode*
 
-Open **rofi** in a certain mode. Available modes are `window`, `run`, `ssh`
+Open **rofi** in a certain mode. Available modes are `window`, `run`,`drun`, `ssh`, `combi`
 To show the run-dialog:
 
     rofi -show run
@@ -182,6 +184,7 @@ Example: Have a mode 'Workspaces' using the `i3_switch_workspaces.sh` script:
 `-case-sensitive`
 
 Start in case sensitive mode.
+This option can be changed at run-time using the `-kb-toggle-case-sensitivity` key binding.
 
 `-cycle`
 
@@ -201,7 +204,7 @@ Select the scrolling method. 0: Per page, 1: continuous.
 
 ### Theming
 
-All colors are either hex #rrggbb values or X11 color names.
+All colors are either hex #rrggbb, #aarrggbb or argb:aarrggbbvalues or X11 color names.
 
 `-bw`
 
@@ -353,15 +356,6 @@ To show sidebar use:
 
     rofi -show run -sidebar-mode -lines 0
 
-`-lazy-filter-limit` *limit*
-
-The number of entries required for **rofi** to go into lazy filter mode.
-In lazy filter mode, it won't re-filter the list on each keypress, but only after **rofi** been
-idle for 250ms. Experiments shows that the default (5000 lines) works well, set to 0 to always
-enable.
-
-Default: *5000*
-
 `-auto-select`
 
 When one entry is left, automatically select it.
@@ -415,6 +409,7 @@ Default: *ssh*
 Set the command to execute when starting a ssh session.
 The pattern *{host}* is replaced by the selected ssh entry.
 
+Pattern: *{ssh-client}*
 Default: *{terminal} -e {ssh-client} {host}*
 
 `-parse-hosts`
@@ -467,7 +462,7 @@ The modi to combine in combi mode.
 For syntax to see `-modi`.
 To get one merge view, of window,run,ssh:
 
-    rofi -show combi -combi-modi "window,run,ssh"
+    rofi -show combi -combi-modi "window,run,ssh" -modi combi
 
 ### History and Sorting
 
@@ -480,6 +475,7 @@ Disable history
 `-no-levenshtein-sort` to disable
 
 When searching sort the result based on levenshtein distance.
+This setting can be changed at runtime, see `-kb-toggle-sort`.
 
 ### Dmenu specific
 
@@ -591,6 +587,10 @@ See [here](https://developer.gnome.org/pango/stable/PangoMarkupFormat.html) for
 
 Allow multiple lines to be selected. Adds a small selection indicator to the left of each entry.
 
+`-sync`
+
+Force rofi mode to first read all data from stdin before showing selection window. This is how original dmenu behaviour.
+
 ### Window Mode
 
 `-window-format` *format*
@@ -608,6 +608,7 @@ Format what is being displayed for windows.
  * **c**: Class
 
 *len*: maximum field length (0 for auto-size). If length negative and window *width* is negative field length is *width - len*.
+if length is positive, the entry will be truncated or padded to fill that length.
 
 
 default: {w}  {c}   {t}
@@ -653,6 +654,8 @@ Default: *enabled*
 
 Disable parsing of configuration. This runs rofi in *stock* mode.
 
+For more information on debugging see the [wiki](https://github.com/DaveDavenport/rofi/wiki/Debugging%20Rofi)
+
 ## PATTERN
 
 To launch commands (e.g. when using the ssh launcher) the user can enter the used command-line,
@@ -662,6 +665,7 @@ the following keys can be used that will be replaced at runtime:
   * `{terminal}`: The configured terminal (See -terminal-emulator)
   * `{ssh-client}`: The configured ssh client (See -ssh-client)
   * `{cmd}`: The command to execute.
+  * `{window}`: The window id of the selected window. (In `window-command`)
 
 ## DMENU REPLACEMENT
 
@@ -672,9 +676,8 @@ This way it can be used as a drop-in replacement for dmenu. just copy or symlink
 
 ## THEMING
 
-With **rofi** 0.15.4 we have a new way of specifying colors, the old settings still apply (for now).
+With **rofi** 0.15.4 we have a new way of specifying theme colors.
-To enable the new setup, set `rofi.color-enabled` to true. The new setup allows you to specify
+The new setup allows you to specify colors per state, similar to **i3**
-colors per state, similar to **i3**
 Currently 3 states exists:
 
   * **normal** Normal row.
@@ -690,7 +693,7 @@ For each state the following 5 colors must be set:
   * **hlbg** Background color selected row
 
 The window background and border color should be specified separate. The key `color-window` contains
-a pair `background,border`.
+a pair `background,border,separator`.
 An example for `Xresources` file:
 
     ! State:           'bg',     'fg',     'bgalt',  'hlbg',   'hlfg'
@@ -698,8 +701,8 @@ An example for `Xresources` file:
     rofi.color-urgent: #fdf6e3,  #dc322f,  #eee8d5,  #dc322f,  #fdf6e3
     rofi.color-active: #fdf6e3,  #268bd2,  #eee8d5,  #268bd2,  #fdf6e3
 
-    !                  'background', 'border'
+    !                  'background', 'border', 'separator'
-    rofi.color-window: #fdf6e3,      #002b36
+    rofi.color-window: #fdf6e3,      #002b36,  #002b36
 
 Same settings can also be specified on command-line:
 
@@ -707,16 +710,30 @@ Same settings can also be specified on command-line:
 
 ## COLORS
 
-Rofi has an experimental mode for a 'nicer' transparency. The idea is to make the
+RGB colors can be specified by either its X11 name, or hexadecimal notation.
-background of the window transparent, leaving the text opaque.
+For example:
-There are 2 requirements for this feature: 1. Your Xserver supports TrueColor, 2. You are running a
+
-composite manager. If this is satisfied you can use the following format for colors:
+    white
+
+Or
+
+    #FFFFFF
+
+ARGB colors are also support, these can be used to create a transparent window if: 1. Your Xserver supports TrueColor, 2.
+You are running a composite manager.
 
     argb:FF444444
 
+Or
+
+    #FF444444
+
 The first two fields specify the alpha level. This determines the amount of transparency.
 (00 everything, FF nothing). The other fields represent the actual color, in hex.
 
+Within **rofi** transparency can be used, e.g. if the selected background color is 50% transparent, the background color
+of the window will be visible through it.
+
 ## KEYBINDINGS
 
 **rofi** has the following key-bindings:
@@ -754,8 +771,9 @@ The first two fields specify the alpha level. This determines the amount of tran
   * `Alt-grave`: Toggle levenshtein sorting.
   * `Alt-Shift-S`: Take a screenshot and store this in the Pictures directory.
 
-To get a full list of keybindings, see `rofi -dump-xresources | grep kb-`.
+To get a full list of keybindings on the commandline, see `rofi -dump-xresources | grep kb-`.
 Keybindings can be modified using the configuration systems.
+To get searchable list of keybindings, run `rofi -show keys`.
 
 A keybinding starting with `!` will act when all keys have been released.
 
@@ -764,24 +782,28 @@ A keybinding starting with `!` will act when all keys have been released.
 ### Window
 
 Show a list of all the windows and allow switching between them.
-Pressing the `delete-entry` binding (`shift-delete`) will kill the window.
+Pressing the `delete-entry` binding (`shift-delete`) will close the window.
 Pressing the `accept-custom` binding (`control-enter` or `shift-enter`) will run a command on the window.
+(See option `window-command` );
 
 ### WindowCD
 
 Shows a list of the windows on the current desktop and allows switching between them.
 Pressing the `delete-entry` binding (`shift-delete`) will kill the window.
 Pressing the `accept-custom` binding (`control-enter` or `shift-enter`) will run a command on the window.
+(See option `window-command` );
 
 ### Run
 
 Shows a list of executables in **$PATH** and can launch them (optional in a terminal).
+Pressing the `delete-entry` binding (`shift-delete`) will remove this entry from the run history.
 Pressing the `accept-custom` binding (`control-enter` or `shift-enter`) will run the command in a terminal.
 
 ### DRun
 
 Same as the **run** launches, but the list is created from the installed desktop files. It automatically launches them
 in a terminal if specified in the Desktop File.
+Pressing the `delete-entry` binding (`shift-delete`) will remove this entry from the run history.
 Pressing the `accept-custom` binding (`control-enter` or `shift-enter`) with custom input (no entry matching) will run the command in a terminal.
 
 ### SSH

doc/rofi.1

@@ -1,21 +1,24 @@
 .\" generated with Ronn/v0.7.3
 .\" http://github.com/rtomayko/ronn/tree/0.7.3
 .
-.TH "ROFI\-MANPAGE" "" "2016-11-30" "" ""
+.TH "ROFI\-MANPAGE" "" "2016-12-14" "" ""
 .
 .SH "NAME"
 \fBrofi\fR \- A window switcher, run launcher, ssh dialog and dmenu replacement
 .
 .SH "SYNOPSIS"
-\fBrofi\fR [ \-width \fIpct_scr\fR ] [ \-lines \fIlines\fR ] [ \-columns \fIcolumns\fR ] [ \-font \fIpangofont\fR ] [ \-terminal \fIterminal\fR ] [ \-location \fIposition\fR ] [ \-fixed\-num\-lines ] [ \-padding \fIpadding\fR ] [ \-display \fIdisplay\fR ] [ \-bw \fIwidth\fR ] [ \-dmenu [ \-p \fIprompt\fR ] [ \-sep \fIseparator\fR ] [ \-l \fIselected line\fR ] [ \-mesg ] [ \-select ] [ \-input \fIinput\fR ] ] [ \-filter \fIfilter\fR ] [ \-ssh\-client \fIclient\fR ] [ \-ssh\-command \fIcommand\fR ] [ \-window\-command \fIcommand\fR ] [ \-disable\-history ] [ \-levenshtein\-sort ] [ \-case\-sensitive ] [ \-cycle ] [ \-show \fImode\fR ] [ \-modi \fImode1,mode2\fR ] [ \-eh \fIelement height\fR ] [ \-lazy\-filter\-limit \fIlimit\fR ] [ \-e \fImessage\fR] [ \-a \fIrow\fR ] [ \-u \fIrow\fR ] [ \-pid \fIpath\fR ] [ \-version ] [ \-help ] [ \-dump\-xresources ] [ \-dump\-xresources\-theme ] [ \-auto\-select ] [ \-parse\-hosts ] [ \-no\-parse\-known\-hosts ] [ \-combi\-modi \fImode1,mode2\fR ] [ \-normal\-window ] [ \-fake\-transparency ] [ \-matching \fImethod\fR ] [ \-tokenize ] [ \-no\-click\-to\-exit ] [ \-threads \fInum\fR ] [ \-config \fIfilename\fR ]
+\fBrofi\fR [ \-width \fIpct_scr\fR ] [ \-lines \fIlines\fR ] [ \-columns \fIcolumns\fR ] [ \-font \fIpangofont\fR ] [ \-terminal \fIterminal\fR ] [ \-location \fIposition\fR ] [ \-fixed\-num\-lines ] [ \-padding \fIpadding\fR ] [ \-display \fIdisplay\fR ] [ \-bw \fIwidth\fR ] [ \-dmenu [ \-p \fIprompt\fR ] [ \-sep \fIseparator\fR ] [ \-l \fIselected line\fR ] [ \-mesg ] [ \-select ] [ \-input \fIinput\fR ] ] [ \-filter \fIfilter\fR ] [ \-ssh\-client \fIclient\fR ] [ \-ssh\-command \fIcommand\fR ] [ \-window\-command \fIcommand\fR ] [ \-disable\-history ] [ \-levenshtein\-sort ] [ \-case\-sensitive ] [ \-cycle ] [ \-show \fImode\fR ] [ \-modi \fImode1,mode2\fR ] [ \-eh \fIelement height\fR ] [ \-e \fImessage\fR] [ \-a \fIrow\fR ] [ \-u \fIrow\fR ] [ \-pid \fIpath\fR ] [ \-version ] [ \-help ] [ \-dump\-xresources ] [ \-dump\-xresources\-theme ] [ \-auto\-select ] [ \-parse\-hosts ] [ \-no\-parse\-known\-hosts ] [ \-combi\-modi \fImode1,mode2\fR ] [ \-normal\-window ] [ \-fake\-transparency ] [ \-matching \fImethod\fR ] [ \-tokenize ] [ \-no\-click\-to\-exit ] [ \-threads \fInum\fR ] [ \-config \fIfilename\fR ]
 .
 .SH "DESCRIPTION"
 \fBrofi\fR is an X11 popup 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 can be used in two ways, single\-shot (runs a mode then exits) or emulating dmenu\.
+\fBrofi\fR main functionality is to assist in your workflow, allowing you to quickly (with a few keystrokes) switch between windows, start applications or log into a remote machine via ssh\. There are different modi for different type of actions\.
 .
-.SS "Single\-shot mode"
+.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
@@ -29,26 +32,26 @@ rofi \-show run
 .IP "" 0
 .
 .SS "Emulating dmenu"
-\fBrofi\fR can emulate \fBdmenu\fR (a dynamic menu for X) when launched with the \fB\-dmenu\fR flag\.
+\fBrofi\fR can emulate \fBdmenu(1)\fR (a dynamic menu for X) when launched with the \fB\-dmenu\fR flag\.
 .
 .P
-The official website for \fBdmenu\fR can be found here \fIhttp://tools\.suckless\.org/dmenu/\fR\.
+The "official" website for \fBdmenu\fR can be found here \fIhttp://tools\.suckless\.org/dmenu/\fR\.
 .
-.SH "OPTIONS"
+.SH "CONFIGURATION"
 There are currently three methods of setting configuration options (evaluated in order below):
 .
 .IP "\(bu" 4
+System configuration file (f\.e\. /etc/rofi\.conf)\.
+.
+.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\. This is the recommended way of configuring \fBrofi\fR\.
 .
 .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 overriden on commandline\.
+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 overriden on commandline\. By default XDG_USER_CONFIG_DIR defaults to \fB$HOME/\.config\fR\. (See \fBrofi \-h\fR for current location)\.
 .
 .IP "\(bu" 4
 Command\-line options: Arguments passed to \fBrofi\fR\.
 .
-.IP "\(bu" 4
-System configuration file (f\.e\. /etc/rofi\.conf)\.
-.
 .IP "" 0
 .
 .P
@@ -121,7 +124,7 @@ Boolean options have a non\-default command\-line syntax\. Example to enable opt
 .IP "" 0
 .
 .P
-to disable it:
+To disable option X:
 .
 .IP "" 4
 .
@@ -140,7 +143,7 @@ Below is a list of the most important options:
 \fB\-help\fR
 .
 .P
-The help option shows the full list of commandline options and the current set value\. These include dynamic options\.
+The help option shows the full list of commandline options and the current set value\. These include dynamic (run\-time generated) options\.
 .
 .P
 \fB\-dump\-xresources\fR
@@ -201,13 +204,10 @@ Or get the options from a script:
 .IP "" 0
 .
 .P
-Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) sends the selected entry to STDOUT and moves to the next entry\.
-.
-.P
 \fB\-show\fR \fImode\fR
 .
 .P
-Open \fBrofi\fR in a certain mode\. Available modes are \fBwindow\fR, \fBrun\fR, \fBssh\fR To show the run\-dialog:
+Open \fBrofi\fR in a certain mode\. Available modes are \fBwindow\fR, \fBrun\fR,\fBdrun\fR, \fBssh\fR, \fBcombi\fR To show the run\-dialog:
 .
 .IP "" 4
 .
@@ -265,7 +265,7 @@ rofi \-modi "window,run,ssh,Workspaces:i3_switch_workspaces\.sh" \-show Workspac
 \fB\-case\-sensitive\fR
 .
 .P
-Start in case sensitive mode\.
+Start in case sensitive mode\. This option can be changed at run\-time using the \fB\-kb\-toggle\-case\-sensitivity\fR key binding\.
 .
 .P
 \fB\-cycle\fR
@@ -292,7 +292,7 @@ Load alternative configuration file\.
 Select the scrolling method\. 0: Per page, 1: continuous\.
 .
 .SS "Theming"
-All colors are either hex #rrggbb values or X11 color names\.
+All colors are either hex #rrggbb, #aarrggbb or argb:aarrggbbvalues or X11 color names\.
 .
 .P
 \fB\-bw\fR
@@ -601,15 +601,6 @@ rofi \-show run \-sidebar\-mode \-lines 0
 .IP "" 0
 .
 .P
-\fB\-lazy\-filter\-limit\fR \fIlimit\fR
-.
-.P
-The number of entries required for \fBrofi\fR to go into lazy filter mode\. In lazy filter mode, it won\'t re\-filter the list on each keypress, but only after \fBrofi\fR been idle for 250ms\. Experiments shows that the default (5000 lines) works well, set to 0 to always enable\.
-.
-.P
-Default: \fI5000\fR
-.
-.P
 \fB\-auto\-select\fR
 .
 .P
@@ -688,7 +679,7 @@ Pattern: \fI{ssh\-client}\fR Default: \fIssh\fR
 Set the command to execute when starting a ssh session\. The pattern \fI{host}\fR is replaced by the selected ssh entry\.
 .
 .P
-Default: \fI{terminal} \-e {ssh\-client} {host}\fR
+Pattern: \fI{ssh\-client}\fR Default: \fI{terminal} \-e {ssh\-client} {host}\fR
 .
 .P
 \fB\-parse\-hosts\fR
@@ -754,7 +745,7 @@ The modi to combine in combi mode\. For syntax to see \fB\-modi\fR\. To get one
 .
 .nf
 
-rofi \-show combi \-combi\-modi "window,run,ssh"
+rofi \-show combi \-combi\-modi "window,run,ssh" \-modi combi
 .
 .fi
 .
@@ -770,7 +761,7 @@ Disable history
 \fB\-levenshtein\-sort\fR to enable \fB\-no\-levenshtein\-sort\fR to disable
 .
 .P
-When searching sort the result based on levenshtein distance\.
+When searching sort the result based on levenshtein distance\. This setting can be changed at runtime, see \fB\-kb\-toggle\-sort\fR\.
 .
 .SS "Dmenu specific"
 \fB\-sep\fR \fIseparator\fR
@@ -942,6 +933,12 @@ Tell \fBrofi\fR that DMenu input is pango markup encoded and should be rendered\
 .P
 Allow multiple lines to be selected\. Adds a small selection indicator to the left of each entry\.
 .
+.P
+\fB\-sync\fR
+.
+.P
+Force rofi mode to first read all data from stdin before showing selection window\. This is how original dmenu behaviour\.
+.
 .SS "Window Mode"
 \fB\-window\-format\fR \fIformat\fR
 .
@@ -972,7 +969,7 @@ Format what is being displayed for windows\.
 .IP "" 0
 .
 .P
-\fIlen\fR: maximum field length (0 for auto\-size)\. If length negative and window \fIwidth\fR is negative field length is \fIwidth \- len\fR\.
+\fIlen\fR: maximum field length (0 for auto\-size)\. If length negative and window \fIwidth\fR is 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}
@@ -1022,6 +1019,9 @@ Default: \fIenabled\fR
 .P
 Disable parsing of configuration\. This runs rofi in \fIstock\fR mode\.
 .
+.P
+For more information on debugging see the wiki \fIhttps://github\.com/DaveDavenport/rofi/wiki/Debugging%20Rofi\fR
+.
 .SH "PATTERN"
 To launch commands (e\.g\. when using the ssh launcher) the user can enter the used command\-line, the following keys can be used that will be replaced at runtime:
 .
@@ -1037,6 +1037,9 @@ To launch commands (e\.g\. when using the ssh launcher) the user can enter the u
 .IP "\(bu" 4
 \fB{cmd}\fR: The command to execute\.
 .
+.IP "\(bu" 4
+\fB{window}\fR: The window id of the selected window\. (In \fBwindow\-command\fR)
+.
 .IP "" 0
 .
 .SH "DMENU REPLACEMENT"
@@ -1053,7 +1056,7 @@ ln \-s /usr/bin/rofi /usr/bin/dmenu
 .IP "" 0
 .
 .SH "THEMING"
-With \fBrofi\fR 0\.15\.4 we have a new way of specifying colors, the old settings still apply (for now)\. To enable the new setup, set \fBrofi\.color\-enabled\fR to true\. The new setup allows you to specify colors per state, similar to \fBi3\fR Currently 3 states exists:
+With \fBrofi\fR 0\.15\.4 we have a new way of specifying theme colors\. The new setup allows you to specify colors per state, similar to \fBi3\fR Currently 3 states exists:
 .
 .IP "\(bu" 4
 \fBnormal\fR Normal row\.
@@ -1087,7 +1090,7 @@ For each state the following 5 colors must be set:
 .IP "" 0
 .
 .P
-The window background and border color should be specified separate\. The key \fBcolor\-window\fR contains a pair \fBbackground,border\fR\. An example for \fBXresources\fR file:
+The window background and border color should be specified separate\. The key \fBcolor\-window\fR contains a pair \fBbackground,border,separator\fR\. An example for \fBXresources\fR file:
 .
 .IP "" 4
 .
@@ -1098,8 +1101,8 @@ rofi\.color\-normal: #fdf6e3,  #002b36,  #eee8d5,  #586e75,  #eee8d5
 rofi\.color\-urgent: #fdf6e3,  #dc322f,  #eee8d5,  #dc322f,  #fdf6e3
 rofi\.color\-active: #fdf6e3,  #268bd2,  #eee8d5,  #268bd2,  #fdf6e3
 
-!                  \'background\', \'border\'
+!                  \'background\', \'border\', \'separator\'
-rofi\.color\-window: #fdf6e3,      #002b36
+rofi\.color\-window: #fdf6e3,      #002b36,  #002b36
 .
 .fi
 .
@@ -1119,7 +1122,33 @@ rofi \-color\-normal "#fdf6e3,#002b36,#eee8d5,#586e75,#eee8d5"
 .IP "" 0
 .
 .SH "COLORS"
-Rofi has an experimental mode for a \'nicer\' transparency\. The idea is to make the background of the window transparent, leaving the text opaque\. There are 2 requirements for this feature: 1\. Your Xserver supports TrueColor, 2\. You are running a composite manager\. If this is satisfied you can use the following format for colors:
+RGB colors can be specified by either its X11 name, or hexadecimal notation\. For example:
+.
+.IP "" 4
+.
+.nf
+
+white
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Or
+.
+.IP "" 4
+.
+.nf
+
+#FFFFFF
+.
+.fi
+.
+.IP "" 0
+.
+.P
+ARGB colors are also support, these can be used to create a transparent window if: 1\. Your Xserver supports TrueColor, 2\. You are running a composite manager\.
 .
 .IP "" 4
 .
@@ -1132,8 +1161,24 @@ argb:FF444444
 .IP "" 0
 .
 .P
+Or
+.
+.IP "" 4
+.
+.nf
+
+#FF444444
+.
+.fi
+.
+.IP "" 0
+.
+.P
 The first two fields specify the alpha level\. This determines the amount of transparency\. (00 everything, FF nothing)\. The other fields represent the actual color, in hex\.
 .
+.P
+Within \fBrofi\fR transparency can be used, e\.g\. if the selected background color is 50% transparent, the background color of the window will be visible through it\.
+.
 .SH "KEYBINDINGS"
 \fBrofi\fR has the following key\-bindings:
 .
@@ -1236,7 +1281,7 @@ The first two fields specify the alpha level\. This determines the amount of tra
 .IP "" 0
 .
 .P
-To get a full list of keybindings, see \fBrofi \-dump\-xresources | grep kb\-\fR\. Keybindings can be modified using the configuration systems\.
+To get a full list of keybindings on the commandline, see \fBrofi \-dump\-xresources | grep kb\-\fR\. Keybindings can be modified using the configuration systems\. To get searchable list of keybindings, run \fBrofi \-show keys\fR\.
 .
 .P
 A keybinding starting with \fB!\fR will act when all keys have been released\.
@@ -1244,16 +1289,16 @@ A keybinding starting with \fB!\fR will act when all keys have been released\.
 .SH "Available Modi"
 .
 .SS "Window"
-Show a list of all the windows and allow switching between them\. Pressing the \fBdelete\-entry\fR binding (\fBshift\-delete\fR) will kill the window\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) will run a command on the window\.
+Show a list of all the windows and allow switching between them\. Pressing the \fBdelete\-entry\fR binding (\fBshift\-delete\fR) will close the window\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) will run a command on the window\. (See option \fBwindow\-command\fR );
 .
 .SS "WindowCD"
-Shows a list of the windows on the current desktop and allows switching between them\. Pressing the \fBdelete\-entry\fR binding (\fBshift\-delete\fR) will kill the window\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) will run a command on the window\.
+Shows a list of the windows on the current desktop and allows switching between them\. Pressing the \fBdelete\-entry\fR binding (\fBshift\-delete\fR) will kill the window\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) will run a command on the window\. (See option \fBwindow\-command\fR );
 .
 .SS "Run"
-Shows a list of executables in \fB$PATH\fR and can launch them (optional in a terminal)\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) will run the command in a terminal\.
+Shows a list of executables in \fB$PATH\fR and can launch them (optional in a terminal)\. Pressing the \fBdelete\-entry\fR binding (\fBshift\-delete\fR) will remove this entry from the run history\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) will run the command in a terminal\.
 .
 .SS "DRun"
-Same as the \fBrun\fR launches, but the list is created from the installed desktop files\. It automatically launches them in a terminal if specified in the Desktop File\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) with custom input (no entry matching) will run the command in a terminal\.
+Same as the \fBrun\fR launches, but the list is created from the installed desktop files\. It automatically launches them in a terminal if specified in the Desktop File\. Pressing the \fBdelete\-entry\fR binding (\fBshift\-delete\fR) will remove this entry from the run history\. Pressing the \fBaccept\-custom\fR binding (\fBcontrol\-enter\fR or \fBshift\-enter\fR) with custom input (no entry matching) will run the command in a terminal\.
 .
 .SS "SSH"
 Shows a list of SSH targets based on your ssh config file, and allows to quickly ssh into them\.