Missing documentation pages in Amarok

[Davor Cubranic]

Binary package hint: amarok

Amarok in Natty (package amarok 2:2.4.0-0ubuntu5) is missing the following help pages:

- file:///usr/share/doc/kde/HTML/en//amarok/the-left-pane-media-sources.html
- file:///usr/share/doc/kde/HTML/en//amarok/music-playback.html.
- file:///usr/share/doc/kde/HTML/en//amarok/starting-amarok.html.
- file:///usr/share/doc/kde/HTML/en//amarok/default-layout-of-the-amarok-window.html.
- file:///usr/share/doc/kde/HTML/en//amarok/the-media-sources-pane.html.
- file:///usr/share/doc/kde/HTML/en//amarok/the-playlist-pane.html.
- file:///usr/share/doc/kde/HTML/en//amarok/default-layout.html.
- file:///usr/share/doc/kde/HTML/en//amarok/some-of-the-music-is-being-rapidly-skipped-over.html.
- file:///usr/share/doc/kde/HTML/en//amarok/breadcrumbs.html.
-

[Jonathan Thomas (echidnaman)]

These files are generated at build time from the index.docbook that amarok ships using meinproc. The lack of these suggests that they are absent from the index.docbook file. (The files do not turn up at all in the most recent buildlog: https://launchpadlibrarian.net/72510367/buildlog_ubuntu-oneiric-i386.amarok_2%3A2.4.1-1ubuntu2_BUILDING.txt.gz) This is an upstream bug and not a packaging bug, so please file a report at bugs.kde.org.

[Davor Cubranic (cubranic)]

Reported as 275869 at kde.org

[Davor Cubranic (cubranic)]

bugs.kde.org says: "Building Amarok from sources the help works properly, these files are not
missing, they are in index.cache.bz2 and extracted from the archive on the fly.

And using the files index.cache.bz2+index.docbook from
amarok-common_2.4.0-0ubuntu5_all.deb works as well here."

Reopening, as upstream claims it's a packaging issue.

[Felix Geyer (debfx)]

What makes you think these files are supposed to be there?
Did you get any errors while browsing the docs with khelpcenter?

[Jonathan Thomas (echidnaman)]

@Felix
Yes, several pages in the handbook 404.

I ran meinproc using the index.docbook from the tarball manually and it did not produce these files. It really is a problem with the file upstream is distributing.

[Davor Cubranic (cubranic)]

Jonathan, what about the comment from the KDE devs (as I quoted in comment #3)? Those files are not in index.docbook, but in index.cache.bz2.

 I don't know what that means, but if there is any other information I can get from them, or provide to them, to clarify exactly where the problem is, please let me know. I assume from your comment that you too can reproduce the error, so if you want to chime in on KDE, the bug is https://bugs.kde.org/show_bug.cgi?id=275869.

[Burkhard Lück (lueck)]

upstream bug https://bugs.kde.org/show_bug.cgi?id=276764

[Davor Cubranic (cubranic)]

Switching the remote bug watch to KDE bug 276764 instead of the dupe, 275869.

[Davor Cubranic (cubranic)]

And the apparrent underlying cause, as described in KDE bug 246755, is that meinproc4 currently fails if the "--output" argument is a hidden directory (i.e., starting with a period), leading to an empty cache directory where the missing pages were supposed to be found.

[Jonathan Kolberg (bulldog98)]

Still the case in oneiric