X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;f=selector.1;h=c1762c1b882036efa473996d96a8defcd6691073;hb=8201e54e05a255cbf71951e6519a482111b6441e;hp=8963977f1b51a09c89c3f302f263b04c243ea468;hpb=1777ff299211ccf4ff4c71113bb92bd65f0e997c;p=selector.git diff --git a/selector.1 b/selector.1 index 8963977..c1762c1 100644 --- a/selector.1 +++ b/selector.1 @@ -1,29 +1,28 @@ .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 .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 ';', the display is updated in real +time to show only the lines containing all the said strings. -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. 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 +34,16 @@ 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 \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-r\fP" 10 +remove duplicated lines +.IP "\fB-c \fP" 10 +select the modline and highlight color numbers .IP "\fB-o \fP" 10 write the selected line into the specified file .IP "\fB-s \fP" 10 @@ -48,9 +55,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 -selector -f ${HISTFILE} -v +.B selector -r -i -b -v -f <(history) + +.SH "BUGS" + +Probably many. .SH "AUTHOR" .PP