gbranden pushed a commit to branch master
in repository groff.
commit f4b0ea5255afae013605296dd392fd23cae02eca
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 10 12:53:40 2026 -0600
eqn(1): Fix style nits.
* Wean ourselves off another overloaded and overused bit of *roff
jargon: "mode". Speak of the format of output instead.
* Favor active voice over passive.
Q: How do you use six syllables to say nothing at all to a *roff user?
A: "Special transparent mode".
---
src/preproc/eqn/eqn.1.man | 30 +++++++++++++++---------------
1 file changed, 15 insertions(+), 15 deletions(-)
diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index de36f4e48..59c41b488 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -1175,7 +1175,7 @@ primitive emboldens an equation by overprinting two
copies of the
equation horizontally offset by this amount
.RB ( 4 ).
.
-In MathML mode,
+When producing MathML output,
components to which
.B \%fat_offset
applies instead use the following.
@@ -1937,7 +1937,7 @@ input is accepted.
.
.
.\" ====================================================================
-.SH "MathML mode limitations"
+.SH "MathML output limitations"
.\" ====================================================================
.
MathML's design assumes that it cannot know the exact physical
@@ -1980,17 +1980,17 @@ as centering on the math axis is the MathML default.
Characters that
.I @g@eqn
sets extra large in
-.I troff \" mode
-mode\[em]notably the integral sign\[em]may appear too small and need to
-have their \[lq]<mstyle>\[rq] wrappers adjusted by hand.
+.I troff \" output format
+output\[em]notably the integral sign\[em]may appear too small
+and need to have their \[lq]<mstyle>\[rq] wrappers adjusted by hand.
.
.
.P
-As in its
-.I troff \" mode
-mode,
+As when producing
+.I troff \" output format
+output,
.I @g@eqn
-in MathML mode leaves the
+generates MathML that leaves the
.B .EQ
and
.B .EN
@@ -2082,14 +2082,14 @@ But there's no changing it now.
.
.
.P
-In
-.I nroff \" mode
-mode,
-lowercase Greek letters are rendered in roman instead of italic style.
+When producing terminal output,
+GNU
+.I eqn \" GNU
+renders lowercase Greek letters in roman instead of italic style.
.
.
.P
-In MathML mode,
+When producing MathML output,
the
.B mark
and
@@ -2102,7 +2102,7 @@ be implemented with \%\[lq]<maligngroup>\[rq] elements.
.
.
.P
-In MathML mode,
+When producing MathML output,
each digit of a numeric literal gets a separate \[lq]<mn>\:</mn>\[rq]
pair,
and decimal points are tagged with \[lq]<mo>\:</mo>\[rq].
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
