Re: Better make(1) man page reference to "PMake - A Tutorial"

[christos%astron.com@localhost (Christos Zoulas)]

In article <20170222162856.GD6808%tuna.imca.aps.anl.gov@localhost>,
J. Lewis Muir <jlmuir%imca-cat.org@localhost> wrote:
>Hello!
>
>The -current make(1) man page says the following in the second paragraph
>of the DESCRIPTION section:
>
>  This manual page is intended as a reference document only.  For a more
>  thorough description of make and makefiles, please refer to PMake - A
>  Tutorial.
>
>It wasn't immediately clear to me which tutorial this referred to.
>Would a patch to change this in the following way be welcome?
>
>  This manual page is intended as a reference document only.  For a more
>  thorough description of make and makefiles, please refer to PMake - A
>- Tutorial.
>+ Tutorial by Adam de Boor.
>
>Also, would a patch to add a note or reference indicating that it exists
>at /usr/share/doc/psd/12.make/tutorial.ms in the following way be
>welcome?
>
>  This manual page is intended as a reference document only.  For a more
>  thorough description of make and makefiles, please refer to PMake - A
>- Tutorial.
>+ Tutorial by Adam de Boor which can be found at
>+ /usr/share/doc/psd/12.make/tutorial.ms.

That does not exist anymore; it is /usr/share/doc/reference/ref1/make/make.*.
What's the precedence for referring to /usr/share/doc from man pages? Should
we index doc so that apropos with some flags also looks at the docs?

christos