[bug #55278] src/devices/grotty/grotty.1.man, doc/groff.texi updates

[Dave]

Follow-up Comment #7, bug #55278 (project groff):

I see your point on some of those. The stuff about how spacing isn't preserved
might be worth a mention.

But I think there's value in not overdocumenting what can be easily gleaned by
looking at the output; e.g., the line "<beginning of page>" is essentially
self-documenting.

The output is called an "ASCII approximation," which already communicates that
it won't reflect its input exactly.  And documenting exactly how special
characters are output today means locking in that output forevermore; leaving
them unspecified gives the groff maintainers of 2040 flexibility to change
them if the need arises.  (Hopefully no one is using -a output in production,
minimizing back-compatibility concerns if it changes.  But it strengthens that
position if the only documented result is that that output is an
approximation, with no promises about just how things are approximated.)

    _______________________________________________________

Reply to this item at:

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

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