From owner-cvs-all Mon Jul 8 13:20:34 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 E12D037B401; Mon, 8 Jul 2002 13:20:13 -0700 (PDT) Received: from sccrmhc01.attbi.com (sccrmhc01.attbi.com [204.127.202.61]) by mx1.FreeBSD.org (Postfix) with ESMTP id 18AA443E52; Mon, 8 Jul 2002 13:20:13 -0700 (PDT) (envelope-from julian@elischer.org) Received: from InterJet.elischer.org ([12.232.206.8]) by sccrmhc01.attbi.com (InterMail vM.4.01.03.27 201-229-121-127-20010626) with ESMTP id <20020708202012.CUZY29588.sccrmhc01.attbi.com@InterJet.elischer.org>; Mon, 8 Jul 2002 20:20:12 +0000 Received: from localhost (localhost.elischer.org [127.0.0.1]) by InterJet.elischer.org (8.9.1a/8.9.1) with ESMTP id NAA30339; Mon, 8 Jul 2002 13:06:24 -0700 (PDT) Date: Mon, 8 Jul 2002 13:06:22 -0700 (PDT) From: Julian Elischer To: John Baldwin Cc: Julian Elischer , cvs-all@FreeBSD.org, cvs-committers@FreeBSD.org Subject: RE: cvs commit: src/share/man/man9 thread_exit.9 In-Reply-To: Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII 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 The advantage to having one page per function is that teh xref stuff works better, and give thread_exit() in code in front of me, I don't hav eto try guess what it will be under... of course these are rather lame excusses given multiply linked man pages and man -k. On Mon, 8 Jul 2002, John Baldwin wrote: > > 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