Multiple (same) sets of man pages

[Mike Barcroft]

Daniel Eischen <eischen at pcnet1.pcnet.com> writes:
> On Wed, 23 Apr 2003, Mike Barcroft wrote:
> 
> > Daniel Eischen <deischen at freebsd.org> writes:
> > > [ doc@ bcc:'d ]
> > > 
> > > 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.
> > > 
> > > Do we need a different heirarchy for threads?
> > 
> > Ideally, they'd all document the same specification.  Perhaps there
> 
> 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).

I think you could still share the documents and use the LIBRARY
section to document which thread libraries support a given function.

Best regards,
Mike Barcroft