From: Francois Fleuret Date: Thu, 12 Mar 2009 18:13:48 +0000 (+0100) Subject: Automatic commit X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=commitdiff_plain;h=31a7b19d2aad15f9804b2377a16d518f54038675;p=selector.git Automatic commit --- diff --git a/selector.1 b/selector.1 new file mode 100644 index 0000000..cc9209a --- /dev/null +++ b/selector.1 @@ -0,0 +1,45 @@ +.TH "SELECTORcg" "1" +.SH "NAME" +selector - A simple shell command 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. + +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. + +.SH "OPTIONS" +.IP "\fB-h\fP" 10 +display help and exits +.IP "\fB-v\fP" 10 +inject the selected line into the tty input buffer +.IP "\fB-t \fP" 10 +select a color them +.IP "\fB-o \fP" 10 +write the selected line into the specified file +.IP "\fB-s \fP" 10 +specify the symbol to separate the substrings in the search pattern +.IP "\fB-l \fP" 10 +specify the maximum number of lines to consider +.IP "\fB-f \fP" 10 +specify the file to search into + +.SH "EXAMPLES" + +To use selector to search into your shell history: + +selector -f ${HISTFILE} -v + +.SH "AUTHOR" +.PP +Written by Francois Fleuret . Permission is +granted to copy, distribute and/or modify this document under the +terms of the GNU GPL.