Re^3: CPAN-specific POD?

You do know that if you have code in 'Foo.pm', you can put POD in 'Foo.pod', and 'perldoc Foo' fetches the POD from 'Foo.pod' instead of 'Foo.pm', don't you? That means that if you generate the .pm file at compile, you can still ship a complete .pod file.

Comment on Re^3: CPAN-specific POD?

Replies are listed 'Best First'.
Re^4: CPAN-specific POD? by pdltiger (Acolyte) on Feb 03, 2010 at 14:59 UTC
Yes, I was aware of that. It's very handy. But CPAN will look at every file and check if it has any pod; if it detects some it will try to parse the pod and create a link to it from your distribution's page. This is nice because it means you can have POD embedded in your C-code (if you have any) and CPAN will display it for you. This behavior is what I was trying to avoid, but I just realized yesterday that therein lies the key to my solution, which I'll elaborate in a less-indented response. Thanks for your ideas! :)	[reply]

Replies are listed 'Best First'.

Re^4: CPAN-specific POD?
by pdltiger (Acolyte) on Feb 03, 2010 at 14:59 UTC

Yes, I was aware of that. It's very handy. But CPAN will look at every file and check if it has any pod; if it detects some it will try to parse the pod and create a link to it from your distribution's page. This is nice because it means you can have POD embedded in your C-code (if you have any) and CPAN will display it for you. This behavior is what I was trying to avoid, but I just realized yesterday that therein lies the key to my solution, which I'll elaborate in a less-indented response. Thanks for your ideas! :)

[reply]