gbranden pushed a commit to branch master
in repository groff.

commit d1b43ec8f17ec770c559bdb8251aa258b4bf6dd6
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Dec 2 02:53:02 2025 -0600

    [doc,man]: Lean less hard on "transparent" crutch.
    
    "Special" and "transparent" are the most abused words in the troff
    documentary corpus.
    
    Special *how*?  Transparent *to what*?
    
    Relatedly (to my jaundiced eye):
    
    “My latest pet writing peeve: the use of "a kind of" and "a sort of."  I
    don't know when I began noticing this writing tic, in myself and in the
    larger culture, and I don't know how long it has been around.  I'm
    certain I've seen these phrases in writing from as long as a century
    ago, but it's all over the place now.  I associate it with a sort
    of—oops, I did it again!—literary affectation that one sees not only on
    social media but in legacy media as well.  Along the lines of Lionel
    Trilling saying, "Goethe says somewhere...," but in a tweet, a post, or
    a piece.  It evokes a Jamesian spirit of the ineffable, the not quite,
    the almost, that liminal space between the is and the is not.  It's
    meant to suggest a fineness of distinction, I suppose, the subtlety of
    one's antenna.  But it seems like little more than a cover for an
    insufficiency of one's distinctions, a failure of thought, an inability
    to state as fully as possible what one is thinking or trying to think.
    I can't stand it. I'm going to try to stop. Kinda, sorta.”
      -- Corey Robin
---
 doc/groff.texi.in    | 3 ++-
 man/groff_diff.7.man | 3 ++-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index cbb7f2a95..ee7c825a3 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -20118,7 +20118,8 @@ The escape sequences
 @code{\s},
 and
 @code{\S}
-are transparent at the beginning of a line,
+are transparent to control charcter recognition
+at the beginning of a line,
 or after the conditional expression of an
 @code{if}
 or
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index c74d335c7..703432cd5 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6548,7 +6548,8 @@ The escape sequences
 .BR \[rs]s ,
 and
 .B \[rs]S
-are transparent at the beginning of an input line,
+are transparent to control charcter recognition
+at the beginning of an input line,
 or after the conditional expression of an
 .RB \[lq] if \^\[rq]
 or

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to