[PATCH 013/100] man/curs_{in,out}opts.3x: Relocate nl/nonl discussion.

[G. Branden Robinson]

Relocate discussion of `nl()` and `nonl()` as output options from
"PORTABILITY" section of curs_outopts.3x to "HISTORY" section of
curs_inopts.3x, adding a cross reference to the former to aid those with
long memories.
---
 man/curs_inopts.3x  | 14 ++++++++++++++
 man/curs_outopts.3x | 21 +++++++--------------
 2 files changed, 21 insertions(+), 14 deletions(-)

diff --git a/man/curs_inopts.3x b/man/curs_inopts.3x
index ad9e280b3..0ec008db2 100644
--- a/man/curs_inopts.3x
+++ b/man/curs_inopts.3x
@@ -514,6 +514,20 @@ .SH PORTABILITY
 and if a capability's value is the same as a previously-loaded
 key definition,
 the later definition is the one used.
+.SH HISTORY
+From the outset,
+\fI\%ncurses\fP used \fBnl\fP/\fBnonl\fP to control the conversion of
+newlines to carriage return/line-feed on output as well as input.
+XSI Curses documents only the use of these functions for input.
+This difference arose from converting the \fIpcurses\fP source
+(which used \fBioctl\fP calls with the \fBsgttyb\fP structure)
+to termios (i.e., the POSIX terminal interface).
+In the former, both input and output were controlled via a single
+option \fBCRMOD\fP,
+while the latter separates these features.
+Because that conversion interferes with output optimization,
+\fBnl\fP/\fBnonl\fP were amended after \fI\%ncurses\fP 6.2
+to eliminate their effect on output.
 .SH SEE ALSO
 \fB\%curses\fP(3X),
 \fB\%curs_getch\fP(3X),
diff --git a/man/curs_outopts.3x b/man/curs_outopts.3x
index 8f670df9a..a50a53cb9 100644
--- a/man/curs_outopts.3x
+++ b/man/curs_outopts.3x
@@ -169,20 +169,6 @@ .SH NOTES
 .SH PORTABILITY
 These functions are described in the XSI Curses standard, Issue 4.
 .PP
-From the outset,
-\fI\%ncurses\fP used \fBnl\fP/\fBnonl\fP to control the conversion of
-newlines to carriage return/line-feed on output as well as input.
-XSI Curses documents only the use of these functions for input.
-This difference arose from converting the \fIpcurses\fP source
-(which used \fBioctl\fP calls with the \fBsgttyb\fP structure)
-to termios (i.e., the POSIX terminal interface).
-In the former, both input and output were controlled via a single
-option \fBCRMOD\fP,
-while the latter separates these features.
-Because that conversion interferes with output optimization,
-\fBnl\fP/\fBnonl\fP were amended after \fI\%ncurses\fP 6.2
-to eliminate their effect on output.
-.PP
 Some historic curses implementations had, as an undocumented feature, the
 ability to do the equivalent of \fBclearok(..., 1)\fP by saying
 \fBtouchwin(stdscr)\fP or \fBclear(stdscr)\fP.
@@ -199,6 +185,13 @@ .SH PORTABILITY
 made invisible as a side-effect of \fBleaveok\fP.
 SVr4 curses documentation does this, but the code does not.
 Use \fBcurs_set\fP to make the cursor invisible.
+.SH HISTORY
+.I \%ncurses
+formerly treated \fBnl\fP(3X) and \fBnonl\fP(3X) as both input
+.I and
+output options,
+but no longer;
+see \fB\%curs_inopts\fP(3X).
 .SH SEE ALSO
 \fB\%curses\fP(3X),
 \fB\%curs_addch\fP(3X),
-- 
2.30.2

signature.asc
Description: PGP signature