Re: [Module::Build] PROPOSAL: M::B should install HTML documentation

[Michael G S. <sc...@po...>]

On Wed, Oct 15, 2003 at 10:39:12AM -0500, Chris Dolan wrote:
> On Wednesday, October 15, 2003, at 06:12  AM, <kev...@ub...> 
> wrote:
> >I would love to see M::B support building HTML documentation.
> 
> 
> I have built a module to do exactly that.  It is not yet published to 
> CPAN, but here's the documentation.  The main work left to do is to 
> tweak some of the defaults and to get a Pod::Html regression bug fixed 
> (doesn't handle nested =item tags right, grr...)

A few things to note:

5.8.1 finally included Config options for HTML installation directories.
So look for $Config{install*html*dir} (installhtml1dir, installhtml3dir,
installsitehtml1dir, etc...) and if they're set, Module::Build should
install HTML docs by default.

I would avoid passing Pod::Html specific flags into Module::Build.  Have
a plan ready to map them in case Pod::Html is replaced.  The names of
the Pod::Html arguments are fairly generic, so its sort of moot.  Just keep 
your upgrade path open in case one of the future POD->HTML modules on CPAN 
matures.


-- 
Michael G Schwern        sc...@po...  http://www.pobox.com/~schwern/
Kindly do not attempt to cloud the issue with facts.