-.PP
-\fBselector\fP is a command line dynamic string selection. As you type
-a list of strings separated by ';' or a regexp, the display is updated
-in real time to show only the lines containing all the said strings,
-or matching the regexp.
-
-The ^R key switches between the standard multi-substring mode and the
-regexp mode.
-
-The main usage of selector is as an efficient search in the shell
-command history. With the correct option, it will inject the selected
-line into the virtual tty input buffer, hence allowing the user to
-edit the line and execute it as a standard command.
-
-Keys corresponding to ASCII codes between ' ' and '~' add a character
-to the pattern string. The Backspace key, ^H and ^? delete a character
-on the left of cursor, while Delete key and ^D delete a character on
-the right of the cursor.
-
-The Up and Down cursor keys move the selected line accordingly, and
-PageUp and PageDown move by ten lines. The Home and End key move to
-the top and the bottom of the list respectively. The return key
-selects the current line and exits.
-
-The shortcuts ^A, ^E, ^U, and ^K do somehow what they do in readline,
-and you can cancel the selection by either interrupting the command
-with ^C or by typing ^G.
+
+\fBselector\fP is a command line utility for interactive real-time
+pattern matching. It reads the content of the specified files, and as
+the user types a list of strings separated by ";" (or a regexp), the
+display is updated in real time to show only the lines containing all
+the said strings (or matching the regexp).
+
+This command was mainly designed as a way to search efficiently in the
+shell history, for which it is substantially better than the standard
+readline ^R binding. With the -v option, it injects the selected line
+into the tty input buffer, hence allowing the user to edit the line
+and execute it as a standard command.
+
+Selector is also a handy tool to test regexps, or to display menus
+with many possible choices. For the latter, the -x option allows to
+show different strings than the ones returned.
+
+Note that because this is an interactive command, the standard input
+can not be used as one of the input files.
+
+.SH "USING SELECTOR IN BASH"
+
+The selector command comes with a shell script for bash. If you add
+
+.P
+.nf
+.B source bash-selector.sh --hist --cd
+
+.fi
+in your \fB~/.bashrc\fR, it will remap M-r to the smart history search,
+and redefine \fBcd\fR so that M-c provides a smart cd history.
+
+This script relies on readline being configured with the default
+emacs-style key bindings. You may have to hack a bit if you want to
+use it with the vi-style mode.
+
+.SH "KEY BINDINGS"
+
+Keys corresponding to ASCII codes between " " and "~" add a character
+to the pattern string. The Backspace key, "^H" and "^?" delete the
+character immediately on the left of the cursor, while the Delete key
+and "^D" delete the character at cursor location.
+
+The Left and Right cursor keys move the editing cursor
+accordingly. The Up and Down cursor keys move the selected line one
+entry at a time, and PageUp and PageDown move it by ten entries. The
+Home and End key move to the top and the bottom of the list
+respectively. The return key selects the current line and exits.
+
+The keys "^A", "^E", "^U", and "^K" do somehow what they do in
+readline, and you can exit selector without doing anything by either
+interrupting the command with "^C" or by typing "^G" or the Escape
+key.
+
+The key "^R" switches between the multi-substring and the regexp
+selection mode, and "^I" between the case-sensitive and
+case-insensitive modes.