Update man page: clarify inline list-border shape requirements

This commit is contained in:
Junegunn Choi
2026-04-19 20:47:31 +09:00
parent 2c459ffdff
commit 12199823ab
+12 -9
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 Draw border around the header section. \fBline\fR style draws a single
separator line between the header window and the list section. \fBinline\fR 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 style embeds the header inside the list border frame, joined to the list
section by a horizontal separator with T-junctions; it requires a section by a horizontal separator; it requires a \fB\-\-list\-border\fR
line-drawing \fB\-\-list\-border\fR (rounded / sharp / bold / double / shape that has both top and bottom segments (rounded / sharp / bold /
horizontal) and falls back to \fBline\fR otherwise. Not compatible with 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\-first\fR, and when \fB\-\-header\-lines\fR is also set
\fB\-\-header\-lines\-border\fR must also be \fBinline\fR. \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 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. a single separator line between the header lines and the list section.
\fBinline\fR style embeds the header lines inside the list border frame \fBinline\fR style embeds the header lines inside the list border frame
with a T-junction separator; it requires a line-drawing with a horizontal separator; it requires a \fB\-\-list\-border\fR shape
\fB\-\-list\-border\fR, falls back to \fBline\fR otherwise, and is not that has both top and bottom segments, falls back to \fBline\fR
compatible with \fB\-\-header\-first\fR. otherwise, and is not compatible with \fB\-\-header\-first\fR.
.SS FOOTER .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] .BI "\-\-footer\-border" [=STYLE]
Draw border around the footer section. \fBline\fR style draws a single Draw border around the footer section. \fBline\fR style draws a single
separator line between the footer and the list section. \fBinline\fR style 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; embeds the footer inside the list border frame with a horizontal separator;
it requires a line-drawing \fB\-\-list\-border\fR and falls back to it requires a \fB\-\-list\-border\fR shape that has both top and bottom
\fBline\fR otherwise. segments and falls back to \fBline\fR otherwise.
.TP .TP
.BI "\-\-footer\-label" [=LABEL] .BI "\-\-footer\-label" [=LABEL]