Re: .pod files

2012-02-20 Thread Sean M. Burke
On 02/09/2012 04:34 AM, David Cantrell wrote: I doubt you'll ever see a distribution which has POD in both Foo/Bar.pm and Foo/Bar.pod, because the perldoc tool will only see one or the other when a user types 'perldoc Foo::Bar'. +1 ! ...by which I mean that I took this as a given: when Perl

Re: .pod files

2012-02-10 Thread Florent Angly
I doubt you'll ever see a distribution which has POD in both Foo/Bar.pm and Foo/Bar.pod, because the perldoc tool will only see one or the other when a user types 'perldoc Foo::Bar'. Thank you David, this is very useful. My conclusion is that it is not explicitly forbidden, but it is not

.pod files

2012-02-09 Thread Florent Angly
Dear all, I had a look at the perlsyn, perldoc and perldocspec documents but cannot seem to find the answer to the following questions. The POD content of a module can be written into its Perl file or into a separate .pod file. There are quite a few examples of modules around that use one

Re: .pod files

2012-02-09 Thread David Cantrell
case? I doubt you'll ever see a distribution which has POD in both Foo/Bar.pm and Foo/Bar.pod, because the perldoc tool will only see one or the other when a user types 'perldoc Foo::Bar'. Having POD in both .pm and .pod files in a distribution is fairly common, but in that case the .pm file's POD

Re: how to use L in the env with deeply nested .pod files

2002-01-16 Thread Sean M. Burke
At 12:45 2002-01-16 +0800, Stas Bekman wrote: In the new mod_perl documentation we have many .pod files and they are deeply nested. For example: ../docs/2.0/devel/testing/testing.pod ../docs/2.0/devel/benchmarks/benchmarks.pod ../docs/2.0/user/coding/coding.pod ../docs/2.0/user/compat

how to use L in the env with deeply nested .pod files

2002-01-15 Thread Stas Bekman
In the new mod_perl documentation we have many .pod files and they are deeply nested. For example: ../docs/2.0/devel/testing/testing.pod ../docs/2.0/devel/benchmarks/benchmarks.pod ../docs/2.0/user/coding/coding.pod ../docs/2.0/user/compat/compat.pod ../docs/2.0/user/design/design.pod ../docs