Beefy Boxes and Bandwidth Generously Provided by pair Networks
go ahead... be a heretic
 
PerlMonks  

Re: how to stop module::build from building html docs

by rhesa (Vicar)
on Sep 04, 2008 at 10:18 UTC ( [id://708983]=note: print w/replies, xml ) Need Help??


in reply to how to stop module::build from building html docs

I haven't tested this, but I think this is a feature that's configured when you *build* perl.

From the Module::Build documentation:

html
[version 0.26]

This will generate HTML documentation for any binary or library files under blib/ that contain POD. The HTML documentation will only be installed if the install paths can be determined from values in "Config.pm". You can also supply or override install paths on the command line by specifying "install_path" values for the "binhtml" and/or "libhtml" installation targets.

I don't have those paths in my Config.pm, and Module::Build doesn't generate html docs. If you want to turn it off forever, editing Config.pm is probably the quickest and surest way.

Otherwise, have a look at the installdirs and install_paths command line options. Something like

perl Build.PL --install_path binhtml= --install_path libhtml=
might just suppress generating html.

Replies are listed 'Best First'.
Re^2: how to stop module::build from building html docs
by Anonymous Monk on Sep 04, 2008 at 12:42 UTC
    Sadly perl Build.PL --install_path binhtml= --install_path libhtml= didn't work. Thanks
Re^2: how to stop module::build from building html docs
by Intrepid (Deacon) on Jan 23, 2013 at 03:47 UTC

    I've run into this problem myself

    Updated: 2013-01-30 Eastern Standard Time
    Reason: reply by Anonymous monk

    I have no acceptable* solution for preventing Module::Build from building Html from POD in the distribution. I have found, however, a way to prevent it from installing Html files when I issue the ./Build install command.

    Reported based on installed Module::Build v0.38

    Update:

    I'll show the results of trying some other things. Note that there is a null solution here. These flags still do not work.

    Building Module-Runtime
    $ perl Build.PL Checking whether your kit is complete... Looks good Checking prerequisites... Looks good Deleting MYMETA.yml Removed previous 'MYMETA.yml' Deleting MYMETA.json Removed previous 'MYMETA.json' Created MYMETA.yml and MYMETA.json Deleting Build Removed previous script 'Build' Creating new 'Build' script for 'Module-Runtime' version '0.013' $ ./Build fakeinstall Building Module-Runtime Copying lib/Module/Runtime.pm -> blib/lib/Module/Runtime.pm Manifying blib/lib/Module/Runtime.pm -> blib/libdoc/Module.Runtime.3pm Converting Pod to HTML with Pod::Html 1.11 HTMLifying blib/lib/Module/Runtime.pm -> blib/libhtml/site/lib/Module/ +Runtime.html P::H::pod2html --flush --title=Module::Runtime - runtime module handli +ng --podpath=lib/perl5/5.14:bin:lib/perl5/site_perl/5.14 --infile=bli +b/lib/Module/Runtime.pm --outfile=blib/libhtml/site/lib/Module/Runtim +e.tmp --podroot=/usr --htmlroot=../../.. --header --backlink=Back to +Top Installing /usr/local/lib/perl5/Module/Runtime.pm Installing /usr/local/share/man/man3perl/Module.Runtime.3pm Installing /usr/local/html/site/lib/Module/Runtime.html Writing /usr/local/lib/perl5/cygwin-thread-multi-64int/auto/Module/Run +time/.packlist $ printenv PERL_MB_OPT --verbose --install_base=/usr/local --install_path bindoc=/usr/local/s +hare/man/man1 --install_path libdoc=/usr/local/share/man/man3perl --c +onfig installhtmldir= --config installhtml1dir= installhtml3dir= --co +nfig installsitehtml1dir= installsitehtml3dir= $ exit

    Notice the output line:
    Installing /usr/local/html/site/lib/Module/Runtime.html


    * Editing Config.pm is considerably unacceptable where a package manager is managing the perl installation (by upgrading with files created by a package-creation worker somewhere far, far away). As is the case for the vast majority of users of Perl ( /machines where perl is installed/ ) now.

      See How to stop Module::Build from generating html?

      perl Build.PL --config installhtml1dir= installhtml3dir= installman1dir= installman3dir= installsitehtml1dir= installsitehtml3dir= installsiteman1dir= installsiteman3dir= installvendorhtml1dir= installvendorhtml3dir= installvendorman1dir= installvendorman3dir=

      perl Build.PL --config installhtmldir=

      perl -e " $ENV{PERL_MB_OPT}=q{ --config installhtml1dir= installhtml3dir= installman1dir= installman3dir= installsitehtml1dir= installsitehtml3dir= installsiteman1dir= installsiteman3dir= installvendorhtml1dir= installvendorhtml3dir= installvendorman1dir= installvendorman3dir= }; exec $^X, q{Build.PL}; "

      CPANPLUS#buildflags

      untested perl -MConfig_m Build.PL

Log In?
Username:
Password:

What's my password?
Create A New User
Domain Nodelet?
Node Status?
node history
Node Type: note [id://708983]
help
Chatterbox?
and the web crawler heard nothing...

How do I use this?Last hourOther CB clients
Other Users?
Others lurking in the Monastery: (7)
As of 2024-04-16 06:06 GMT
Sections?
Information?
Find Nodes?
Leftovers?
    Voting Booth?

    No recent polls found