perl-5.6.1-r10.ebuild thru perl-5.8.0-r9.ebuild (or all currently available ebuilds) install a *ton* of files in /usr/share/doc/perl-5.6.1-r10/html (378 for perl-5.6.1-r10.ebuild) and there's no way to shut it off with USE=-doc. This would be especially nice for those of us on smaller hard drives. ;-) Reproducible: Always Steps to Reproduce: 1. emerge perl 2. ls -lR /usr/share/doc/perl*/html/ Actual Results: lots of html files scroll by Expected Results: for me, since I'm USEing -doc: ls: /usr/share/doc/perl*/html/: No such file or directory Portage 2.0.47-r4 (default-1.0, gcc-2.95.3, glibc-2.2.5-r2,2.2.5-r7) ================================================================= System uname: 2.4.19-gentoo-r7 i586 Pentium MMX GENTOO_MIRRORS="http://csociety-ftp.ecn.purdue.edu/pub/gentoo http://gentoo.oregonstate.edu/ http://www.ibiblio.org/pub/Linux/distributions/gentoo" CONFIG_PROTECT="/etc /var/qmail/control /usr/share/config /usr/kde/2/share/config /usr/kde/3/share/config /usr/X11R6/lib/X11/xkb" CONFIG_PROTECT_MASK="/etc/bash_completion /etc/sound/events /etc/X11/rstart /etc/X11/xdm /etc/pango /etc/gconf /etc/env.d" PORTDIR="/usr/portage" DISTDIR="/usr/portage/distfiles" PKGDIR="/usr/portage/packages" PORTAGE_TMPDIR="/var/tmp" PORTDIR_OVERLAY="/usr/local/portage" USE="x86 oss 3dnow apm avi crypt cups encode jpeg libg++ mikmod mmx mpeg ncurses pdflib qtmt sdl spell truetype xml2 xmms xv berkdb esd gdbm gif gnome gnome-libs gtk guile java libwww oggvorbis opengl pam perl png python readline slang snmp ssl tcpd tetex tiff X -quicktime -svga -motif -nls -imlib -kde -qt -arts gpm mozilla" COMPILER="" CHOST="i586-pc-linux-gnu" CFLAGS="-march=i586 -O3 -pipe" CXXFLAGS="-march=i586 -O3 -pipe" ACCEPT_KEYWORDS="x86" MAKEOPTS="-j2" AUTOCLEAN="yes" SYNC="rsync://rsync.gentoo.org/gentoo-portage" FEATURES="sandbox ccache userpriv"
(1) we will not check for doc USE inside an ebuild because we'd be doing it in just about every single ebuild we have ... yeah, we have over 3000 ebuilds ... (2) doc is for 'extra documentation' ... usually defined as documentation that is generated by extra utilities or something ...
this is under discussion
its under discussion but what the user asked for originally is not
I realize that this discussion is ongoing regarding how to prevent packages from installing documentation globally, however... The documentation Michael mentions in the Perl package is in fact API documentation above and beyond the manual pages. There's a full 13M of html files! It seems to me that this would be an appropriate use of USE=-doc, don't you think?
that question should be brought up with mcummings ;)
Created attachment 10860 [details, diff] patch for perl.ebuild Patch to not install the massive amount of html docs that perl supplies if use doc is not specified.
Conversation seems to have died out on this issue. While I can appreciate SpanKY's comment that there are a lot of ebuilds and checking `use doc` for each one might seem daunting, I think this is a pretty good ebuild to make an exception for since the size of the files in question is pretty compelling, at least for me. Additionally, since I've supplied a patch the total amount of work is pretty close to zero. Oh, I should also note that the patch also takes out 25 seconds of sleeping that is pretty annoying. Frankly, most people are probably not going to sit and watch perl merge to their systems so the sleep simply adds time rather than value to the proceedings. I did leave the sleep 10 in the case of `use threads` as further punishment to those people who choose to merge perl with thread support as that is sure to be just the beginning of the pain.
Fixed in CVS in a silent upgrade to 5.8.0-r10