On Tue, 12 Feb 2002, Michael G Schwern wrote:
> I'm working on the htmlifypods target in MakeMaker and I came upon a
> little problem. Where should HTMLified docs be installed to by
> default? That is, what should the INSTALLHTML*DIR macros be set to?
The intent was that there would be 3 hierarchies of directories:
=item Directories for the perl distribution
=item Directories for site-specific add-on files
=item Directories for vendor-supplied add-on files
Each one would have html1* and html3* directories. See the INSTALL
file for details.
There are currently no defaults because p5p could not collectively agree
on what those defaults should be. Here's the relevant section from
INSTALL:
=item HTML pages
As of perl5.005_57, the standard perl installation does not do
anything with HTML documentation, but that may change in the future.
Further, some add-on modules may wish to install HTML documents. The
html Configure variables listed above are provided if you wish to
specify where such documents should be placed. The default is "none",
but will likely eventually change to something useful based on user
feedback.
My intent was that I would get useful user feedback and set the
defaults accordingly. That didn't happen, however, so neither 5.6.x
nor 5.7.x has those variables. The metaconfig units were all written
years ago, are in the repository, and still should be ready to go, but,
since the relevant variables are never used anywhere, metaconfig
doesn't include them in the generated Configure, and they don't
currently show up in any config.sh.
For MakeMaker, I would think it ought to check for (and honor) the
install*html*dir variables if they exist, but if they don't exist, it
has to fall back on inspired guessing. I couldn't say offhand whether
the current inspired guessing is good, bad, or indifferent as I have
never looked at it.
--
Andy Dougherty [EMAIL PROTECTED]
