hartzell has asked for the wisdom of the Perl Monks concerning the following question:

Is there a standard hook (e.g. htmlifypods) or code fragment for generating html files of a set of perl modules in a standard-ish Makefile.PL setup?

Thanks,

g.

  • Comment on Standard Makefile.PL fragement for running pod2html

Replies are listed 'Best First'.
Re: Standard Makefile.PL fragement for running pod2html
by osunderdog (Deacon) on Feb 17, 2005 at 20:27 UTC

    There's a stand alone program to convert POD to HTML:

    pod2html

    Something like the following added to the Makefile.PL is a start: 

    sub MY::postamble {
    return <<'MAKE_FRAG';
    htmlifypods : pure_all Foo.pm
    pod2html --infile=Foo.pm --outfile=Foo.html
MAKE_FRAG
    }

    [download]

    NOTE: There should be one hard tab before the pod2html command

    UPDATE. Oh, and you run this from the make by saying: 

    make htmlifypods

    [download]
    "Look, Shiny Things!" is not a better business strategy than compatibility and reuse.

[reply]
[d/l]
[select]
Re: Standard Makefile.PL fragement for running pod2html
by dragonchild (Archbishop) on Feb 17, 2005 at 20:19 UTC
    There isn't a way in the standard Makefile.PL setup. You can make "mainfypods", but that makes manpages.

    Being right, does not endow the right to be rude; politeness costs nothing.
    Being unknowing, is not the same as being stupid.
    Expressing a contrary opinion, whether to the individual or the group, is more often a sign of deeper thought than of cantankerous belligerence.
    Do not mistake your goals as the only goals; your opinion as the only opinion; your confidence as correctness. Saying you know better is not the same as explaining you know better.

[reply]

Back to Seekers of Perl Wisdom