This is Ubuntu and maybe Debian specific and can be traced down to the Rules file provided by the Debian Multimedia maintainers git repository of Hydrogen. It's about this section:

 # Put aside upstream-shipped autogenerated files during build
 upstreamtmpfiles = $(wildcard data/doc/*.html data/doc/*.docbook)
 upstreamtmpfiles_ = $(patsubst %.upstream,%,$(wildcard data/doc/*.html.upstream data/doc/*.docbook.upstream))
 pre-build:: debian/stamp-upstreamtmpstuff
 debian/stamp-upstreamtmpstuff: debian/stamp-copyright-check
	for file in $(upstreamtmpfiles); do \
		[ ! -e $$file ] || [ -e $$file.upstream ] || mv $$file $$file.upstream; \
	done
	touch $@
 clean::
	for file in $(upstreamtmpfiles_); do \
		[ ! -e $$file.upstream ] || mv -f $$file.upstream $$file; \
	done
	rm -f debian/stamp-upstreamtmpstuff

 common-build-indep:: debian/docs.stamp
 debian/docs.stamp:
	$(MAKE) -C data/doc
	touch $@
 clean::
	rm -f debian/docs.stamp

Something goes wrong there, apparently the included .docbook and .html files get renamed properly (as they should according to the readme that comes with the documentation) but don't get regenerated.

Best,

Jeremy

Found the reason why $(MAKE) -C data/doc doesn't seem to work. The manual.docbook file doesn't match with the different po files:

make -C data/doc
make: Entering directory `/home/jjongep1/PPA/Hydrogen/hydrogen.test/data/doc'
cp -f manual.docbook manual_en.docbook
xmllint --noout --valid manual_en.docbook
touch manual_en.docbook_validated
LL=$(echo -n manual_en.docbook | sed 's/.*_\(..\)\.docbook/\1/') ; \
	xmlto html-nochunks --stringparam section.autolabel=1 --stringparam toc.max.depth=2 --stringparam xref.with.number.and.title=0 \
		--stringparam l10n.gentext.language=$LL \
		manual_en.docbook
po2xml manual.docbook manual_es.po > manual_es.docbook
line 143: unexpected token: #. Tag: title
line 163: unexpected token: #. Tag: para
can't find
Once you have selected a part of your song you can <emphasis role="bold">delete</emphasis> it by pressing the Delete button. You can <emphasis role="bold">move</emphasis> it by simply dragging your selection to another location, and you can also <emphasis role="bold">copy</emphasis> you selection by Ctrl-dragging it to a new location.
in
Once you have selected a part of your song you can <emphasis role= "bold">delete</emphasis> it by pressing the Delete button. You can <emphasis role="bold">move</emphasis> it by simply dragging your selection to another location, and you can also <emphasis role="bold">copy</emphasis> you selection by Ctrl-dragging it to a new location. </para>
make: *** [manual_es.docbook] Error 1
rm manual_en.docbook_validated
make: Leaving directory `/home/jjongep1/PPA/Hydrogen/hydrogen.test/data/doc'

After having fixed this I ran make clean to start over again. Then I noticed the different .docbook files didn't get removed so apparently the clean rule in the Makefile doesn't work like it should. I added a new variable (ALL_DOCBOOKS) and replaced * _{en,es,it,fr,nl,ca}.docbook with $(ALL_DOCBOOKS) which seems to work. It's probably got something to do with globbing because running rm -f * _{en,es,it,fr,nl,ca}.docbook does work.
New issue when running make:

make -C data/doc
make: Entering directory `/home/jjongep1/PPA/Hydrogen/hydrogen.test/data/doc'
cp -f manual.docbook manual_en.docbook
xmllint --noout --valid manual_en.docbook
touch manual_en.docbook_validated
LL=$(echo -n manual_en.docbook | sed 's/.*_\(..\)\.docbook/\1/') ; \
	xmlto html-nochunks --stringparam section.autolabel=1 --stringparam toc.max.depth=2 --stringparam xref.with.number.and.title=0 \
		--stringparam l10n.gentext.language=$LL \
		manual_en.docbook
po2xml manual.docbook manual_es.po > manual_es.docbook
line 143: unexpected token: #. Tag: title
line 163: unexpected token: #. Tag: para
xmllint --noout --valid manual_es.docbook
touch manual_es.docbook_validated
LL=$(echo -n manual_es.docbook | sed 's/.*_\(..\)\.docbook/\1/') ; \
	xmlto html-nochunks --stringparam section.autolabel=1 --stringparam toc.max.depth=2 --stringparam xref.with.number.and.title=0 \
		--stringparam l10n.gentext.language=$LL \
		manual_es.docbook
po2xml manual.docbook manual_fr.po > manual_fr.docbook
exception: expecting '
', found '
make: *** [manual_fr.docbook] Error 1
rm manual_es.docbook_validated manual_en.docbook_validated
make: Leaving directory `/home/jjongep1/PPA/Hydrogen/hydrogen.test/data/doc'

Since I don't get an indication on which line the exception happens I have atm no idea how to proceed.

Hmmm, po2xml manual.docbook manual_fr.po > manual_fr.docbook generates an empty docbook file. I can see why, manual.docbook and manual_fr.po do not match completely. Luckily it's just the French po file that might contain errors, the others ones seem ok.

My French is good but unfortunately I don't have the time on a short term to check the French po file. Would it be possible to contact the original author (Humbert Olivier)?

i don't understand this bug. compiling hydrogen0.9.6svn-head here on my debian unstable system offers a manual & tutorial as expected. did i miss something?

Hello Wolke, no not really as a SVN checkout already contains the necessary .html document files. But if I've understood the data/doc/README.DOCUMENTATION.txt file correctly those files should be regenerated after a checkout. This is where it goes wrong, the manual_fr.html doesn't get generated correctly because the docbook and po files do not match.

mailed Olivier on 21okt, but no answer so far

The manual_fr.html is invalid it contains english instead of the translated text. I've done a cursory scan of the manual_fr.po file and can't find the offending tidbit as of yet. I'll do a little more detailed scan and see what I can find.

Slainte
Daniel

the catalan .po file seems to be outdated as well. I couldn't get that to build either with the latest trunk.

moved to git