diff options
| author | Junegunn Choi <junegunn.c@gmail.com> | 2025-06-10 00:26:57 +0900 |
|---|---|---|
| committer | Junegunn Choi <junegunn.c@gmail.com> | 2025-06-10 23:02:23 +0900 |
| commit | 3b68dcdd81394f1ac9f743e1f74ff754f95eef9e (patch) | |
| tree | e4856fba0fee27eb1ae98ca15844ec04bf60ff5a /man | |
| parent | 39db02616158020b180a56dc8f1bdcf9f8365945 (diff) | |
| download | fzf-3b68dcdd81394f1ac9f743e1f74ff754f95eef9e.tar.gz | |
Add footer
Options:
--footer=STR String to print as footer
--footer-border[=STYLE] Draw border around the footer section
[rounded|sharp|bold|block|thinblock|double|horizontal|vertical|
top|bottom|left|right|line|none] (default: line)
--footer-label=LABEL Label to print on the footer border
--footer-label-pos=COL Position of the footer label
[POSITIVE_INTEGER: columns from left|
NEGATIVE_INTEGER: columns from right][:bottom]
(default: 0 or center)
The default border type for footer is 'line', which draws a single
separator between the footer and the list. It changes its position
depending on `--layout`, so you don't have to manually switch between
'top' and 'bottom'
The 'line' style is now supported by other border types as well.
`--list-border` is the only exception.
Diffstat (limited to 'man')
| -rw-r--r-- | man/man1/fzf.1 | 44 |
1 files changed, 37 insertions, 7 deletions
diff --git a/man/man1/fzf.1 b/man/man1/fzf.1 index c5f13622..834df205 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 "May 2025" "fzf 0.62.0" "fzf - a command-line fuzzy finder" +.TH fzf 1 "Jun 2025" "fzf 0.63.0" "fzf - a command-line fuzzy finder" .SH NAME fzf - a command-line fuzzy finder @@ -503,6 +503,8 @@ Draw border around the finder .br .BR vertical " Vertical lines on each side of the finder" .br +.BR line " Single line border (position automatically determined)" +.br .BR top " (up)" .br .BR bottom " (down)" @@ -518,6 +520,9 @@ If you use a terminal emulator where each box-drawing character takes 2 columns, try setting \fB\-\-ambidouble\fR. If the border is still not properly rendered, set \fB\-\-no\-unicode\fR. +\fBline\fR style draws a single separator line at the top when \fB\-\-height\fR +is used. + .TP .BI "\-\-border\-label" [=LABEL] Label to print on the horizontal border line. Should be used with one of the @@ -661,7 +666,8 @@ Do not display scrollbar. A synonym for \fB\-\-scrollbar=''\fB .TP .BI "\-\-list\-border" [=STYLE] -Draw border around the list section +Draw border around the list section. \fBline\fR style is not supported for +this border. .TP .BI "\-\-list\-label" [=LABEL] @@ -748,7 +754,8 @@ actions are affected: \fBkill\-word\fR .TP .BI "\-\-input\-border" [=STYLE] -Draw border around the input section +Draw border around the input section. \fBline\fR style draws a single separator +line between the input section and the list section. .TP .BI "\-\-input\-label" [=LABEL] @@ -848,8 +855,7 @@ e.g. .TP .BI "\-\-preview\-border" [=STYLE] -Short for \fB\-\-preview\-window=border\-STYLE\fR. In addition to the other -styles, \fBline\fR style is also supported for preview border, which draws +Short for \fB\-\-preview\-window=border\-STYLE\fR. \fBline\fR style draws a single separator line between the preview window and the rest of the interface. @@ -1005,7 +1011,8 @@ Print header before the prompt line. When both normal header and header lines (\fB\-\-header\-lines\fR) are present, this applies only to the normal header. .TP .BI "\-\-header\-border" [=STYLE] -Draw border around the header section +Draw border around the header section. \fBline\fR style draws a single +separator line between the header window and the list section. .TP .BI "\-\-header\-label" [=LABEL] @@ -1019,7 +1026,30 @@ Position of the header label .BI "\-\-header\-lines\-border" [=STYLE] Display header from \fB--header\-lines\fR with a separate border. Pass \fBnone\fR to still separate the header lines but without a border. To combine -two headers, use \fB\-\-no\-header\-lines\-border\fR. +two headers, use \fB\-\-no\-header\-lines\-border\fR. \fBline\fR style draws +a single separator line between the header lines and the list section. + +.SS FOOTER + +.TP +.BI "\-\-footer=" "STR" +The given string will be printed as the sticky footer. The lines are displayed +in the given order from top to bottom regardless of \fB\-\-layout\fR option, and +are not affected by \fB\-\-with\-nth\fR. ANSI color codes are processed even when +\fB\-\-ansi\fR is not set. + +.TP +.BI "\-\-footer\-border" [=STYLE] +Draw border around the header section. \fBline\fR style draws a single +separator line between the footer and the list section. + +.TP +.BI "\-\-footer\-label" [=LABEL] +Label to print on the footer border + +.TP +.BI "\-\-footer\-label\-pos" [=N[:top|bottom]] +Position of the footer label .SS SCRIPTING .TP |
