Front page | perl.perl5.porters |
Postings from May 2010
Re: Linking to man pages
Thread Previous
|
Thread Next
From:
karl williamson
Date:
May 2, 2010 20:33
Subject:
Re: Linking to man pages
Message ID:
4BDE4410.6070503@khwilliamson.com
Ævar Arnfjörð Bjarmason wrote:
> On Sun, Apr 25, 2010 at 17:39, karl williamson <public@khwilliamson.com> wrote:
>> some without, like 'printf' or 'printf(3)'. Should these even be in L<>
>> tags? Is there software somewhere that would link these to the real man
>> pages?
>
> Pod::Simple does. See perl5130delta for a (broken) example of this.
> All manpages should be linked with L<foo(num)>.
>
I was looking at the Pod::Checker documentation, and found this:
(section) in ’$page’ deprecated
There is a section detected in the page name of L<...>, e.g.
"L<passwd(2)>". POD hyperlinks may point to POD documents only. Please
write "C<passwd(2)>" instead. Some formatters are able to expand this to
appropriate code. For links to (builtin) functions, please say
"L<perlfunc/mkdir>", without ().
Thread Previous
|
Thread Next