[PATCH 025/177] man/curs_attr.3x: Revise "NOTES" section.

[G. Branden Robinson]

Content:
* Document more functions (most of those introduced by X/Open Curses) as
  possibly being macros.

Style:
* Recast.  Discuss X/Open Curses functions in separate sentence because
  this page could profitably have the modern `attr_t` and `cchar_t`-
  based interfaces hived off into a separate page.

Markup:
* Drop use of `sp` request: not only is it unnecessary after recast, but
  it causes ugly vertical spacing when typesetting.
* 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) and terms in the "NAME" section (because the
  generated edit_man.sh script expects font selection escape sequences
  when scraping terms thence to gather names for man page aliases).
---
 man/curs_attr.3x | 26 ++++++++++++++++++++------
 1 file changed, 20 insertions(+), 6 deletions(-)

diff --git a/man/curs_attr.3x b/man/curs_attr.3x
index 888536de3..fea12b710 100644
--- a/man/curs_attr.3x
+++ b/man/curs_attr.3x
@@ -355,12 +355,26 @@ .SH RETURN VALUE
 is outside the window boundaries.
 .\" ---------------------------------------------------------------------------
 .SH NOTES
-These functions may be macros:
-.sp
-.RS
-\fBattroff\fP, \fBwattroff\fP, \fBattron\fP, \fBwattron\fP,
-\fBattrset\fP, \fBwattrset\fP, \fBstandend\fP and \fBstandout\fP.
-.RE
+.BR \%attron ","
+.BR \%wattron ","
+.BR \%attroff ","
+.BR \%wattroff ","
+.BR \%attrset ","
+.BR \%wattrset ","
+.BR \%standout ","
+and
+.B \%standend
+may be implemented as macros.
+This may also be true of
+.BR \%attr_on ","
+.BR \%attr_off ","
+.BR \%attr_set ","
+.BR \%wattr_set ","
+.BR \%chgat ","
+.BR \%mvchgat ","
+.BR \%mvwchgat ","
+and
+.BR \%color_set "."
 .PP
 Color pair values be logically \*(``or\*(''-ed with attributes
 if the pair number is less than 256.
-- 
2.30.2

signature.asc
Description: PGP signature