[PATCH 018/100] man/curs_addch.3x: Fix content and style nits.

[G. Branden Robinson]

* Clarify that a character may already carry attributes/color when they
  are dynamically combined with it in a function call.
* Rearrange sentences for clarity.
* Set ACS mapping literals in bold.
* Vary wording.
* Say "cursor" when that's what we mean; the concept has been
  introduced.
* Use em dashes to avoid nested parentheses.
---
 man/curs_addch.3x | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/man/curs_addch.3x b/man/curs_addch.3x
index 5a379d177..1b99b6c98 100644
--- a/man/curs_addch.3x
+++ b/man/curs_addch.3x
@@ -133,16 +133,15 @@ .SS "Adding Characters"
 does not return the character itself,
 but its \fB\%unctrl\fP(3X) representation.
 .PP
-Video attributes can be combined with a character argument passed to
-.B \%waddch
-by logical-ORing them into the character.
-(Thus,
-text,
-including attributes,
-can be copied from one place to another using \fB\%winch\fP(3X) and
+.I ch
+may contain rendering and/or color attributes,
+and others can be combined with the parameter
+by logically \*(``or\*(''ing with it.
+(A character with its attributes can be copied from place to place
+using \fB\%winch\fP(3X) and
 .BR \%waddch .)
 See \fB\%curs_attr\fP(3X) for values of predefined video attribute
-constants that can be usefully OR'ed with characters.
+constants that can be usefully \*(``or\*(''ed with characters.
 .SS "Echoing Characters"
 .B \%echochar
 and
@@ -244,7 +243,6 @@ .SH RETURN VALUE
 .B \%waddch
 with multibyte characters.
 .PP
-If \fB\%scrollok\fP(3X) is not enabled,
 .B \%waddch
 can successfully write a character at the bottom right location of the
 window.
@@ -252,6 +250,7 @@ .SH RETURN VALUE
 .I \%ncurses
 returns
 .B ERR
+if \fB\%scrollok\fP(3X) is not enabled in that event,
 because it is not possible to wrap to a new line.
 .PP
 Functions with a \*(``mv\*('' prefix first perform cursor movement using
@@ -352,7 +351,9 @@ .SS "ACS Symbols"
 .I \%term\%info
 entries include
 .B \%acsc
-strings in which their key characters (pryz{|}) are embedded,
+strings in which their key characters
+.BR ( pryz{|} )
+are embedded,
 and a second-hand list of their character descriptions has come to
 light.
 The
@@ -404,9 +405,8 @@ .SS "Character Set"
 .IR \%ncurses ,
 .I \%chtype
 holds an eight-bit character.
-But
-.I \%ncurses
-allows a multibyte character to be passed in a succession of calls to
+But the library allows a multibyte character to be passed in a
+succession of calls to
 .BR \%waddch .
 Other implementations do not;
 a
@@ -424,12 +424,12 @@ .SS "Character Set"
 When a character is
 .IR complete ,
 .I \%ncurses
-displays the character and advances the window's current location.
+displays the character and advances the cursor.
 .PP
 If the calling application interrupts the succession of bytes in
-a multibyte character sequence by moving the current location
-(for example,
-with \fB\%wmove\fP(3X)),
+a multibyte character sequence by changing the current location\(emfor
+example,
+with \fB\%wmove\fP(3X)\(em\c
 .I \%ncurses
 discards the incomplete character.
 .PP
-- 
2.30.2

signature.asc
Description: PGP signature