The ebuild for dev-lang/perl does not use the dohtml command to install HTML pages. This bypasses the logic and code of the dohtml command normally used to install HTML pages as part of an ebuild. For example, my version of dohtml has some "extras" that are skipped by this ebuild. From dev-lang/perl-5.8.6-r4.ebuild: dodir /usr/share/doc/${PF}/html ./perl installhtml \ --podroot='.' \ --podpath='lib:ext:pod:vms' \ --recurse \ --htmldir="${D}/usr/share/doc/${PF}/html" \ --libpods='perlfunc:perlguts:perlvar:perlrun:perlop' It should instead install to a temporary location and then use dohtml to complete the HTML installation using the "normal" ebuild API. Reproducible: Always Steps to Reproduce: 1. 2. 3.
Mass re-assign.
Sorry, but this just adds overhead to the install process, with no real gain. IOW, sorry, but the way perl's html docs are installed is staying as-is. ;)
Err.. whatever happended to "follow the API", specifically the GLEPs. GLEPs are not supposed to be optional. If everyone just ignored them as they please, Gentoo would become pure chaos. If dohtml is broken (too slow for you), then it should be fixed.
gavin, not trying to be a pain (see, didn't close the bug :) but can you paste a patch or something for this? atm, it would seem pod2html would be the quicker and more efficient route. thanks!
Looking at the dohtml code, the main difference is dohtml does the same path installation, but has a couple of modifiers on what exactly gets installed. As this is not configurable by the end user, the question then remains what do you not want installed that dohtml would normally control?
Most missed the point. The GLEP's specify an API, a way of doing things. The vast collection of portage scripts are supposed to conform to a standard. This allows defined extension points amongst other things. Installing HTML pages without using the dohtml script bypasses a defined API mechanism. This breaks any external process that might ever be created using this API point. Using pod2html is fine to *create* the HTML, but the dohtml script should be used in the ebuild to actually install the HTML. There is no performance hit, if things are coded correctly in the ebuild.
This just doesn't make any sense... emake DESTDIR=${D} install which installs docs (instead of using dodoc) also bypasses the "API"? Plus what GLEP are you talking about here anyway?
Closing.
