Trouble building release notes

[Jens Seidel <jensseidel users sf net>]

Hi,

I tried to work on the German translation of the current release notes
in gnomeweb-wml/www.gnome.org/start/2.14/notes.

Since one sentence was not translated I tried to update de.po.
Nevertheless I noticed that the Makefile is not perfect.

First of all I noticed many make warnings about duplicated targets.
That's because <lang>/release-notes.xml occurs multiple times on the
left side of a ":" in a rule.

The following fixes this (or at least the symptoms :-)
-	$(_DOC_LC_MODULES)	$(_DOC_LC_INCLUDES)			\
+	$(_DOC_LC_INCLUDES)						\
since $(_DOC_LC_MODULES) is a subset of $(_DOC_LC_INCLUDES).

Now I get:

Generating html for language:  C
Running xlstproc on:  docbook/C/release-notes.xml
runtime error: file ../../../../docbook_html_style/yelp-custom.xsl line 31 element call-template
xsl:call-template : template admon.graphic.width not found
error: file docbook/C/release-notes.xml
xsltRunStylesheet : run failed
  xlstproc finished

I tried adapting STYLE_PATH using the following paths:
/usr/share/yelp/xslt/ (Debian testing, version 2.12.2-2 of yelp)
gnomeweb-wml/docbook_html_style/
gnome-doc-utils/xslt/docbook/html/

Maybe I also tried (don't remember)
gnome-doc-utils/test/testdocs/
releng/2.x/style/

Why doesn't work the default version gnomeweb-wml/docbook_html_style/?
Also configure never complained about insufficient requirements.

OK, gnome-doc-utils/xslt/docbook/html/ works but creates xhtml files whereas I
expected to get html files. (But at least mozilla is able to display it,
konqueror doesn't.)

I also noticed a reference to /start/2.12/notes for http_prefix which I changed
to 2.14. Not sure whether that's necessary or used ...

I do not remember how I updated de.po to match the current strings but I remember that
a simple make -C docbook de/de.po did not help. It was necessary to delete de/de.po
before "make" updates (recreates) the file. The same problem occured with "make po"
(and the usual "make update-po" is not supported as well). During these test I lost
also once my de/ directory. 
Since the updated German file (which was IIRC named "de" in either de/ or docbook/de/)
with the additional single string (GNOME LiveCD) was completly different from the existing
de.po I was forced to insert this new message manually into the old de.po file to reduce
the size of the diff.
Very strange ... A tip in a Readme or a simplified Makefile would be useful ...

I attached the patch I used during my trial and error process.

PS: Please CC: me.

Jens

Index: Makefile.am
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.14/notes/Makefile.am,v
retrieving revision 1.2
diff -u -r1.2 Makefile.am
--- Makefile.am	28 Feb 2006 15:51:24 -0000	1.2
+++ Makefile.am	18 Mar 2006 23:17:51 -0000
@@ -16,6 +16,7 @@
 VERSION = 2.14
 ROOTDOC = release-notes.xml
 STYLE_PATH = ../../../../docbook_html_style/
+STYLE_PATH2 = ../../../../../gnome-doc-utils/xslt/docbook/html/
 
 
 DOC_LINGUAS_PLUS_ORIGINAL = C $(DOC_LINGUAS) 
@@ -34,11 +35,11 @@
 	    --param yelp_max_chunk_depth 1 \
 	    --stringparam admon.graphics.path ./images/ \
 	    --stringparam http_root http://www.gnome.org \
-	    --stringparam http_prefix /start/2.12/notes \
-	    $(STYLE_PATH)db2html.xsl docbook/$$docbookdir/$(ROOTDOC); \
+	    --stringparam http_prefix /start/2.14/notes \
+	    $(STYLE_PATH2)db2html.xsl docbook/$$docbookdir/$(ROOTDOC); \
 	  echo "  xlstproc finished"; \
 	  cp -R $(STYLE_PATH)images docbook/$$docbookdir/figures $$docbookdir; \
-	  for i in $$docbookdir/*.html; do \
+	  for i in $$docbookdir/*.xhtml; do \
 	    perl -p -i -e 's,<p class="section"></p>,<p class="section">Sections</p>,g' $$i; \
 	  done \
 	done
Index: docbook/gnome-doc-utils.make
===================================================================
RCS file: /cvs/gnome/gnomeweb-wml/www.gnome.org/start/2.14/notes/docbook/gnome-doc-utils.make,v
retrieving revision 1.2
diff -u -r1.2 gnome-doc-utils.make
--- docbook/gnome-doc-utils.make	28 Feb 2006 16:32:05 -0000	1.2
+++ docbook/gnome-doc-utils.make	18 Mar 2006 23:17:52 -0000
@@ -407,7 +407,7 @@
 ## @ _DOC_LC_DOCS
 ## All documentation files in all other locales
 _DOC_LC_DOCS =								\
-	$(_DOC_LC_MODULES)	$(_DOC_LC_INCLUDES)			\
+	$(_DOC_LC_INCLUDES)						\
 	$(_RNGDOC_LC_DOCS)	$(_XSLDOC_LC_DOCS)			\
 	$(if $(findstring html,$(_DOC_REAL_FORMATS)),$(_DOC_LC_HTML))