Re: [Groff] man pages for macro packages

[Larry Kollar]

Bernd Warken wrote:

[quoting our fearless leader Werner]
> > The ideal solution is to to have man.7, mdoc.7, etc. without any
> > prefix.

This I agree with. Call 'em how you use 'em. As an old *roff'er, I've
tried typing something like  man ms  and not finding what I want because
it's actually groff_ms I was looking for. <grumble/>


> Maybe this could provoke clashes with other concepts.  For example,
> I'm about to write a macro package for the Gutenberg project.
> I wouldn't call the macro's man-page gutenberg.7, because such a
> document should describe the project directly.  Possibly, there will
> be a TeX macro package as well, etc.

Hm. In days of old, when *roff'ers were bold, all the macro packages
started with 'm'. Thus we had man(7), ms(7), etc. Why not stick
with what was once established practice & call the macro manpage
mgutenberg(7)? (Presumably, you would use  groff -mgutenberg yadda
right?) That would leave gutenberg(7) free for describing the project.


> Maybe, groff shouldn't conquer the name space.

And just why not? :-)  Seriously, I think our ancestors (so to speak)
solved this problem for us.

        Larry