-The main usage of selector is as a super shell-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.
+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.
+
+Selector is also a good tool to test regexps.
+
+.SH "KEYS"
+.PP
+
+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 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 exit selector without doing anything by either
+interrupting the command with ^C or by typing ^G.
+
+The ^R key switches between the standard multi-substring mode and the
+regexp mode, and ^I between the case-sensitive and case-insensitive
+modes.