Date: Fri, 19 Oct 2007 10:07:11 -0700 From: Julian Elischer <julian@elischer.org> To: Ed Schouten <ed@fxq.nl> Cc: FreeBSD Hackers <freebsd-hackers@freebsd.org> Subject: Re: Inner workings of turnstiles and sleepqueues Message-ID: <4718E43F.1020303@elischer.org> In-Reply-To: <20071019045654.GF5411@hoeg.nl> References: <20071016094118.GE5411@hoeg.nl> <200710170916.18788.jhb@freebsd.org> <20071019045654.GF5411@hoeg.nl>
next in thread | previous in thread | raw e-mail | index | archive | help
Ed Schouten wrote: > * John Baldwin <jhb@freebsd.org> wrote: >> The best option right now is to read the code. There are some comments in >> both the headers and implementation. > > Would it be useful to write manpages for these interfaces, or do we > assume that only godlike people can use them anyway? I am willing to > write manpages for them. > > Yours, man pages are ALWAYS a good idea. (well, NEARLY always.) it may be that this information may go well into an exisiting man page, or at least a description. I believe that to some extent they are supposed to be an internal interface so maybe a description as part of the utilities that use them may be in order.. also think about whether a paragraph might go into locking(9). I'm still trying to nag john to run an editing pass over locking(9)
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4718E43F.1020303>