[build/packaging] missing doc_??.qhc and plugins' desc./info

• Sep 4, 2015 - 13:32
Type
Functional
Severity
S5 - Suggestion
Status
active
Project

The reference documentation is not packaged for Ubuntu (manual, plugins help).

I tried to auto-compile musescore from the source package on Ubuntu (see: [ubuntu-PPA] no v2.0.2). Some files might have got generated into the rdoc/ directory, but not into the build.release/rdoc/ dir, and the final doc_en.qhc file and a doc package was not created.

I accidentally came across such a package for Feroda (e.g. http://arm.koji.fedoraproject.org/koji/rpminfo?rpmID=1511567 ), so I concluded that it is not deliberately missing.


(Suspected) CONSEQUENCES:

Getting the warning on the commad-line:

cannot setup data for help engine: Cannot open collection file: /usr/share/mscore-2.0/manual/doc_en.qhc

The help browser in the application is empty and the plugins have no desctiption (only what seems to be a plugin file-name, from which I could not guess what they actually do).


Comments

You are correct, the manuals are not installed on Ubuntu. It seems this was done intentionally in the past for compliance with the Debian Foundation Software Guidelines (DFSG) because the PDF manual was covered by a GPL-incompatible license. However, the PDF is no longer shipped with MuseScore and the remaining manuals are safe to be included.

I've submitted a report downstream:
https://bugs.launchpad.net/ubuntu/+source/musescore/+bug/1492629