monkdiscuss
Athanasius
<p>Fellow monks,</p>
<p>Let’s say I want to link to the documentation for the <tt>select</tt> method in the [cpan://] module [mod://File::Tail]. This works:</p>
<p>
<c>[href://http://search.cpan.org/~mgrabnar/File-Tail-0.99.3/Tail.pm#select] =></c> [href://http://search.cpan.org/~mgrabnar/File-Tail-0.99.3/Tail.pm#select]
</p>
<p>but it uses <tt>href</tt>, which is for “General-Purpose Linking” (see [id://43037]). I would like to use one of the special “CPAN” links, but this:</p>
<p>
<c>[mod://File::Tail#select] =></c> [mod://File::Tail#select]
</p>
<p>gives a CPAN page displaying <b>Not found</b>. This also fails:</p>
<p>
<c>[mod://IO::Handle#CONSTRUCTOR] =></c> [mod://IO::Handle#CONSTRUCTOR]
</p>
<p>although <tt>IO::Handle</tt> is a core module documented in [doc://|perldoc]. This:</p>
<p>
<c>[doc://IO::Handle#CONSTRUCTOR] =></c> [doc://IO::Handle#CONSTRUCTOR]
</p>
<p>does work, but seems not to be documented in [id://43037], which has, under “The Perl documentation”:</p>
<blockquote>
Link to standard module docs: <tt>[<b>mod:</b>//<i>name</i>]</tt>
</blockquote>
<p>So,</p>
<ol>
<li>What is the canonical way to reference a section internal to a document on CPAN?</li>
<li>Could the <tt>mod</tt> shortcut be extended for this purpose?</li>
<li>Should [id://43037] be updated to show <tt>doc</tt> rather than <tt>mod</tt> as the preferred shortcut for core modules?</li>
</ol>
<p>In regard to (2), I find myself wanting such a shortcut quite often when contributing to [id://479].</p>
<p>Thanks,</p>
<!-- Node text goes above. Div tags should contain sig only -->
<div class="pmsig"><div class="pmsig-968231">
<p>Athanasius <font color=#008000><°(((><</font> <i>contra mundum</i></p>
</div></div>