svn commit: r194240 - head/lib/libutil

Bruce Evans brde at optusnet.com.au
Mon Jun 15 22:31:34 UTC 2009


On Mon, 15 Jun 2009, John Baldwin wrote:

> Log:
>  Note that the structures are defined in <sys/user.h> in the text (using
>  language from stat(2)) rather than in the synopsis.
>
>  Requested by:	bde

Thanks.

Copying stat(2) is good.  I also like having single context-sensitive
references in the man page text and no duplication of these references in
the SEE ALSO section.  It is worse than useless to give a general reference
to an enormous man page when you have already described (hopefully
completely) the small part of the man page that applies in context.
user.h and struct kinfo_file are too large to describe completely here,
but there is no man page specifically for them anyway.  I can't find even
a non-specific man page for them (appropos says nothing).  So I would
just use the source for them.

Bruce


More information about the svn-src-head mailing list