2013-06-26 05:28:54

by Michael Opdenacker

[permalink] [raw]
Subject: Workaround: kernel Docbook documentation - fsfunc prefix issue

Hi,

We're maintaining an online copy of kernel documentation at
http://free-electrons.com/kerneldoc/, where Docbook .tmpl files have
been converted to html, using the "make htmldocs" command. The goal is
to make such automatically generated documentation available to search
engines.

I noticed that in the generated .html files, all function names where
prefixed by "fsfunc", which was quite ugly.

At least in Debian based distros, this is actually a known bug in the
"docbook-xls" package:
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=654338

Fortunately, a fix is now available. You can either upgrade to the
latest Debian versions, or just install the new package manually. That's
what I did on my Ubuntu 13.04 system:
> wget
http://ftp.us.debian.org/debian/pool/main/d/docbook-xsl/docbook-xsl_1.78.1+dfsg-1_all.deb
> sudo dpkg -i docbook-xsl_1.78.1+dfsg-1_all.deb

Now, my generated kernel documentation looks great again.

Cheers,

Michael.

--
Michael Opdenacker, Free Electrons
Embedded Linux, Kernel and Android engineering
http://free-electrons.com
+33 484 258 098