in reply to Re: how POD will look on CPAN
in thread how POD will look on CPAN

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.

Replies are listed 'Best First'.
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 :-))
      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).