Update man page: clarify inline list-border shape requirements

This commit is contained in:
Junegunn Choi
2026-04-19 19:15:10 +09:00
parent 0142fe9d04
commit 6f3e5de150

View File

@@ -1102,9 +1102,12 @@ Print header before the prompt line. When both normal header and header lines
Draw border around the header section. \fBline\fR style draws a single
separator line between the header window and the list section. \fBinline\fR
style embeds the header inside the list border frame, joined to the list
section by a horizontal separator with T-junctions; it requires a
line-drawing \fB\-\-list\-border\fR (rounded / sharp / bold / double /
horizontal) and falls back to \fBline\fR otherwise. Not compatible with
section by a horizontal separator; it requires a \fB\-\-list\-border\fR
shape that has both top and bottom segments (rounded / sharp / bold /
double / block / thinblock / horizontal) and falls back to \fBline\fR
otherwise. When the list border also has side segments, the separator
joins them with T-junctions; \fBhorizontal\fR has no side borders, so the
separator is drawn without T-junction endpoints. Not compatible with
\fB\-\-header\-first\fR, and when \fB\-\-header\-lines\fR is also set
\fB\-\-header\-lines\-border\fR must also be \fBinline\fR.
@@ -1123,9 +1126,9 @@ Display header from \fB--header\-lines\fR with a separate border. Pass
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.
\fBinline\fR style embeds the header lines inside the list border frame
with a T-junction separator; it requires a line-drawing
\fB\-\-list\-border\fR, falls back to \fBline\fR otherwise, and is not
compatible with \fB\-\-header\-first\fR.
with a horizontal separator; it requires a \fB\-\-list\-border\fR shape
that has both top and bottom segments, falls back to \fBline\fR
otherwise, and is not compatible with \fB\-\-header\-first\fR.
.SS FOOTER
@@ -1140,9 +1143,9 @@ are not affected by \fB\-\-with\-nth\fR. ANSI color codes are processed even whe
.BI "\-\-footer\-border" [=STYLE]
Draw border around the footer section. \fBline\fR style draws a single
separator line between the footer and the list section. \fBinline\fR style
embeds the footer inside the list border frame with a T-junction separator;
it requires a line-drawing \fB\-\-list\-border\fR and falls back to
\fBline\fR otherwise.
embeds the footer inside the list border frame with a horizontal separator;
it requires a \fB\-\-list\-border\fR shape that has both top and bottom
segments and falls back to \fBline\fR otherwise.
.TP
.BI "\-\-footer\-label" [=LABEL]