X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;f=selector.1;h=81c4aa40214e9da47d4535e32ab8c76221fe0ec8;hb=3a810d0b9e8b805698ee9de88ff34c2c1d13a891;hp=8963977f1b51a09c89c3f302f263b04c243ea468;hpb=1777ff299211ccf4ff4c71113bb92bd65f0e997c;p=selector.git

diff --git a/selector.1 b/selector.1
index 8963977..81c4aa4 100644
--- a/selector.1
+++ b/selector.1
@@ -1,29 +1,32 @@
 .TH "SELECTOR" "1"
 .SH "NAME"
-selector - A simple shell command for dynamic pattern selection
+selector - A simple command line for dynamic pattern selection
 .SH "SYNOPSIS"
 .PP
 \fBselector\fP [\fBoptions\fP] -f <filename>
 .SH "DESCRIPTION"
 .PP
-\fBselector\fP is a simple shell command which provides a dynamic
-string selection. A you type a list of substring separated by ';', the
-display is updated to show only the lines containing all the said
-substrings.
+\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 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 ^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 Delete key, Backspace key, ^D and ^H delete
 one character from the pattern string.
 
-The up and down cursor keys move the selected line accordingly, and
-the PageUp and PageDown move by ten lines. The Home and End key moves
-to the top and the bottom of the list respectively. The return key
-select the current line and quit.
+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.
 
 You can cancel the selection either by interrupting the command with
 ^C or by typing ^G.
@@ -35,8 +38,18 @@ display help and exits
 inject the selected line into the tty input buffer
 .IP "\fB-m\fP" 10
 force the monochrome mode
-.IP "\fB-t <color theme number>\fP" 10
-select a color them
+.IP "\fB-i\fP" 10
+inverse the order of the lines
+.IP "\fB-b\fP" 10
+remove the numeric prefix from bash history
+.IP "\fB-z\fP" 10
+remove the time prefix from zsh history
+.IP "\fB-d\fP" 10
+remove duplicated lines
+.IP "\fB-e\fP" 10
+start with the regexp mode activated
+.IP "\fB-c <fg modeline> <bg modeline> <fg highlight> <bg highlight>\fP" 10
+select the modline and highlight color numbers
 .IP "\fB-o <output filename>\fP" 10
 write the selected line into the specified file
 .IP "\fB-s <pattern separator>\fP" 10
@@ -48,9 +61,13 @@ specify the file to search into
 
 .SH "EXAMPLES"
 
-To use selector to search into your shell history:
+To use selector to search into your bash history, you can use
+
+.B selector -d -i -b -v -f <(history)
+
+.SH "BUGS"
 
-selector -f ${HISTFILE} -v
+Probably many.
 
 .SH "AUTHOR"
 .PP