Realized that recent changes deserve a new version number.

[selector.git] / selector.1

diff --git a/selector.1 b/selector.1
index ea0579e..a0a88b4 100644 (file)
--- a/selector.1
+++ b/selector.1
@@ -1,4 +1,4 @@
-.TH "SELECTOR" "1.1.7" "July 2012" "Francois Fleuret" "User Commands"
+.TH "SELECTOR" "1.1.8" "February 2013" "Francois Fleuret" "User Commands"
 
 \" This man page was written by Francois Fleuret <francois@fleuret.org>
 \" and is distributed under a Creative Commons Attribution-Share Alike
@@ -28,25 +28,26 @@ and execute it as a standard command.
 
 Selector is also a handy tool to test regexps, or to display menus
 with many possible choices. For the latter, the -x option allows to
-specify a label delimiter: the part of each line before that character
-will appear during the selection, but only the part after that
-character will be returned.
+show different strings than the ones returned.
 
 Note that because this is an interactive command, the standard input
-can not be used as one of the input files.
+cannot be used as one of the input files.
 
 .SH "USING SELECTOR IN BASH"
 
 The selector command comes with a shell script for bash. If you add
 
-.RS
-.EX
-source bash-selector.sh --hist --cd
-.EE
-.RE
+.P
+.nf
+.B source bash-selector.sh --hist --cd
 
+.fi
 in your \fB~/.bashrc\fR, it will remap M-r to the smart history search,
-and redefine cd so that M-c provides a smart cd history.
+and redefine \fBcd\fR so that M-c provides a smart cd history.
+
+This script relies on readline being configured with the default
+emacs-style key bindings. You may have to hack a bit if you want to
+use it with the vi-style mode.
 
 .SH "KEY BINDINGS"
 
@@ -101,7 +102,7 @@ start in case-sensitive mode
 print a long-line indicator at the end of truncated lines
 .TP
 \fB-y\fR, \fB--show-hits\fR
-highlight the part(s) of each line which match the substrings or regexp
+highlight the part(s) of each line which match(es) the substrings or regexp
 .TP
 \fB-u\fR, \fB--upper-case-makes-case-sensitive\fR
 using an upper case in the matching string makes the matching
@@ -118,6 +119,9 @@ standard setting for bash history search, same as
 
 -b -i -d -v -w -l ${HISTSIZE}
 .TP
+\fB--delete-regexp \fI<regexp>\fR
+deletes in every line the portion matching the regexp
+.TP
 \fB-t \fI<title>\fR, \fB--title \fI<title>\fR
 add a title in the modeline
 .TP
@@ -154,28 +158,24 @@ specify the maximum number of lines to take into account
 
 To use selector to search into your bash history
 
-.RS
-.EX
-selector -q --bash <(history)
-.EE
-.RE
+.P
+.nf
+.B selector -q --bash <(history)
 
+.fi
 To show a list of directories and insert a cd command to the selected
 one
 
-.RS
-.EX
-selector -v -x \(dq\\n\(dq <(find . -type d | awk \(aq{ print $0\(dq\\ncd \(dq$0 }\(aq)
-.EE
-.RE
+.P
+.nf
+.B selector -v -x \(dq\\n\(dq <(find . -type d | awk \(aq{ print $0\(dq\\ncd \(dq$0 }\(aq)
 
-To select a line in a long text and returns the line number
+.fi
+To select a line in a long text and write the line number in /tmp/nb
 
-.RS
-.EX
-selector -v -x \(dq\\n\(dq <(awk < something.txt \(aq{ print $0\(dq\\n\(dqNR }\(aq)
-.EE
-.RE
+.P
+.nf
+.B selector -o /tmp/nb -x \(dq\\n\(dq <(awk < something.txt \(aq{ print $0\(dq\\n\(dqNR }\(aq)
 
 .SH "BUGS"