From owner-freebsd-current@FreeBSD.ORG  Wed Apr 23 11:28:39 2003
Return-Path: <owner-freebsd-current@FreeBSD.ORG>
Delivered-To: freebsd-current@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id DFE0F37B401
	for <current@freebsd.org>; Wed, 23 Apr 2003 11:28:38 -0700 (PDT)
Received: from khavrinen.lcs.mit.edu (khavrinen.lcs.mit.edu [18.24.4.193])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0722B43FAF
	for <current@freebsd.org>; Wed, 23 Apr 2003 11:28:38 -0700 (PDT)
	(envelope-from wollman@khavrinen.lcs.mit.edu)
Received: from khavrinen.lcs.mit.edu (localhost [IPv6:::1])
	by khavrinen.lcs.mit.edu (8.12.9/8.12.9) with ESMTP id h3NISamA074644
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
	Wed, 23 Apr 2003 14:28:36 -0400 (EDT)
	(envelope-from wollman@khavrinen.lcs.mit.edu)
Received: (from wollman@localhost)
	by khavrinen.lcs.mit.edu (8.12.9/8.12.9/Submit) id h3NISZh4074641;
	Wed, 23 Apr 2003 14:28:35 -0400 (EDT)
	(envelope-from wollman)
Date: Wed, 23 Apr 2003 14:28:35 -0400 (EDT)
From: Garrett Wollman <wollman@lcs.mit.edu>
Message-Id: <200304231828.h3NISZh4074641@khavrinen.lcs.mit.edu>
To: Daniel Eischen <eischen@pcnet1.pcnet.com>
In-Reply-To: <Pine.GSO.4.10.10304231351310.1203-100000@pcnet1.pcnet.com>
References: <20030423133153.A35731@espresso.bsdmike.org>
	<Pine.GSO.4.10.10304231351310.1203-100000@pcnet1.pcnet.com>
cc: current@freebsd.org
Subject: Re: Multiple (same) sets of man pages
X-BeenThere: freebsd-current@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Discussions about the use of FreeBSD-current
	<freebsd-current.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-current>
List-Post: <mailto:freebsd-current@freebsd.org>
List-Help: <mailto:freebsd-current-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-current>,
	<mailto:freebsd-current-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 23 Apr 2003 18:28:39 -0000

<<On Wed, 23 Apr 2003 14:08:40 -0400 (EDT), Daniel Eischen <eischen@pcnet1.pcnet.com> said:

> Right, but there may be extensions in some that aren't in the
> others.  So those would be library-specific man pages.  Like
> pthread_switch_{add,delete}_np() that I believe is only supported
> in libc_r.  I have no plans on supporting it in libpthread
> since it really doesn't make sense there.  There will also be
> other functions available in libpthread that aren't in libc_r
> (and perhaps libthr).

Not a doc person, nor a threads person, but I would suggest that there
should be a single set of manual pages, and for each interface which
differs, the appropriate manual page itself should set out the
differences among the libraries.

-GAWollman