From owner-cvs-all Mon Jul 8 12:48:16 2002 Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3A06837B401 for ; Mon, 8 Jul 2002 12:48:12 -0700 (PDT) Received: from mail.speakeasy.net (mail13.speakeasy.net [216.254.0.213]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5B56D43E6E for ; Mon, 8 Jul 2002 12:47:21 -0700 (PDT) (envelope-from jhb@FreeBSD.org) Received: (qmail 1675 invoked from network); 8 Jul 2002 19:46:15 -0000 Received: from unknown (HELO server.baldwin.cx) ([216.27.160.63]) (envelope-sender ) by mail13.speakeasy.net (qmail-ldap-1.03) with DES-CBC3-SHA encrypted SMTP for ; 8 Jul 2002 19:46:15 -0000 Received: from laptop.baldwin.cx (gw1.twc.weather.com [216.133.140.1]) by server.baldwin.cx (8.11.6/8.11.6) with ESMTP id g68JkDf05299; Mon, 8 Jul 2002 15:46:14 -0400 (EDT) (envelope-from jhb@FreeBSD.org) Message-ID: X-Mailer: XFMail 1.5.2 on FreeBSD X-Priority: 3 (Normal) Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 8bit MIME-Version: 1.0 In-Reply-To: <200207080751.g687pKwF040678@freefall.freebsd.org> Date: Mon, 08 Jul 2002 15:46:17 -0400 (EDT) From: John Baldwin To: Julian Elischer Subject: RE: cvs commit: src/share/man/man9 thread_exit.9 Cc: cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On 08-Jul-2002 Julian Elischer wrote: > julian 2002/07/08 00:51:20 PDT > > Added files: > share/man/man9 thread_exit.9 > Log: > Add a man page. Style comments welcome. I have a bunch-o-new-pages > to add so I might as we find out what I did wrong now :-) I would just have a single thread.9 manpage much like we have a single ucred.9, kthread.9 (bad name), mutex.9, etc. It makes it easier when you can discuss a subsystem as a whole and then describe each function within that context rather than scattering it across a bunch of different manpages. However, that is a matter of opinion. The new-bus manpages are an example of using one page per function. Personally I find them a bit hard to follow as a result. :-P -- John Baldwin <>< http://www.FreeBSD.org/~jhb/ "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message