[groff] 04/11: groff_man_style(7): Drop prepro interaction stuff.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 8411275677502c5409e2b5eb1ce7ccdeb73017b9
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Apr 13 05:31:53 2022 +1000

    groff_man_style(7): Drop prepro interaction stuff.
    
    The leading FLOSS implementation of man(1), man-db, doesn't bother with
    this and hasn't for a long time[1].  Moreover, it is man(1)'s bailiwick
    to document how this comment line is interpreted--not ours.  Also I
    really don't want to get into questions of whether usage of refer(1),
    grap(1), pic(1), or vgrind(1) in man pages is advisable[2].
    
    [1] 
https://lore.kernel.org/linux-man/20200724121555.e4l2okob3x3fzk5z@localhost.localdomain/
    [2] See, e.g., <https://savannah.gnu.org/bugs/?61014>.
---
 tmac/groff_man.7.man.in | 63 -------------------------------------------------
 1 file changed, 63 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 73e3f6a3..ab296528 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -2188,69 +2188,6 @@ Unix systems
 though even it supports
 .BR \(rs(rg ),
 the above strings should be avoided.
-_endif()dnl
-.
-.
-.\" ====================================================================
-.SS "Interaction with preprocessors"
-.\" ====================================================================
-.
-When a preprocessor like
-.I @g@tbl
-or
-.I @g@eqn
-is needed,
-a hint can be given to the man page librarian by making the first line
-of a man page look like this:
-.
-.
-.P
-.RS
-.BI "\(aq\e\(dq " word
-.\" AT&T: .BI "'\e"" " word
-.\" ...and good luck with that "'".
-.RE
-.
-.
-.P
-The line starts with an apostrophe (\(aq),
-not a dot,
-and a single space character follows the double quote.
-.
-The
-.I word
-consists of one letter for each needed preprocessor:
-\(lqe\(rq for
-.IR @g@eqn ,
-\(lqr\(rq for
-.IR @g@refer ,
-and
-\(lqt\(rq for
-.IR @g@tbl .
-.
-Modern implementations of the
-.I man
-program can use this information to automatically call the required
-preprocessor(s) in the right order.
-.
-.
-.P
-The usual
-.I tbl
-and
-.I eqn
-macros for table and equation inclusion,
-.BR .TS ,
-.BR .T& ,
-.BR .TE ,
-.BR .EQ ,
-and
-.BR .EN ,
-may be used freely.
-.
-Terminal devices are extremely limited in presentation of mathematical
-equations.
-_ifstyle()dnl
 .
 .
 .\" ====================================================================