Bug#94995: PROPOSAL] Clarifying instructions on linking man pages

[Joey Hess <joeyh@debian.org>]

Colin Watson wrote:
> -	  <tt>/usr/share/man</tt>).</p></sect>
> +	  <tt>/usr/share/man</tt>). If you do not create any links
> +	  (whether symlinks, hard links, or .so directives) in the
> +	  filesystem to the alternate names of the manpage, then you
> +	  should not rely on <prgn>man</prgn> finding your manpage
> +	  under those names based solely on the information in the
> +	  manpage's header.
> +	  <footnote>
> +	   <p>
> +	    Supporting this in <prgn>man</prgn> often requires
> +	    unreasonable processing time to find a manual page or to
> +	    report that none exists, and moves knowledge into man's
> +	    database that would be better left in the filesystem.
> +	    This support is therefore deprecated and will cease to be
> +	    present in the future.
> +	   </p>
> +	  </footnote>
> +	</p>
> +      </sect>

I second this proposal.

-- 
see shy jo