Re: [Groff] refer question

[Werner LEMBERG]

> I think, if there's a problem with refer, it's the documentation.
> There's very little of it other than the manpage, and the manpage is
> a pure example of what can be both good and bad about manpages: it
> contains all the information you need, but in a form so terse you
> have to know the program before you can make sense of it.  Example:
> 
>    Macro interface
>        Each  reference  starts  with  a call to the macro ]-.
> 
> The manpage doesn't say you have to create ]- yourself, which,
> though self-explanatory once you grasp how refer works, would make
> the grasping of it faster.

Since I don't use refer actually, I would be glad if you can provide
patches so that the man page becomes better.


     Werner