[bug #60061] [long-term] narrow the scope of the groff Texinfo manual

Dave <[email protected]> Sat, 11 Jul 2026 14:16:23 -0400 (EDT)

Newsgroups	gmane.comp.printing.groff.bugs
Message-ID	<[email protected]>

Follow-up Comment #20, bug #60061 (group groff):

Your plan as quoted in comment #19 sounds solid.

The goal being to introduce roff concepts, not to familiarize the user with
every full-service macro packages, I do wonder if four examples of the same
thing are necessary.  Two packages with fairly contrasting syntax--mom and
pretty much any one of the historical ones--ought to get across the concepts
you want to convey.

(You might wonder how I reconcile the above with my complaint in comment #18
that the manual seems to favor one package over the others; the above plan
would single out two packages and omit two others, which you might claim could
still feel like favoritism.  But I believe that showing limited examples,
clearly presented _as_ examples, carries a far different implication than
documenting the entirety of one package but nothing of any of the others.)


    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?60061>

_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/

signature.asc (application/pgp-signature, 228 B)