projects
/
selector.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Realized that recent changes deserve a new version number.
[selector.git]
/
selector.1
diff --git
a/selector.1
b/selector.1
index
840360e
..
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
\" 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
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
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
.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,
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"
.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
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
.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
-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
\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
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
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"
.SH "BUGS"