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

[sktsee]

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.

BTW, Ubuntu provides man page documentation online at manpages.ubuntu.com.

-- 
sktsee