diff options
Diffstat (limited to 'man/man1/fzf.1')
| -rw-r--r-- | man/man1/fzf.1 | 24 |
1 files changed, 16 insertions, 8 deletions
diff --git a/man/man1/fzf.1 b/man/man1/fzf.1 index 2c399a13..96167014 100644 --- a/man/man1/fzf.1 +++ b/man/man1/fzf.1 @@ -21,7 +21,7 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. .. -.TH fzf 1 "Sep 2016" "fzf 0.15.3" "fzf - a command-line fuzzy finder" +.TH fzf 1 "Oct 2016" "fzf 0.15.4" "fzf - a command-line fuzzy finder" .SH NAME fzf - a command-line fuzzy finder @@ -232,11 +232,17 @@ automatically truncated when the number of the lines exceeds the value. .TP .BI "--preview=" "COMMAND" Execute the given command for the current line and display the result on the -preview window. \fB{}\fR is the placeholder for the quoted string of the -current line. +preview window. \fB{}\fR in the command is the placeholder that is replaced to +the single-quoted string of the current line. To transform the replacement +string, specify field index expressions between the braces (See \fBFIELD INDEX +EXPRESSION\fR for the details). Also, \fB{q}\fR is replaced to the current +query string. .RS e.g. \fBfzf --preview="head -$LINES {}"\fR + \fBls -l | fzf --preview="echo user={3} when={-4..-2}; cat {-1}" --header-lines=1\fR + +Note that you can escape a placeholder pattern by prepending a backslash. .RE .TP .BI "--preview-window=" "[POSITION][:SIZE[%]][:hidden]" @@ -358,7 +364,7 @@ with the given string. An anchored-match term is also an exact-match term. .SS Negation If a term is prefixed by \fB!\fR, fzf will exclude the lines that satisfy the -term from the result. +term from the result. In this case, fzf performs exact match by default. .SS Exact-match by default If you don't prefer fuzzy matching and do not wish to "quote" (prefixing with @@ -460,9 +466,11 @@ binding \fBenter\fR key to \fBless\fR command like follows. \fBfzf --bind "enter:execute(less {})"\fR -\fB{}\fR is the placeholder for the quoted string of the current line. -If the command contains parentheses, you can use any of the following -alternative notations to avoid parse errors. +You can use the same placeholder expressions as in \fB--preview\fR. + +If the command contains parentheses, fzf may fail to parse the expression. In +that case, you can use any of the following alternative notations to avoid +parse errors. \fBexecute[...]\fR \fBexecute~...~\fR @@ -481,7 +489,7 @@ alternative notations to avoid parse errors. .RS This is the special form that frees you from parse errors as it does not expect the closing character. The catch is that it should be the last one in the -comma-separated list. +comma-separated list of key-action pairs. .RE \fBexecute-multi(...)\fR is an alternative action that executes the command |