diff options
author | Junegunn Choi <junegunn.c@gmail.com> | 2020-10-09 19:53:51 +0900 |
---|---|---|
committer | Junegunn Choi <junegunn.c@gmail.com> | 2020-10-09 19:53:51 +0900 |
commit | d9752a4c21ba8a98e26dcf2199f22581d3946dfa (patch) | |
tree | fc37e3e8e5cfe82b0f7e248966f91e51e7e3e335 /man | |
parent | dba14d26303297322dc4426d38ebfbf1d76a6011 (diff) |
Reset preview window flags that are not style-related
Fix #2203
Diffstat (limited to 'man')
-rw-r--r-- | man/man1/fzf.1 | 37 |
1 files changed, 26 insertions, 11 deletions
diff --git a/man/man1/fzf.1 b/man/man1/fzf.1 index cfa4adb6..22171be3 100644 --- a/man/man1/fzf.1 +++ b/man/man1/fzf.1 @@ -381,11 +381,21 @@ Preview window will be updated even when there is no match for the current query if any of the placeholder expressions evaluates to a non-empty string. .RE .TP -.BI "--preview-window=" "[POSITION][:SIZE[%]][:rounded|sharp|noborder][:wrap][:hidden][:+SCROLL[-OFFSET]]" -Determines the layout of the preview window. If the argument contains +.BI "--preview-window=" "[POSITION][:SIZE[%]][:rounded|sharp|noborder][:wrap][:cycle][:hidden][:+SCROLL[-OFFSET]]" + +.RS +.B POSITION: (default: right) + \fBup + \fBdown + \fBleft + \fBright +.RE + +\fRDetermines the layout of the preview window. If the argument contains \fB:hidden\fR, the preview window will be hidden by default until \fBtoggle-preview\fR action is triggered. Long lines are truncated by default. -Line wrap can be enabled with \fB:wrap\fR flag. +Line wrap can be enabled with \fB:wrap\fR flag. Cyclic scrolling is enabled +with \fB:cycle\fR flag. If size is given as 0, preview window will not be visible, but fzf will still execute the command in the background. @@ -402,14 +412,6 @@ be given as a numeric integer (\fB-INTEGER\fR), or as a denominator form (\fB-/INTEGER\fR) for specifying a fraction of the preview window height. .RS -.B POSITION: (default: right) - \fBup - \fBdown - \fBleft - \fBright -.RE - -.RS e.g. \fB# Non-default scroll window positions and sizes fzf --preview="head {}" --preview-window=up:30% @@ -427,6 +429,19 @@ e.g. --preview-window +{2}-/2\fR .RE + +You can write style-related flags across multiple \fB--preview-window\fR +options. But flags that are not style-related such as \fBhidden\fR and scroll +offset are only allowed in the last \fB--preview-window\fR. + +.RS +e.g. + export FZF_DEFAULT_OPTS='--preview-window sharp:cycle' + + # sharp + cycle + up + 50% + fzf --preview-window 'up' --preview-window '50%' --preview 'bat {}' +.RE + .SS Scripting .TP .BI "-q, --query=" "STR" |