manual not available in 0.9.5 and 0.9.6
in the 0.9.5 and 0.9.6 you cannot open the manual
goto Info > User Manual and all you get is an empty window
goto Info > User Manual and all you get is an empty window
Leave a comment
on 2011-10-17 14:00 *
By AutoStatic
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:
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
# 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
on 2011-10-18 10:50 *
By AutoStatic
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:
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:
Since I don't get an indication on which line the exception happens I have atm no idea how to proceed.
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.
on 2011-10-18 11:19 *
By AutoStatic
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.
on 2011-10-19 14:18 *
By AutoStatic
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)?
on 2011-10-21 10:02 *
By AutoStatic
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.