POD documentation

[Russ Allbery]

Peter Corlett <abuse at cabal.org.uk> writes:
> On Wed, Jul 18, 2007 at 04:38:37PM +0200, Julien ÉLIE wrote:
> [...]
>> * is there a preferred use between (for instance) "B<ctlinnd>" and
>> "ctlinnd(8)" in the middle of a sentence?

> What's wrong with L<ctlinnd> to explicitly indicate it's a man page to the
> POD reader, instead of leaving it to guess?

Because that doesn't include the section (which is required to create a
valid link) and doesn't tell POD that it's a link to a man page as opposed
to some other piece of POD documentation.

L<ctlinnd(8)> is fine, but it should be equivalent to ctlinnd(8) (although
that's somewhat controversial, and I don't mind if people want to add the
L<> for clarity).

-- 
Russ Allbery (rra at stanford.edu)             <http://www.eyrie.org/~eagle/>

    Please send questions to the list rather than mailing me directly.
     <http://www.eyrie.org/~eagle/faqs/questions.html> explains why.