bug-ncurses
[Top][All Lists]
Advanced

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

[PATCH 074/100] man/ncurses.3x: Revise "Padding Differences" subsection.


From: G. Branden Robinson
Subject: [PATCH 074/100] man/ncurses.3x: Revise "Padding Differences" subsection.
Date: Sat, 30 Mar 2024 17:00:09 -0500

Content:
* Refer to terminfo capabilities by name _and_ code; including the
  former is far less cryptic.

Style:
* Tighten wording.
* Set "curses" in italics.
* Favor active voice over passive.
* Prefer term "terminal" to "tty".
* Say "ncurses" instead of "this implementation".

Markup:
* Break input lines after commas and around multi-word parentheticals.
* Favor man(7) font style macros over *roff font selection escape
  sequences, except for man page cross references (because
  man/make_sed.sh recognizes only certain patterns when rewriting such
  cross references).
---
 man/ncurses.3x | 30 +++++++++++++++++++++++-------
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/man/ncurses.3x b/man/ncurses.3x
index 7ff80b265..59bca28aa 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -1961,13 +1961,29 @@ .SS "Error Checking"
 .I curses
 applications.
 .SS "Padding Differences"
-In historic curses versions, delays embedded in the capabilities \fBcr\fP,
-\fBind\fP, \fBcub1\fP, \fBff\fP and \fBtab\fP activated corresponding delay
-bits in the Unix tty driver.
-In this implementation, all padding is done by sending NUL bytes.
-This method is slightly more expensive, but narrows the interface
-to the Unix kernel significantly and increases the package's portability
-correspondingly.
+In historical
+.I curses
+implementations,
+delays embedded in the
+.I \%term\%info
+capabilities
+.B \%carriage_return
+.RB ( cr ),
+.B \%scroll_forward
+.RB ( ind ),
+.B \%cursor_left
+.RB ( cub1 ),
+.B \%form_feed
+.RB ( ff ),
+and
+.B \%tab
+.RB ( ht )
+activated corresponding delay bits in the Unix terminal driver.
+.I \%ncurses
+performs all padding by sending NUL bytes to the device.
+This method is slightly more expensive,
+but narrows the interface to the Unix kernel significantly and
+correspondingly increases the package's portability.
 .SS "Header Files"
 The header file \fI\%curses.h\fP itself includes the header files
 \fI\%stdio.h\fP and \fI\%unctrl.h\fP.
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature


reply via email to

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