X-Git-Url: https://fleuret.org/cgi-bin/gitweb/gitweb.cgi?a=blobdiff_plain;f=selector.1;h=8ca04cdebf71cf541c4ddd3bd67af630482baad7;hb=3903830f406226dc447e755a306ef76809d87b8c;hp=903c428696fd241fa1ef9675eaafb36278d1e0f9;hpb=287c4f215525607851ea65c0c5887cabac16b43f;p=selector.git diff --git a/selector.1 b/selector.1 index 903c428..8ca04cd 100644 --- a/selector.1 +++ b/selector.1 @@ -7,7 +7,7 @@ selector - A simple command line utility for dynamic pattern selection .SH "DESCRIPTION" .PP \fBselector\fP is a command line utility for dynamic string -selection. As you type a list of strings separated by ';' or a regexp, +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. @@ -16,28 +16,32 @@ 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. +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. .SH "KEYS" .PP -Keys corresponding to ASCII codes between ' ' and '~' add a character -to the pattern string. The Backspace key, ^H and ^? delete the +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. +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 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" or the Escape +key. -The ^R key switches between the standard multi-substring mode and the -regexp mode, and ^I between the case-sensitive and case-insensitive -modes. +The "^R" key switches between the standard multi-substring mode and +the regexp mode, and "^I" between the case-sensitive and +case-insensitive modes. .SH "OPTIONS" .IP "\fB-h\fP" 10 @@ -45,17 +49,20 @@ display help and exits .IP "\fB-m\fP" 10 force the monochrome mode .IP "\fB-i\fP" 10 -inverse the order of the lines +invert 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 +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 state that all following arguments are filenames .IP "\fB-t