Bug#629107: hydrogen: No text in User Manual

[trebmuh]

Le 2016-11-14 12:08, James Cowgill a écrit :

Where is the source for that documentation index?

If I grep the hydrogen sources, I can't find the strings from that
image. I also tried building upstream git master and the index doesn't
work for me there either.


Hi James and all,

I've been following up with Hydrogen upstream as you can see here : 
https://github.com/hydrogen-music/hydrogen/issues/74

The result is that something was missing and has been corrected now.

I guess we could cherry pick up this commit : 
https://github.com/hydrogen-music/hydrogen/commit/99aeea17d0f8cdf0ca8b12908d6499f586257610 
and use it as a debian/patches/manual.patch to allow construction

of the index which is how Hydrogen is supposed to be.

In the meantime, I've been rebuilding (pbuilder) hydrogen git master on 
Debian Jessie from a debian/* close to what it was before
Jaromir started to work on the 0.9.7 version + your patch, and I can see 
the menu index, the English manual, but the others links in the index 
(Manuale in italiano, manual en espanol,...etc) are giving an empty 
page.


Strangely enough, I can see the .po files for those in 
/usr/share/hydrogen/data/doc/, but can't see the different 
documentations in the same location. This is corroborated by launching 
Hydrogen from the terminal and clicking on the links which gives :

QTextBrowser: No document for manual_it.html
QTextBrowser: No document for manual_es.html
QTextBrowser: No document for manual_de.html
QTextBrowser: No document for manual_fr.html
QTextBrowser: No document for manual_nl.html
QTextBrowser: No document for tutorial_en.html
QTextBrowser: No document for tutorial_it.html
QTextBrowser: No document for tutorial_fr.html
QTextBrowser: No document for manual_de.html
...

I'm don't feel really knowledgeable here, but it does look to me that 
the *.html files are not generated from the *.po .


Hope that helps, and thanks for your interest.
Olivier

Bug#629107: hydrogen: No text in User Manual

[James Cowgill]

Hi,

On 13/11/16 18:29, treb...@tuxfamily.org wrote:
> Le 2016-11-13 11:55, James Cowgill a écrit :
>> On 12/11/16 11:41, Jaromír Mikeš wrote:
>>> I know about this bug and I am not ignoring it.
>>> I already tried fix it in past without success :(
>>> Hopefully some more skilled mate from team will give a hand with it.
>>
>> How about the attached patch?
>>
>> I think the original purpose of that code in debian/rules was to force
>> the manual to always be rebuilt. Unfortunately it moves 'manual.docbook'
>> out of the way (as if it was autogenerated) but it looks like this is
>> the master manual which is directly edited.
>>
>> My alternate implementation simply touches the master manuals which
>> should hopefully force everything to be rebuilt as well.
>>
>> Thanks,
>> James
> 
> Hi James,
> 
> and thanks for this patch which definitely move forward. Thanks ! (If you'd
> know the number of times I prayed for this bug to be fixed)
> 
> I tried a rebuild at home on a Debian Jessie + 0.9.7 version with this
> added.
> And I made one qt4 build and one qt5 build.
> 
> The outcome is that when going to : hydrogen menu -> Info -> User
> manual, I've got
> the user manuel (in English whatever the language I'm using).
> If I then click on "Documentation index" with I expect to show me this :
> https://cloud.githubusercontent.com/assets/8705846/17536586/4797c9fc-5e96-11e6-91fb-ad40223b4fcf.png
> 
> But it doesn't.
> 
> James, Jaromir, others, any idea ?

Where is the source for that documentation index?

If I grep the hydrogen sources, I can't find the strings from that
image. I also tried building upstream git master and the index doesn't
work for me there either.

James



signature.asc
Description: OpenPGP digital signature

Bug#629107: hydrogen: No text in User Manual

[trebmuh]

Le 2016-11-13 11:55, James Cowgill a écrit :

Control: tags -1 patch

Hi,

On 12/11/16 11:41, Jaromír Mikeš wrote:

2016-11-12 11:58 GMT+01:00  :


while you're working around the Hydrogen packaging, can I humbly
ask you to have a look at this bug :
https://bugs.debian.org/629107 ?

There is willingness upstream (which I'm part of regarding the
manual) to update and improve the bundled update manual and not
having it displayed/accessible in the GUI is frustrating.

As said in bug 629107, I've been looking at it but am not
knowledgeable/competent to resolve it. Help here would be
appreciated.


Hi Olivier,

I know about this bug and I am not ignoring it.
I already tried fix it in past without success :(
Hopefully some more skilled mate from team will give a hand with it.


How about the attached patch?

I think the original purpose of that code in debian/rules was to force
the manual to always be rebuilt. Unfortunately it moves 
'manual.docbook'

out of the way (as if it was autogenerated) but it looks like this is
the master manual which is directly edited.

My alternate implementation simply touches the master manuals which
should hopefully force everything to be rebuilt as well.

Thanks,
James


Hi James,

and thanks for this patch which definitely move forward. Thanks ! (If 
you'd

know the number of times I prayed for this bug to be fixed)

I tried a rebuild at home on a Debian Jessie + 0.9.7 version with this 
added.

And I made one qt4 build and one qt5 build.

The outcome is that when going to : hydrogen menu -> Info -> User 
manual, I've got

the user manuel (in English whatever the language I'm using).
If I then click on "Documentation index" with I expect to show me this :
https://cloud.githubusercontent.com/assets/8705846/17536586/4797c9fc-5e96-11e6-91fb-ad40223b4fcf.png
But it doesn't.

James, Jaromir, others, any idea ?

Cheers,
Olivier

PS : thanks again James, really appreciated.

Bug#629107: hydrogen: No text in User Manual (Was: hydrogen packaging)

[Jaromír Mikeš]

2016-11-13 11:55 GMT+01:00 James Cowgill :
> Control: tags -1 patch
>
> Hi,
>
> On 12/11/16 11:41, Jaromír Mikeš wrote:
>> 2016-11-12 11:58 GMT+01:00  :
>>
>>> while you're working around the Hydrogen packaging, can I humbly
>>> ask you to have a look at this bug :
>>> https://bugs.debian.org/629107 ?
>>>
>>> There is willingness upstream (which I'm part of regarding the
>>> manual) to update and improve the bundled update manual and not
>>> having it displayed/accessible in the GUI is frustrating.
>>>
>>> As said in bug 629107, I've been looking at it but am not
>>> knowledgeable/competent to resolve it. Help here would be
>>> appreciated.
>>
>> Hi Olivier,
>>
>> I know about this bug and I am not ignoring it.
>> I already tried fix it in past without success :(
>> Hopefully some more skilled mate from team will give a hand with it.
>
> How about the attached patch?
>
> I think the original purpose of that code in debian/rules was to force
> the manual to always be rebuilt. Unfortunately it moves 'manual.docbook'
> out of the way (as if it was autogenerated) but it looks like this is
> the master manual which is directly edited.
>
> My alternate implementation simply touches the master manuals which
> should hopefully force everything to be rebuilt as well.

Works perfectly! Thank you James!

mira

Bug#629107: hydrogen: No text in User Manual (Was: hydrogen packaging)

[James Cowgill]

Control: tags -1 patch

Hi,

On 12/11/16 11:41, Jaromír Mikeš wrote:
> 2016-11-12 11:58 GMT+01:00  :
> 
>> while you're working around the Hydrogen packaging, can I humbly
>> ask you to have a look at this bug :
>> https://bugs.debian.org/629107 ?
>>
>> There is willingness upstream (which I'm part of regarding the
>> manual) to update and improve the bundled update manual and not
>> having it displayed/accessible in the GUI is frustrating.
>>
>> As said in bug 629107, I've been looking at it but am not
>> knowledgeable/competent to resolve it. Help here would be
>> appreciated.
> 
> Hi Olivier,
> 
> I know about this bug and I am not ignoring it.
> I already tried fix it in past without success :(
> Hopefully some more skilled mate from team will give a hand with it.

How about the attached patch?

I think the original purpose of that code in debian/rules was to force
the manual to always be rebuilt. Unfortunately it moves 'manual.docbook'
out of the way (as if it was autogenerated) but it looks like this is
the master manual which is directly edited.

My alternate implementation simply touches the master manuals which
should hopefully force everything to be rebuilt as well.

Thanks,
James
--- a/debian/rules
+++ b/debian/rules
@@ -35,23 +35,9 @@ DEB_COPYRIGHT_CHECK_IGNORE_REGEX = ^.*\.(flac|png|qm)|debian/(changelog|copyrigh
 # according to upstream INSTALL.txt this avoids potential clash with Qt3
 export QTDIR=/usr/share/qt4
 
-# 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:
+	touch data/doc/manual.docbook data/doc/tutorial.docbook
 	$(MAKE) -C data/doc
 	touch $@
 clean::


signature.asc
Description: OpenPGP digital signature

Bug#629107: hydrogen: No text in User Manual

[trebmuh]

Dear debian multimedia maintainer,

I can confirm that this bug is still present in the current build 
system. That said, some of this bug-related-outcomes have changed since 
the original report. You can have an overview of the current situation 
by reading at https://github.com/hydrogen-music/hydrogen/issues/74 .


I've been trying to find a correct solution but am getting lost 
somewhere and need someone which understand better than me what the 
debian/rules is supposed to be doing with those files and why it fails 
to doing so.


Hope that helps,
Olivier (olinuxx/trebmuh)

Bug#629107: hydrogen: No text in User Manual

[Torquil Macdonald Sørensen]

Package: hydrogen
Version: 0.9.5-2
Severity: normal

There is no text in the window that is displayed when selecting the menu item

Info - User Manual

I get a window entitled Manual, containing a button entitled Documentation
Index. There is a large field below that contains no text.

Best regards
Torquil Sørensen

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (700, 'unstable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.39 (SMP w/2 CPU cores; PREEMPT)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages hydrogen depends on:
ii  libarchive1 2.8.4-1  Single library to read/write tar, 
ii  libasound2  1.0.23-4 shared library for ALSA applicatio
ii  libc6   2.13-4   Embedded GNU C Library: Shared lib
ii  libgcc1 1:4.6.0-10   GCC support library
ii  libjack-jackd2-0 [libja 1.9.7~dfsg-1 JACK Audio Connection Kit (librari
ii  liblrdf00.4.0-5  library to manipulate RDF files de
ii  libportaudio2   19+svn20110326-1 Portable audio I/O - shared librar
ii  libportmidi01:184-2  library for real-time MIDI input/o
ii  libqt4-network  4:4.7.3-1Qt 4 network module
ii  libqt4-xml  4:4.7.3-1Qt 4 XML module
ii  libqtcore4  4:4.7.3-1Qt 4 core module
ii  libqtgui4   4:4.7.3-1Qt 4 GUI module
ii  libsndfile1 1.0.24-1 Library for reading/writing audio 
ii  libstdc++6  4.6.0-10 The GNU Standard C++ Library v3
ii  zlib1g  1:1.2.3.4.dfsg-3 compression library - runtime

Versions of packages hydrogen recommends:
pn  hydrogen-drumkits none (no description available)
pn  rubberband-clinone (no description available)

hydrogen suggests no packages.

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of unsubscribe. Trouble? Contact listmas...@lists.debian.org