Re: [PATCH] [KERNEL-DOC] kill warnings when building mandocs

Borislav Petkov
2007-04-15T07:10:57Z

On Sat, Apr 14, 2007 at 09:13:41AM -0700, Randy Dunlap wrote:
> On Fri, 13 Apr 2007 11:14:22 +0200 Borislav Petkov wrote:
>
> > This patch shuts warnings of the sort:
> >
> > make -C /mnt/samsung_200/sam/kernel/trees/21-rc6/build \
> > KBUILD_SRC=/mnt/samsung_200/sam/kernel/trees/21-rc6 \
> > KBUILD_EXTMOD="" -f /mnt/samsung_200/sam/kernel/trees/21-rc6/Makefile mandocs
> > make -f /mnt/samsung_200/sam/kernel/trees/21-rc6/scripts/Makefile.build obj=scripts/basic
> > make -f /mnt/samsung_200/sam/kernel/trees/21-rc6/scripts/Makefile.build obj=Documentation/DocBook mandocs
> > SRCTREE=/mnt/samsung_200/sam/kernel/trees/21-rc6/ /mnt/samsung_200/sam/kernel/trees/21-rc6/build/scripts/basic/docproc doc /mnt/samsung_200/sam/kernel/trees/21-rc6/Documentation/DocBook/wanbook.tmpl >Documentation/DocBook/wanbook.xml
> > if grep -q refentry Documentation/DocBook/wanbook.xml; then xmlto man -m /mnt/samsung_200/sam/kernel/trees/21-rc6/Documentation/DocBook/stylesheet.xsl -o Documentation/DocBook/man Documentation/DocBook/wanbook.xml ; gzip -f Documentation/DocBook/man/*.9; fi
> > Note: meta version: No productnumber or alternative sppp_close
> > Note: meta version: No refmiscinfo@class=version sppp_close
> > Note: Writing sppp_close.9
> > Note: meta version: No productnumber or alternative sppp_open
> > Note: meta version: No refmiscinfo@class=version sppp_open
> >
> > by adding a RefMiscInfo xml tag in the form of the current kernel version to
> > the function, struct and enum definitions in files included by kernel-doc when
> > building 'mandocs'. However, the version string appears truncated on the manpage
> > due to some constraints in the xml DTD for the man header, I believe, for the
> > troff output is truncated too.
>
> Hi Borislav,
>
> I cannot reproduce this error (either, a la the tex error).
> Any hints about how I could do so?

Hm, this is strange. IIRC, the refmiscinfo version tag is imposed by the docbook
xsl stylesheets for manpages, see
http://www.oasis-open.org/archives/docbook-apps/200508/msg00111.html and
especially the 'man'-section, subsection 'extra2 field.' According to it,
the stylesheets check several different locations for version info to be put in
the left footer position in the manpage, and if none is found, they simply state
that there's no version info, so this is not an error message but simply a
notification which, if nothing else, annoys while building the mandocs.

The URL cites the changelog of docbook-xsl 1.69.1 and this is also the
version in SLED 10 you're using so you should be getting this, too. I'll
try to dig deeper into this. The relevant packs I use are docbook-xsl:
1.72.0.dfsg.1-1, xmlto: 0.0.18-5.1 on debian unstable.

--
Regards/Gruß,
Boris.