From owner-freebsd-current@FreeBSD.ORG Thu Apr 24 09:50:32 2003 Return-Path: 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 6348F37B401; Thu, 24 Apr 2003 09:50:32 -0700 (PDT) Received: from whale.sunbay.crimea.ua (whale.sunbay.crimea.ua [212.110.138.65]) by mx1.FreeBSD.org (Postfix) with ESMTP id D36DD43F93; Thu, 24 Apr 2003 09:50:26 -0700 (PDT) (envelope-from ru@whale.sunbay.crimea.ua) Received: from whale.sunbay.crimea.ua (ru@localhost [127.0.0.1]) h3OGoN62053591 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Thu, 24 Apr 2003 19:50:23 +0300 (EEST) (envelope-from ru@whale.sunbay.crimea.ua) Received: (from ru@localhost) by whale.sunbay.crimea.ua (8.12.9/8.12.8/Submit) id h3OGoLAe053582; Thu, 24 Apr 2003 19:50:21 +0300 (EEST) (envelope-from ru) Date: Thu, 24 Apr 2003 19:50:21 +0300 From: Ruslan Ermilov To: Daniel Eischen Message-ID: <20030424165021.GF52541@sunbay.com> References: <20030423181943.GB52765@sunbay.com> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="c7hkjup166d4FzgN" Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.5.4i 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 24 Apr 2003 16:50:32 -0000 --c7hkjup166d4FzgN Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Wed, Apr 23, 2003 at 02:42:15PM -0400, Daniel Eischen wrote: > On Wed, 23 Apr 2003, Ruslan Ermilov wrote: > > On Wed, Apr 23, 2003 at 02:08:40PM -0400, Daniel Eischen wrote: > > > On Wed, 23 Apr 2003, Mike Barcroft wrote: > > >=20 > > > > Daniel Eischen writes: > > > > > [ doc@ bcc:'d ] > > > > >=20 > > > > > With 3 threading libraries, each with a set of the same man pages, > > > > > how should this be handled? It doesn't make any sense to have > > > > > all of them installed and yet it should still be possible to > > > > > install all 3 thread libraries. > > > > >=20 > > > > > Do we need a different heirarchy for threads? > > > >=20 > > > > Ideally, they'd all document the same specification. Perhaps there > > >=20 > > > 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). > > >=20 > > > > would be one document that discusses the pros and cons of each > > > > implementation with instructions on enabling them. > > >=20 > > > Right, I think an overall 'man threads' should give you that. > > > Eventually, libc_r should be deprecated so placing the common > > > man pages in there doesn't make sense. Of course we can ignore > > > it until we get to that point. > > >=20 > > > I've currently got the man pages commented out of libpthread's > > > Makefile 'cause it doesn't make sense to install them over > > > those installed by libc_r. I'm just raising the issue; I'll > > > do whatever the doc guys recommend. > > >=20 > > Since libpthread and libthr aren't getting built by default, > > this is a minor issue now. If you're about to enable either > > one or both, the one that is not optional (libc_r is optional) > > should get the common manpages. If all libraries are optional, > > either one (most commonly used) could get the manpages, and > > others should have .PATH to them. Another issue is the .Lb > > call in these manpages. They should be fixed to give all three > > libraries. I will have to fix the .Lb macro first to make > > this work. >=20 > OK, for now I'll assume libc_r is not optional and we'll > update the man pages within there. And as wollman suggested, > if there are library-specific man pages, we'll add them to > the common set of man pages and document the differences > from the other libraries. >=20 When I fix the .Lb macro, I will let you know. Cheers, --=20 Ruslan Ermilov Sysadmin and DBA, ru@sunbay.com Sunbay Software AG, ru@FreeBSD.org FreeBSD committer, +380.652.512.251 Simferopol, Ukraine http://www.FreeBSD.org The Power To Serve http://www.oracle.com Enabling The Information Age --c7hkjup166d4FzgN Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+qBXMUkv4P6juNwoRAgsyAJ9SxjxVq9vYLtkIQZkh3kWUOKGxFgCfYgaJ h8jHFmEPfbHwuQxrNtAIx5A= =o3kD -----END PGP SIGNATURE----- --c7hkjup166d4FzgN--