The emerge continues after this error appears which is not good. Here is the log: DOCPROC Documentation/DocBook/kernel-api.sgml Use of uninitialized value in join or string at /var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/scripts/kernel-doc line 369, <IN> line 698. Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/lib/string.c): no structured comments found Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/mm/slab.c:2773): No description found for parameter 'unused' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1381): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1593): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1700): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1832): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1857): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1943): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1965): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1987): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/fs/super.c:152): No description found for parameter 'sb' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'sp' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'local_df' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'tc_verd' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'tc_classid' Error(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:936): cannot understand prototype: '#ifndef CONFIG_HAVE_ARCH_DEV_ALLOC_SKB ' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/net/core/skbuff.c:1472): No description found for parameter 'skb' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/net/core/skbuff.c:1472): No description found for parameter 'skb1' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/net/core/skbuff.c:1472): No description found for parameter 'len' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/net/8390.c:1006): No description found for parameter 'size' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/arch/i386/kernel/irq.c): no structured comments found Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/block/ll_rw_blk.c:624): No description found for parameter 'tags' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/block/ll_rw_blk.c:1973): No description found for parameter 'bio' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/fbmem.c:1221): No description found for parameter 'name' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/fbmem.c:1221): No description found for parameter 'option' Error(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/fbmem.c:1265): cannot understand prototype: 'const char *global_mode_option; ' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/console/fbcon.c): no structured comments found make[1]: *** [Documentation/DocBook/kernel-api.sgml] Error 1 make: *** [mandocs] Error 2 >>> Test phase [not enabled]: sys-kernel/vanilla-sources-2.6.11.10 >>> Install vanilla-sources-2.6.11.10 into /var/tmp/portage/vanilla-sources-2.6.11.10/image/ category sys-kernel >>> Copying sources ... * Installing manpages... DOCPROC Documentation/DocBook/kernel-api.sgml Use of uninitialized value in join or string at /var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/scripts/kernel-doc line 369, <IN> line 698. Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/lib/string.c): no structured comments found Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/mm/slab.c:2773): No description found for parameter 'unused' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1381): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1593): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1700): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1832): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1857): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1943): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1965): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/kernel/sysctl.c:1987): No description found for parameter 'ppos' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/fs/super.c:152): No description found for parameter 'sb' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'sp' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'local_df' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'tc_verd' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:283): No description found for parameter 'tc_classid' Error(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/include/linux/skbuff.h:936): cannot understand prototype: '#ifndef CONFIG_HAVE_ARCH_DEV_ALLOC_SKB ' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/net/core/skbuff.c:1472): No description found for parameter 'skb' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/net/core/skbuff.c:1472): No description found for parameter 'skb1' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/net/core/skbuff.c:1472): No description found for parameter 'len' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/net/8390.c:1006): No description found for parameter 'size' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/arch/i386/kernel/irq.c): no structured comments found Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/block/ll_rw_blk.c:624): No description found for parameter 'tags' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/block/ll_rw_blk.c:1973): No description found for parameter 'bio' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/fbmem.c:1221): No description found for parameter 'name' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/fbmem.c:1221): No description found for parameter 'option' Error(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/fbmem.c:1265): cannot understand prototype: 'const char *global_mode_option; ' Warning(/var/tmp/portage/vanilla-sources-2.6.11.10/work/linux-2.6.11.10/drivers/video/console/fbcon.c): no structured comments found make[1]: *** [Documentation/DocBook/kernel-api.sgml] Error 1 make: *** [installmandocs] Error 2 [ !! ] Reproducible: Always Steps to Reproduce: 1. emerge vanilla-sources Portage 2.0.51.19 (default-linux/x86/2005.0, gcc-3.3.5-20050130, glibc-2.3.4.20041102-r1, 2.6.11.7 i686) ================================================================= System uname: 2.6.11.7 i686 Pentium III (Coppermine) Gentoo Base System version 1.4.16 Python: dev-lang/python-2.3.5 [2.3.5 (#1, May 11 2005, 03:10:06)] distcc 2.16 i686-pc-linux-gnu (protocols 1 and 2) (default port 3632) [disabled] dev-lang/python: 2.3.5 sys-apps/sandbox: [Not Present] sys-devel/autoconf: 2.59-r6, 2.13 sys-devel/automake: 1.9.5, 1.7.9-r1, 1.8.5-r3, 1.5, 1.4_p6, 1.6.3 sys-devel/binutils: 2.15.92.0.2-r7 sys-devel/libtool: 1.5.16 virtual/os-headers: 2.6.8.1-r2 ACCEPT_KEYWORDS="x86" AUTOCLEAN="yes" CFLAGS="-O3 -march=pentium3 -fomit-frame-pointer" CHOST="i686-pc-linux-gnu" CONFIG_PROTECT="/etc /usr/kde/2/share/config /usr/kde/3.3/env /usr/kde/3.3/share/config /usr/kde/3.3/shutdown /usr/kde/3/share/config /usr/lib/X11/xkb /usr/share/config /usr/share/texmf/dvipdfm/config/ /usr/share/texmf/dvips/config/ /usr/share/texmf/tex/generic/config/ /usr/share/texmf/tex/platex/config/ /usr/share/texmf/xdvi/ /var/bind /var/qmail/control" CONFIG_PROTECT_MASK="/etc/gconf /etc/terminfo /etc/env.d" CXXFLAGS="-O3 -march=pentium3 -fomit-frame-pointer" DISTDIR="/usr/portage/distfiles" FEATURES="autoaddcvs autoconfig ccache distlocks sandbox sfperms strict" GENTOO_MIRRORS="http://gentoo.eliteitminds.com http://pandemonium.tiscali.de/pub/gentoo/ ftp://pandemonium.tiscali.de/pub/gentoo/ http://gentoo.mirror.icd.hu/" MAKEOPTS="-j2" PKGDIR="/usr/portage/packages" PORTAGE_TMPDIR="/var/tmp" PORTDIR="/usr/portage" PORTDIR_OVERLAY="/usr/local/portage" SYNC="rsync://rsync.de.gentoo.org/gentoo-portage" USE="x86 X Xaw3d a52 aac accessibility acl acpi alsa apache2 arts audiofile avi berkdb bitmap-fonts bonobo bzip2 bzlib cdparanoia cpdflib cpudetection crypt cups curl dbm divx4linux doc dts dv dvd dvdread emacs emboss encode esd expat fam fame ffmpeg fits flash font-server foomaticdb fortran ftp gdbm gif gmp gnome gnutls gpm gtk gtk2 gtkhtml guile icq idn imagemagick imap imlib jbig jpeg kde kdeenablefinal lcms ldap leim libg++ libwww live lzomad maildir mailwrapper matroska mhash mikmod milter mime ming mjpeg mmx mng motif mozilla mozsvg mp3 mpeg mplayer mysqli ncurses network nls no-old-linux no_wxgtk1 nocardbus nvidia objc octave ofx ogg oggvorbis openal opengl osc oss pam pcmcia pcre pda pdf pdflib perl php png posix povray ppds profile python qt quicktime readline real recode rtc sasl scanner sdl sharedmem shorten simplexml slp sndfile soap sockets sox spell spl sse ssl subp subtitles subversion svg svga szip tcpd tetex theora threads tidy tiff tokenizer transcode truetype truetype-fonts type1-fonts unicode usb utf8 v4l2 vcd vorbis win32codecs wmf wxwindows xanim xine xml xml2 xmlrpc xmms xpm xslxv xvid yv12 zlib userland_GNU kernel_linux elibc_glibc" Unset: ASFLAGS, CBUILD, CTARGET, LANG, LC_ALL, LDFLAGS, LINGUAS
The error is only about building documentation. Unfortunately, documentation generation is broken quite often. If we were to stop after the error, we'd have to patch all of our kernels to fix the problem (this is a lot of low-priority work), so I don't think there's much sense in aborting the merge here. We tend not to patch vanilla-sources, but this particular problem is fixed in recent gentoo-sources-2.6.11 releases.
Ill agree that killing the merge if docs cant be built is a bad idea, although that being said maybe it would be nicer if we just supress all output for the doc building stage, and wrap it all in an ebegin/eend just to make it more cosmetically pleasing. At least its also more descriptive. Thoughts?