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

[Robert P. J. Day]

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

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================