From 3b68dcdd81394f1ac9f743e1f74ff754f95eef9e Mon Sep 17 00:00:00 2001 From: Junegunn Choi Date: Tue, 10 Jun 2025 00:26:57 +0900 Subject: 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. --- man/man1/fzf.1 | 44 +++++++++++++++++++++++++++++++++++++------- 1 file changed, 37 insertions(+), 7 deletions(-) (limited to 'man') 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 -- cgit v1.2.3