Re: how POD will look on CPAN

As AM has hinted, the idea of POD is that it is essentially an implementation neutral documentation markup language - I use pod2html, browsing the generated HTML, whenever I feel the urge to have a look at how it might look...

A user level that continues to overstate my experience :-))

Comment on Re: how POD will look on CPAN

Replies are listed 'Best First'.
Re^2: how POD will look on CPAN by JavaFan (Canon) on Oct 01, 2009 at 09:10 UTC
I only check the original intended target: manual pages. If it looks good in 'pod2man Foo.pm \| nroff -man \| less' on a 80 character window, I'm ready to ship it.	[reply]
Re^3: how POD will look on CPAN by Bloodnok (Vicar) on Oct 01, 2009 at 09:28 UTC
I'd do that too, but pod2html is far less prone to typing error :-D ... and of course, pod2html has the distinct advantage of platform neutrality. A user level that continues to overstate my experience :-))	[reply]
Re^4: how POD will look on CPAN by JavaFan (Canon) on Oct 01, 2009 at 14:37 UTC
Yes, but pod2html won't catch issues where pod2man generates code that cannot be dealt with *roff correctly. Furthermore, I don't want any generated lines to be over 80 characters wide (which can easily happen with (non-formatted) code). Easy to check with pod2man - much harder to check to with pod2html. Plus I don't need a browser that way; I can just do it all from the command line (which is important for me, as $WORK means I code remotely).	[reply]