If USE="man" when emerging gentoo-sources-2.6.13-r3, then all sorts of errors are output by "make mandoc" and no documentation is installed. e.g. >>> Source unpacked. * Making manpages ... HOSTCC scripts/basic/fixdep HOSTCC scripts/basic/split-include HOSTCC scripts/basic/docproc ... DOCPROC Documentation/DocBook/kernel-api.xml Warning(/var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/kernel/sched.c:1495): No description found for parameter 'rq' Use of uninitialized value in join or string at /var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/scripts/kernel-doc line 369, <IN> line 698. Warning(/var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/mm/slab.c:2793): No description found for parameter 'unused' ... etc. ... Warning(/var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/drivers/video/macmodes.c): no structured comments found make[1]: *** [Documentation/DocBook/kernel-api.xml] Error 1 make: *** [mandocs] Error 2 >>> Test phase [not enabled]: sys-kernel/gentoo-sources-2.6.13-r3 >>> Install gentoo-sources-2.6.13-r3 into /var/tmp/portage/gentoo-sources-2.6.13-r3/image/ category sys-kernel >>> Copying sources ... sed: can't read scripts/makeman: No such file or directory * Installing manpages ... DOCPROC Documentation/DocBook/kernel-api.xml Warning(/var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/kernel/sched.c:1495): No description found for parameter 'rq' Use of uninitialized value in join or string at /var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/scripts/kernel-doc line 369, <IN> line 698. Warning(/var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/mm/slab.c:2793): No description found for parameter 'unused' Warning(/var/tmp/portage/gentoo-sources-2.6.13-r3/work/linux-2.6.13-gentoo-r3/drivers/video/macmodes.c): no structured comments found make[1]: *** [Documentation/DocBook/kernel-api.xml] Error 1 make: *** [installmandocs] Error 2 [ !! ] sed: can't read scripts/makeman: No such file or directory man: Is there some other package needed to install 2.6.13's man documentation which isn't listed as a dependancy? emerge info: Portage 2.0.51.22-r3 (default-linux/x86/2005.0, gcc-3.3.6, glibc-2.3.5-r2, 2.6.12-gentoo-r10 i686) ================================================================= System uname: 2.6.12-gentoo-r10 i686 Intel(R) Pentium(R) M processor 1700MHz Gentoo Base System version 1.6.13 distcc 2.18.3 i686-pc-linux-gnu (protocols 1 and 2) (default port 3632) [disabled] dev-lang/python: 2.3.5-r2 sys-apps/sandbox: 1.2.12 sys-devel/autoconf: 2.13, 2.59-r6 sys-devel/automake: 1.4_p6, 1.5, 1.6.3, 1.7.9-r1, 1.8.5-r3, 1.9.6-r1 sys-devel/binutils: 2.15.92.0.2-r10 sys-devel/libtool: 1.5.18-r1 virtual/os-headers: 2.6.11-r2 ACCEPT_KEYWORDS="x86" AUTOCLEAN="yes" CBUILD="i686-pc-linux-gnu" CFLAGS="-O2 -march=pentium3 -mmmx -msse -msse2 -mfpmath=sse -fomit-frame-pointer -fprefetch-loop-arrays -pipe" CHOST="i686-pc-linux-gnu" CONFIG_PROTECT="/etc /opt/openjms/config /usr/kde/2/share/config /usr/kde/3.2/share/config /usr/kde/3.3/env /usr/kde/3.3/share/config /usr/kde/3.3/shutdown /usr/kde/3.4/env /usr/kde/3.4/share/config /usr/kde/3.4/shutdown /usr/kde/3/share/config /usr/lib/X11/xkb /usr/lib/fax /usr/lib/mozilla/defaults/pref /usr/share/config /var/qmail/control /var/spool/fax/etc" CONFIG_PROTECT_MASK="/etc/X11/xkb /etc/gconf /etc/terminfo /etc/env.d" CXXFLAGS="-O2 -march=pentium3 -mmmx -msse -msse2 -mfpmath=sse -fomit-frame-pointer -fprefetch-loop-arrays -pipe" DISTDIR="/usr/portage/distfiles" FEATURES="autoconfig distlocks fixpackages sandbox sfperms strict userpriv usersandbox" GENTOO_MIRRORS=" http://distfiles.gentoo.org http://www.ibiblio.org/pub/Linux/distributions/gentoo http://ftp.heanet.ie/pub/gentoo http://www.mirror.ac.uk/sites/www.ibiblio.org/gentoo http://gentoo.osuosl.org http://gentoo.oregonstate.edu " LINGUAS="en" PKGDIR="/usr/portage/packages" PORTAGE_TMPDIR="/var/tmp" PORTDIR="/usr/portage" PORTDIR_OVERLAY="/usr/local/portage" SYNC="rsync://rsync.europe.gentoo.org/gentoo-portage" USE="x86 X Xaw3d a52 aac aalib accessibility acl acpi adns alsa arts audiofile avi bash-completion berkdb bitmap-fonts bluetooth bonobo browserplugin bzip2 caps cdr crypt cscope cups curl dbus dga directfb divx4linux dlloader dts dv dvd dvdread eds emboss encode esd ethereal evo exif expat fam fastcgi fbcon ffmpeg fftw firebird flac flash font-server foomaticdb fortran freetds freetype gb gd gdbm ggi gif glut gnome gnomedb gnutls gphoto2 gpm gstreamer gtk gtk2 gtkhtml guile hal howl icc-pgo ieee1394 imagemagick imap imlib informix innodb ipv6 jack java javamail javascript jms jmx joystick jpeg jpeg2k junit kde kdeenablefinal kerberos krb4 ladcca lcms ldap libcaca libg++ libgda libwww logrotate lua lzo mad maildir mailwrapper matroska mbox mcal memlimit mikmod milter mmap mmx mng mono motif mozilla mp3 mpeg mpi mssql multislot mysql nas ncurses net netboot network nis nls nntp nptl oci8 odbc ogg oggvorbis openal openexr opengl oss pam pam_console pcmcia pcre pdflib perl pic plotutils png pnp portaudio postgres ppds prelude python qdbm qt quicktime radius readline real ruby samba sasl scanner sdl skey slang slp smartcard sndfile snmp socks5 speex spell sqlite sse sse2 ssl svg svga sysfs tcltk tcpd test theora threads tiff truetype truetype-fonts type1-fonts unicode usb v4l v4l2 vcd vidix vorbis win32codecs wmf wxwindows xanim xbase xface xim xine xinerama xml xml2 xmms xosd xprint xscreensaver xv xvid xvmc zeo zlib video_cards_radeon linguas_en userland_GNU kernel_linux elibc_glibc" Unset: ASFLAGS, CTARGET, LANG, LC_ALL, LDFLAGS, MAKEOPTS
*** Bug 108369 has been marked as a duplicate of this bug. ***
if you try and do this by hand... cd /usr/src/linux; make installmandocs what happens then? Same error? Looks a lot to me like a broken xml file. I'll check ,myself when I get home too
Yep - fails if bulit by hand too. So the question is: Does this happen with a stock 2.6.13.x kernel (and so we should probably remove the "doc" USE flag from 2.6.13 and 2.6.14* kernels) or is it a Gentoo patch has broken things (in which case we should probably fix it! ;) * IIRC Vanilla 2.6.14-RC1 and 2.6.14-RC2 kernels could also not build their documentation - so this looks as if it could be a problem in the Linus' tree. Alternatively, are updated documentation building tools needed for recent releases?
there is the possibility of the xml tools it uses need upgrading. Else it is a genuine fault with the linux tree which needs fixing. This does sometimes occur. I will have to check :) What version of xmlto are you using? please *attach* the output of emerge info as well.
Emerge info included (albeit not attached) to the initial message in this bug. Installed is app-text/xmlto-0.0.18, which is also the latest version in portage. So, it looks like an upstream problem (especially since 2.6.14* fails to) unless the newer kernels need tools which aren't even in portage yet...
(In reply to comment #5) > Emerge info included (albeit not attached) to the initial message in this bug. missed that somehow. Thanks. > Installed is app-text/xmlto-0.0.18, which is also the latest version in portage. Also the latest upstream > So, it looks like an upstream problem (especially since 2.6.14* fails to) unless > the newer kernels need tools which aren't even in portage yet... possibly, but more likely a malformed xml. I'll investigate sometime tonight/tomorrow.
2.6.14 seems to build these ok
Fixed in gentoo-sources-2.6.13-r5
