-.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 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.
+
+This command was mainly designed as a way to search in the shell
+history, for which it is substantially more efficient than the
+standard readline ^R bidding. The -v option will inject the selected
+line into the tty input buffer, allowing the user to edit the line and
+execute it as a standard command.
+
+Selector is also a good tool to test regexps, or a way to display
+menus. The -x option allows to specify a label delimiter: the part of
+each line before that character will appear during the selection, and
+the part after that character will be returned.
+
+.SH "KEYS"
+
+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.