[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH 023/100] man/ncurses.3x: Recast initial part of "DESCRIPTION" sec
From: |
G. Branden Robinson |
Subject: |
[PATCH 023/100] man/ncurses.3x: Recast initial part of "DESCRIPTION" section. |
Date: |
Sat, 30 Mar 2024 16:50:41 -0500 |
Style:
* Vary wording.
* Fix grammar nit.
Markup:
* Favor man(7) font style macros over *roff font selection escape
sequences.
---
man/ncurses.3x | 40 +++++++++++++++++++++++++++-------------
1 file changed, 27 insertions(+), 13 deletions(-)
diff --git a/man/ncurses.3x b/man/ncurses.3x
index f121212bf..84f81053b 100644
--- a/man/ncurses.3x
+++ b/man/ncurses.3x
@@ -100,30 +100,44 @@ .SH DESCRIPTION
.I curses
library of SVr4 and provides numerous useful extensions.
.PP
-\fI\%ncurses\fP man pages employ several sections to clarify matters of
-usage and interoperability with other \fIcurses\fP implementations.
+.I \%ncurses
+man pages employ several sections to clarify matters of usage and
+interoperability with other
+.I curses
+implementations.
.bP
-\*(``NOTES\*('' describes matters and caveats of which any user of the
-\fI\%ncurses\fP API should be aware,
+\*(``NOTES\*('' describes issues and caveats of which any user of the
+.I \%ncurses
+API should be aware,
such as limitations on the size of an underlying integral type or the
availability of a preprocessor macro exclusive of a function definition
(which prevents its address from being taken).
This section also describes implementation details that will be
significant to the programmer but which are not standardized.
.bP
-\*(``EXTENSIONS\*('' presents \fI\%ncurses\fP innovations beyond the
-X/Open Curses standard and/or the SVr4 \fIcurses\fP implementation.
-They are termed \fIextensions\fP to indicate that they cannot be
-implemented solely by using the library API, but require access to the
-library's internal state.
+\*(``EXTENSIONS\*('' presents
+.I \%ncurses
+innovations beyond the X/Open Curses standard and/or the SVr4
+.I curses
+implementation.
+They are termed
+.I extensions
+to indicate that they cannot be implemented solely by using the library
+API,
+but require access to the library's internal state.
.bP
\*(``PORTABILITY\*('' discusses matters
(beyond the exercise of extensions)
-that should be considered when writing to a \fIcurses\fP standard,
-or to multiple implementations.
+that should be considered when writing to a
+.I curses
+standard,
+or for multiple implementations.
.bP
-\*(``HISTORY\*('' examines points of detail in \fI\%ncurses\fP and other
-\fIcurses\fP implementations over the decades of their development,
+\*(``HISTORY\*('' examines points of detail in
+.I \%ncurses
+and other
+.I curses
+implementations over the decades of their development,
particularly where precedent or inertia have frustrated better design
(and,
in a few cases,
--
2.30.2
signature.asc
Description: PGP signature
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [PATCH 023/100] man/ncurses.3x: Recast initial part of "DESCRIPTION" section.,
G. Branden Robinson <=