cvs commit: src/share/examples/mdoc example.4

Ruslan Ermilov ru at FreeBSD.org
Wed Sep 27 05:49:59 PDT 2006


On Wed, Sep 27, 2006 at 04:54:17AM -0400, Tom Rhodes wrote:
[...]
> > That's wrong.  Getting rid of "the" works.
> 
> I like "enable" in the first bit, and I'll agree "the" should
> go, even though your argument works in some cases but fails
> in others.
> 
I think a common sense should apply here -- i.e., make less
work for manpage writers?  What most of our section four
manpages document?  Drivers or subsystems?  I think drivers.
This is an example manpage, it's not a full skeleton manpage.
To be a full skeleton manpage, some other words can be put
into comments, like is already done for the .Dd argument.


Cheers,
-- 
Ruslan Ermilov
ru at FreeBSD.org
FreeBSD committer
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-all/attachments/20060927/66506e2e/attachment.pgp


More information about the cvs-all mailing list