ubuntu setup to (correctly) generate kernel html and pdf docs?

[Robert P. J. Day]

  sort of a kernel question, but more a ubuntu question since it
involves html and pdf generation.

  if you have the latest kernel source, you can generate the
kerneldoc-related documentation with things like:

  $ make htmldocs
  $ make pdfdocs

(see the appropriate makefile Documentation/DocBook/Makefile for
variations.)

however, both of those variations have some processing issues.

  first, with html, you run into the issue i posted about here a while
back:

  http://www.spinics.net/lists/linux-doc/msg05951.html

the simple fix is to back off to html from xhtml:

diff --git a/Documentation/DocBook/Makefile b/Documentation/DocBook/Makefile
index bc3d9f8..5cf621b 100644
--- a/Documentation/DocBook/Makefile
+++ b/Documentation/DocBook/Makefile
@@ -145,7 +145,7 @@ build_main_index = rm -rf $(main_idx); \
                   cat $(HTML) >> $(main_idx)

 quiet_cmd_db2html = HTML    $@
-      cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \
+      cmd_db2html = xmlto html $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \
                echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/index.html"> \
         $(patsubst %.html,%,$(notdir $@))</a><p>' > $@


but it would be nice to figure out how to resolve this.

  and, second, trying to generate pdfdocs just explodes -- i am in no
way a PDF processing expert so anyone who wants to try it can see what
i'm talking about.

  in any event, if anyone has a few minutes and wants to try to
reproduce the above and suggest fixes in terms of the required ubuntu
setup, i'd be massively grateful.

rday

-- 

========================================================================
Robert P. J. Day                                 Ottawa, Ontario, CANADA
                        http://crashcourse.ca

Twitter:                                       http://twitter.com/rpjday
LinkedIn:                               http://ca.linkedin.com/in/rpjday
========================================================================