[PATCH 17/40] man/tput.1: Revise (6/10) (Terminal Size).

[G. Branden Robinson]

Content:
* Employ new "pseudo-capability" terminology.

Style:
* Favor quotation marks over italics for informal terminology and
  acronyms.
* Cast bulleted paragraphs as complete sentences.

Markup:
* Favor man(7) font style macros over *roff font selection escape
  sequences, except for man page cross references.
* Protect "@TPUT@" and operand literals from hyphenation.
* Break input lines after commas and around multiword parentheticals.
---
 man/tput.1 | 55 ++++++++++++++++++++++++++++++++++++------------------
 1 file changed, 37 insertions(+), 18 deletions(-)

diff --git a/man/tput.1 b/man/tput.1
index efe5fd47a..2063edf22 100644
--- a/man/tput.1
+++ b/man/tput.1
@@ -288,25 +288,44 @@ .SS Aliases
 Such a link is seldom employed because another program of that name
 is in widespread use.
 .SS "Terminal Size"
-Besides the special commands (e.g., \fBclear\fP),
-@TPUT@ treats certain terminfo capabilities specially:
-\fBlines\fP and \fBcols\fP.
-@TPUT@ calls \fBsetupterm\fP(3X) to obtain the terminal size:
-.bP
-first, it gets the size from the terminal database
-(which generally is not provided for terminal emulators
-which do not have a fixed window size)
-.bP
-then it asks the operating system for the terminal's size
-(which generally works, unless connecting via a serial line which
-does not support \fINAWS\fP: negotiations about window size).
-.bP
-finally, it inspects the environment variables \fILINES\fP and
-\fI\%COLUMNS\fP which may override the terminal size.
+Besides the pseudo-capabilities
+(such as
+.BR init ),
+\fB\%@TPUT@\fP treats the
+.B lines
+and
+.B cols
+.I cap-codes
+specially:
+it may call \fB\%setupterm\fP(3X) to obtain the terminal size.
+.bP
+First,
+\fB\%@TPUT@\fP attempts to obtain these capabilities from the terminal
+database.
+This generally fails for terminal emulators,
+which lack a fixed window size and thus omit the capabilities.
+.bP
+It then asks the operating system for the terminal's size,
+which generally works,
+unless the connection is via a serial line that
+does not support \*(``NAWS\*('': negotiations about window size.
+.bP
+Finally,
+it inspects the environment variables
+.I LINES
+and
+.I \%COLUMNS,
+which may override the terminal size.
 .PP
-If the \fB\-T\fP option is given
-@TPUT@ ignores the environment variables by calling \fBuse_tioctl(TRUE)\fP,
-relying upon the operating system (or finally, the terminal database).
+If the
+.B \-T
+option is given,
+\fB\%@TPUT@\fP ignores the environment variables by calling
+.BR \%use_tioctl(TRUE) ,
+relying upon the operating system
+(or,
+ultimately,
+the terminal database).
 .SH OPTIONS
 .TP
 \fB\-S\fP
-- 
2.30.2

signature.asc
Description: PGP signature