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
_______________________________________________
svn-src-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-src-all
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Reply via email to