Re: [patch] tweak make htmldocs (nochunks and better index).

[Rob Landley <rob@landley.net>]

On Wednesday 30 May 2007 12:18 am, Randy Dunlap wrote:
> What is <\p> supposed to do?

Sorry, typo.  Should be </p> instead.  My bad.

As to what it does in a larger sense, "make the xml people happy".  Closing
parentheses tags make the various xhtml validators shut up.  The main
difference between xhtml and html is that you close all the tags you open.  I
can yank it if people prefer it that way.

> Here's what I see in index.html (beginning lines of it):
> 
> Linux Kernel HTML Documentation
> Kernel Version: 2.6.22-rc3
> 
> deviceiobookBus-Independent Device Accesses <\p>

Yeah, that's screwed up.  (It looked fine in Konqueror. :)  *rummage*...

Here's an updated patch.  This time I checked that it looked ok in Firefox
too:

--- git/Documentation/DocBook/Makefile	2007-05-23 16:36:56.000000000 -0400
+++ work/Documentation/DocBook/Makefile	2007-05-30 14:36:49.000000000 -0400
@@ -141,9 +141,12 @@
 		   cat $(HTML) >> $(main_idx)
 
 quiet_cmd_db2html = HTML   $@
-      cmd_db2html = xmlto xhtml $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \
-		echo '<a HREF="$(patsubst %.html,%,$(notdir $@))/index.html"> \
-        $(patsubst %.html,%,$(notdir $@))</a><p>' > $@
+      cmd_db2html = xmlto xhtml-nochunks $(XMLTOFLAGS) -o $(patsubst %.html,%,$@) $< && \
+		NAME='$(patsubst %.html,%,$(notdir $@))'; \
+		echo -n "<p><a HREF=\"$$NAME/$$NAME.html\">$$NAME</a> - " >$@; \
+		sed -nre 's@.*<title>(.*)</title>.*@\1@p' \
+			"Documentation/DocBook/$$NAME/$$NAME.html" >> $@ ; \
+		echo '</p>' >> $@
 
 %.html:	%.xml
 	@(which xmlto > /dev/null 2>&1) || \

Rob