bug-ncurses
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH 27/40] man/curs_attr.3x: Fix excessively wide tables in "DESCRIPT


From: G. Branden Robinson
Subject: [PATCH 27/40] man/curs_attr.3x: Fix excessively wide tables in "DESCRIPTION" section.
Date: Fri, 12 Jan 2024 13:48:41 -0600

Style:
* Drop period from end of non-sentence in table entry.

Markup:
* Refactor table format specification.
  + Use column modifiers to set heading rows in bold instead of
    populating every entry in them with font selection escape sequences.
  + Use a single '_' to indicate a horizontal rule spanning the table.

* Revise table entries; use text blocks to set description entries that
  overrun a line length of 65n.

* Use the same format specification for all of the tables in this
  section of the man page, even the one that had no width problems, for
  visual consistency.

Fixes:
.../man3/attr.3ncurses:253: warning: table wider than line length minus 
indentation
.../man3/attr.3ncurses:396: warning: table wider than line length minus 
indentation
---
 man/curs_attr.3x | 84 ++++++++++++++++++++++++++----------------------
 1 file changed, 45 insertions(+), 39 deletions(-)

diff --git a/man/curs_attr.3x b/man/curs_attr.3x
index daba5c214..17ac9fbad 100644
--- a/man/curs_attr.3x
+++ b/man/curs_attr.3x
@@ -247,23 +247,27 @@ .SS "Video Attributes"
 .ne 15
 .RS
 .TS
-l l
-_ _ _
-l l .
-\fBName\fP     \fBDescription\fP
-\fBA_NORMAL\fP Normal display (no highlight)
-\fBA_STANDOUT\fP       Best highlighting mode of the terminal.
-\fBA_UNDERLINE\fP      Underlining
-\fBA_REVERSE\fP        Reverse video
-\fBA_BLINK\fP  Blinking
-\fBA_DIM\fP    Half bright
-\fBA_BOLD\fP   Extra bright or bold
-\fBA_PROTECT\fP        Protected mode
-\fBA_INVIS\fP  Invisible or blank mode
-\fBA_ALTCHARSET\fP     Alternate character set
-\fBA_ITALIC\fP Italics (non-X/Open extension)
-\fBA_CHARTEXT\fP       Bit-mask to extract a character
-\fBA_COLOR\fP  Bit-mask to extract a color (legacy routines)
+Lb Lb
+Lb Lx.
+Name   Description
+_
+A_NORMAL       Normal display (no highlight)
+A_STANDOUT     T{
+Best highlighting mode of the terminal
+T}
+A_UNDERLINE    Underlining
+A_REVERSE      Reverse video
+A_BLINK        Blinking
+A_DIM  Half bright
+A_BOLD Extra bright or bold
+A_PROTECT      Protected mode
+A_INVIS        Invisible or blank mode
+A_ALTCHARSET   Alternate character set
+A_ITALIC       Italics (non-X/Open extension)
+A_CHARTEXT     Bit-mask to extract a character
+A_COLOR        T{
+Bit-mask to extract a color (legacy routines)
+T}
 .TE
 .RE
 .PP
@@ -272,16 +276,16 @@ .SS "Video Attributes"
 .PP
 .RS
 .TS
-l l
-_ _ _
-l l .
-\fBName\fP     \fBDescription\fP
-\fBWA_HORIZONTAL\fP    Horizontal highlight
-\fBWA_LEFT\fP  Left highlight
-\fBWA_LOW\fP   Low highlight
-\fBWA_RIGHT\fP Right highlight
-\fBWA_TOP\fP   Top highlight
-\fBWA_VERTICAL\fP      Vertical highlight
+Lb Lb
+Lb Lx.
+Name   Description
+_
+WA_HORIZONTAL  Horizontal highlight
+WA_LEFT        Left highlight
+WA_LOW Low highlight
+WA_RIGHT       Right highlight
+WA_TOP Top highlight
+WA_VERTICAL    Vertical highlight
 .TE
 .RE
 .PP
@@ -390,18 +394,20 @@ .SH PORTABILITY
 .RS
 .ne 9
 .TS
-l l
-_ _ _
-l l .
-\fBName\fP     \fBDescription\fP
-\fBWA_NORMAL\fP        Normal display (no highlight)
-\fBWA_STANDOUT\fP      Best highlighting mode of the terminal.
-\fBWA_UNDERLINE\fP     Underlining
-\fBWA_REVERSE\fP       Reverse video
-\fBWA_BLINK\fP Blinking
-\fBWA_DIM\fP   Half bright
-\fBWA_BOLD\fP  Extra bright or bold
-\fBWA_ALTCHARSET\fP    Alternate character set
+Lb Lb
+Lb Lx.
+Name   Description
+_
+WA_NORMAL      Normal display (no highlight)
+WA_STANDOUT    T{
+Best highlighting mode of the terminal
+T}
+WA_UNDERLINE   Underlining
+WA_REVERSE     Reverse video
+WA_BLINK       Blinking
+WA_DIM Half bright
+WA_BOLD        Extra bright or bold
+WA_ALTCHARSET  Alternate character set
 .TE
 .RE
 .PP
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

[Prev in Thread] Current Thread [Next in Thread]