should i have all man pages referenced by *other* man pages?

[sktsee]

On Tue, 29 May 2012 09:34:35 -0400, Robert P. J. Day wrote:

> On Tue, 29 May 2012, sktsee wrote:
> 
>> On Tue, 29 May 2012 08:43:32 -0400, Robert P. J. Day wrote:
>>
>> [snip]
>> >
>> >   ah, suddenly, i have man pages for the pthread mutex locking
>> > primitives, but in the "P" section of the docs:
>> >
>> > PTHREAD_MUTEX_LOCK(P)               POSIX Programmer's Manual
>> >
>> > NAME
>> >        pthread_mutex_lock, pthread_mutex_trylock,
>> >        pthread_mutex_unlock -
>> >        lock and unlock a mutex
>> >
>> > SYNOPSIS
>> >        #include <pthread.h>
>> >
>> >        int pthread_mutex_lock(pthread_mutex_t *mutex);
>> >        int pthread_mutex_trylock(pthread_mutex_t *mutex);
>> >        int pthread_mutex_unlock(pthread_mutex_t *mutex);
>> >        ... snip ...
>> >
>> > but that disagrees with the references at the bottom of "man 7
>> > pthreads":
>> >
>> > "... pthread_mutex_lock(3), pthread_mutex_unlock(3) ..."
>> >
>> > which clearly refers to the wrong section, and also doesn't mention
>> > the "trylock" variation.  oh, dear, what can of worms have i opened
>> > here?
>> >
>> >
>> You also need to install the glibc-doc package.
> 
>   any others i should know about? :-)
> 
> rday

A nice feature of manpages.ubuntu.com is that it displays which package a 
particular manpage originates from. That's how I knew you needed to 
install glibc-doc :)