Thanks to Thomas Dickey for the pointer.
---
 man/curs_outopts.3x | 22 +++++++++++++++++-----
 1 file changed, 17 insertions(+), 5 deletions(-)

diff --git a/man/curs_outopts.3x b/man/curs_outopts.3x
index 606312619..ca5daff93 100644
--- a/man/curs_outopts.3x
+++ b/man/curs_outopts.3x
@@ -117,10 +117,6 @@ .SS idcok
 possessing them according to the
 .I \%term\%info
 database.
-.\" TODO: What's the historical rationale for the `idcok()` feature?
-.\" TED: Solaris SVr4 source uses this to bypass some logic which may not work
-.\" with terminals that use "magic cookies" (cells where the video attribute
-.\" changes and no actual character is stored).
 .SS idlok
 Setting
 .IR win 's
@@ -289,7 +285,23 @@ .SH NOTES
 .B \%wsetscrreg
 to configure the scrolling region of a selected window.
 .PP
-The
+Historically,
+applications used
+.B \%idcok(FALSE)
+to accommodate the \*(``magic cookie\*('' feature
+of some terminal types;
+see subsection \*(``Highlighting, Underlining, and Visible Bells\*(''
+of \fB\%terminfo\fP(5).
+When updating a line,
+the presence of character cells with magic cookies in them
+made the
+.I curses
+library's computations of characters to be rewritten inaccurate.
+A better solution is to indicate the
+.B \%magic_cookie_glitch
+.RB ( xmc )
+capability in the terminal's type description.
+.PP
 .B \%immedok
 routine is useful for windows that are used as terminal
 emulators.
-- 
2.30.2

Attachment: signature.asc
Description: PGP signature

Reply via email to