Date: Tue, 16 Jun 2009 08:31:30 +1000 (EST) From: Bruce Evans <brde@optusnet.com.au> To: John Baldwin <jhb@FreeBSD.org> Cc: svn-src-head@FreeBSD.org, svn-src-all@FreeBSD.org, src-committers@FreeBSD.org Subject: Re: svn commit: r194240 - head/lib/libutil Message-ID: <20090616081823.R25597@delplex.bde.org> In-Reply-To: <200906151543.n5FFh08t093646@svn.freebsd.org> References: <200906151543.n5FFh08t093646@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20090616081823.R25597>