On 10/25/17, Ingo Schwarze <[email protected]> wrote:
> it is never useful to
> show how something renders.  Users can easily try for themselves.

I am grateful that the authors of the groff documentation do not
subscribe to this view.  Groff's numerous examples of how input gets
transformed to output have been extremely useful to me.  While it's
certainly possible to try things out for yourself, when you're looking
through the docs to find the right solution to the problem you're
trying to solve, having numerous examples with output saves a lot of
time over having to run a bunch of snippets to see which request or
macro most closely matches what you need.

Reply via email to