[PATCH 05/40] man/user_caps.5: Fix too-wide table.

[G. Branden Robinson]

When formatting for an old school Unix man(7) width of 65n (character
cells), a table row is overset.

Recast to shorten.  Offer context before and after table.  Indicate
where the "weird" keycap names come from.  Set "curses" in italics, not
roman.  Set "key names" in roman, not italics.

Fixes:
.../share/man/man5/user_caps.5:372: warning: table wider than line length minus 
indentation
---
 man/user_caps.5 | 47 ++++++++++++++++++++++++++++++++---------------
 1 file changed, 32 insertions(+), 15 deletions(-)

diff --git a/man/user_caps.5 b/man/user_caps.5
index ac4da9f71..0c9f32573 100644
--- a/man/user_caps.5
+++ b/man/user_caps.5
@@ -360,29 +360,46 @@ .SS "Extended Key Definitions"
 Applications can use the \fInaming convention\fP established for \fBxterm\fP
 to find these special keys in the terminal description.
 .PP
-Starting with the curses convention that \fIkey names\fP begin with \*(``k\*(''
-and that shifted special keys are an uppercase name,
-\fI\%ncurses\fP' terminal database defines these names to which a suffix
-is added:
+Starting with the
+.I curses
+convention that capability codes describing the input generated by a
+terminal's key caps begin with \*(``k\*('',
+and that shifted special keys use uppercase letters in their names,
+.IR \%ncurses 's
+terminal database defines the following names and codes to which a
+suffix is added.
 .PP
 .RS 5
 .TS
 tab(/) ;
-l l .
-\fBName\fP/\fBDescription\fP
+Lb Lb
+L  L .
+Code/Description
 _
-kDC/special form of kdch1 (delete character)
-kDN/special form of kcud1 (cursor down)
-kEND/special form of kend (End)
-kHOM/special form of khome (Home)
-kLFT/special form of kcub1 (cursor-left or cursor-back)
-kNXT/special form of knext (Next, or Page-Down)
-kPRV/special form of kprev (Prev, or Page-Up)
-kRIT/special form of kcuf1 (cursor-right, or cursor-forward)
-kUP/special form of kcuu1 (cursor-up)
+kDC/shifted kdch1 (delete character)
+.\" kDC is a standard capability; see X/Open Curses Issue 7, p. 345.
+kDN/shifted kcud1 (cursor down)
+kEND/shifted kend (end)
+kHOM/shifted khome (home)
+kLFT/shifted kcub1 (cursor back)
+kNXT/shifted knext (next)
+kPRV/shifted kprev (previous)
+kRIT/shifted kcuf1 (cursor forward)
+kUP/shifted kcuu1 (cursor up)
 .TE
 .RE
 .PP
+Keycap nomenclature on the Unix systems for which
+.I curses
+was developed differs from today's ubiquitous descendants of the IBM
+PC/AT keyboard layout.
+In the foregoing,
+interpret \*(``backward\*('' as \*(``left\*('',
+\*(``forward\*('' as \*(``right\*('',
+\*(``next\*('' as \*(``page down\*('',
+and
+\*(``prev(ious)\*('' as \*(``page up\*(''.
+.PP
 These are the suffixes used to denote the modifiers:
 .PP
 .RS 5
-- 
2.30.2

signature.asc
Description: PGP signature