[bug #51072] groff.texi: "Diversions" material from groff_tmac(5) missing

[Dave]

Follow-up Comment #6, bug #51072 (project groff):

[comment #5 comment #5:]
> I have the following already in groff(7), under section "_groff_
> elements".

Oh, good.  I didn't look there, since the ticket focused on info content, but
yes, this seems to make the groff_tmac(5) diversion material wholly
unnecessary.

> Making an analogy like that, I suppose I'm a little more
> sympathetic to Bernd's presentation of diversions.  But not a
> lot, because his analogy is to an unforgiving compiled
> programming language, not to everyday concepts.

Yeah, and even to me, someone familiar with C, the analogy seems an uneasy
fit.  But that aside, the groff documentation shouldn't assume readers know C
programming.

> > Maybe this is also something that can be shunted into a
> > specific examples file,
> 
> I think that's too pessimistic.

"Shunted" may have been a poor word choice; my intent wasn't to treat the
material as a second-class citizen, but to locate it where it's most useful to
users.  But you make a solid case for its inclusion in the info manual.

    _______________________________________________________

Reply to this item at:

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

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