-.TH "SELECTOR" "1"
+.TH "SELECTOR" 1 "" "Francois Fleuret"
.SH "NAME"
-selector - A simple command line utility for dynamic pattern selection
+selector \- A simple command line utility for dynamic pattern selection
.SH "SYNOPSIS"
.PP
\fBselector\fP [\fBoptions\fP] [<filename1> [<filename2> ...]]
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: Only the
-part of each line before that character will appear during the
-selection, but the full line will be returned.
+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"
.PP
remove duplicated lines (note that you can have two different lines
with the same visible part if you use the -x option)
.IP "\fB-e\fP" 10
-start with the regexp mode activated
+start in the regexp mode
.IP "\fB-a\fP" 10
-make the matching case sensitive
+start in the case-sensitive mode
.IP "\fB-q\fP" 10
make a flash instead of a beep when there is an edition error
.IP "\fB--\fP" 10
specify the symbol to separate the substrings in the search pattern
.IP "\fB-x <label separator>\fP" 10
specify the symbol to separate what to show to the user during the
-selection from the rest of the line
+selection from the line to return
.IP "\fB-l <max number of lines>\fP" 10
specify the maximum number of lines to take into account
.IP "\fB-f <input filename>\fP" 10
To use selector to search into your bash history, you can use
-.B selector -q -b -i -d -v -w -l 10000 <(history)
+.B selector -q -b -i -d -v -w -l ${HISTSIZE} <(history)
.SH "KEY-BINDING IN BASH"
associate it to M-r (that is, the "Alt" and "r" key pressed together),
just add something like
-bind '"\\C-[r":"\\C-a\\C-kselector -q -b -i -d -v -w -l 10000 <(history)\\C-m"'
+bind '"\\C-[r":"\\C-a\\C-kselector -q -b -i -d -v -w -l ${HISTSIZE} <(history)\\C-m"'
in your ~/.bashrc.