[groff] 31/44: [doc,man]: Drop stale material.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 8782707aa2087445854bba33d30d7a57fcd3de5d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Sep 3 04:07:40 2024 -0500

    [doc,man]: Drop stale material.
---
 doc/groff.texi.in | 11 +-------
 man/groff.7.man   | 82 -------------------------------------------------------
 2 files changed, 1 insertion(+), 92 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 76fb73e88..5d9076260 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -16616,16 +16616,6 @@ other special characters to Unicode special character 
notation.
 Special characters without a Unicode representation, and escape
 sequences that do not interpolate a sequence of ordinary and/or special
 characters, produce warnings in category @samp{char}.
-
-@kindex use_charnames_in_special
-@cindex @file{DESC} file, and @code{use_charnames_in_special} keyword
-@cindex @code{\X}, and special characters
-If the @code{use_charnames_in_special} directive appears in the output
-device's @file{DESC} file, the use of special character escape sequences
-is @emph{not} an error; they are simply output verbatim (with the
-exception of the seven mapped to Unicode basic Latin characters,
-discussed above).  @code{use_charnames_in_special} is currently employed
-only by @code{grohtml}.
 @endDefesc
 
 GNU @command{troff} also permits the interpolation of macro contents
@@ -19048,6 +19038,7 @@ whose type size is @var{n}@tie{}scaled points.
 Make the font handling module always return unscaled character widths.
 The @code{grohtml} driver uses this directive.
 
+@c XXX: Savannah #63074 is trying to make this obsolescent.
 @item use_charnames_in_special
 @kindex use_charnames_in_special
 GNU @code{troff} should encode special characters inside device control
diff --git a/man/groff.7.man b/man/groff.7.man
index 15f4786d0..cb236c592 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -8115,88 +8115,6 @@ or other postprocessor.
 .
 .
 .P
-Within a device control command,
-the escape sequences
-.BR \[rs]& ,
-.BR \[rs]) ,
-.BR \[rs]% ,
-and
-.B \[rs]:
-are ignored;
-.BI \[rs] space
-and
-.B \[rs]\[ti]
-are converted to single space characters;
-and a self-escaped escape character is output as a backslash
-.BR \[rs] .
-.
-So that the basic Latin subset of the Unicode character set,
-ISO\~646:1991\~IRV (US-ASCII),
-can be reliably encoded in device control commands,
-seven special character escape sequences
-.RB (\[lq] \[rs]\- \[rq],
-.RB \[lq] \[rs][aq] \[rq],
-.RB \[lq] \[rs][dq] \[rq],
-.RB \[lq] \[rs][ga] \[rq],
-.RB \[lq] \[rs][ha] \[rq],
-.RB \[lq] \[rs][rs] \[rq],
-and
-.RB \[lq] \[rs][ti] \[rq])
-are mapped to basic Latin characters;
-see
-.MR groff_char @MAN7EXT@ .
-.
-For this transformation,
-character translations and special character definitions are
-ignored.
-.
-(They are bypassed because these parameters are not rendered as glyphs
-in the output;
-instead,
-they remain abstract characters\[em]in a PDF bookmark or a URL,
-for example.)
-.
-.
-.P
-Escape sequences other than the foregoing in device control command
-may be ignored,
-or produce an error.
-.
-.
-.P
-A device control command issued with the
-.RB \[lq] device \[rq]
-request will not be reflected in the output unless a partially collected
-line exists at least once in the top-level diversion
-(recall section \[lq]Diversions\[rq] above).
-.
-When experimenting with such device controls in minimal documents,
-a
-.B br
-request
-will ensure this to be the case.
-.
-.
-.P
-If the
-.B use_charnames_in_special
-directive appears in the output device's
-.I DESC
-file,
-the use of special character escape sequences is
-.I not
-an error;
-they are simply output verbatim
-(with the exception of the seven mapped to Unicode basic Latin
-characters,
-discussed above).
-.
-.B use_charnames_in_special
-is currently employed only by
-.MR grohtml @MAN1EXT@ .
-.
-.
-.P
 GNU
 .I troff \" GNU
 also permits the interpolation of macro contents as a device control