* The ebuild is installing to one or more unexpected paths: * * /usr/share/doc/HTML * * Please fix the ebuild to use correct FHS/Gentoo policy paths.
Usage of this path dates back to *at least* 2008 and was mentioned first in kde4-base.eclass with the exception to not compress it with EAPI 4 in 2011. All KDE handbook files need to be below the same subdirectory for khelpcenter to find the docs. If this is now suddenly a problem, then please advise how else to solve this.
*** Bug 668626 has been marked as a duplicate of this bug. ***
*** Bug 668628 has been marked as a duplicate of this bug. ***
Another problem is detection of the index.cache (that is compressed to bz2): * Please fix the ebuild not to install compressed files (manpages, * documentation) when automatic compression is used: * * /usr/share/doc/HTML/en/kwrite/index.cache.bz2 * /usr/share/doc/HTML/de/kwrite/index.cache.bz2
*** Bug 668694 has been marked as a duplicate of this bug. ***
To circumvent these QA warnings, we could simply set HTML_INSTALL_DIR inside kde5.eclass to a directory outside of /usr/share/doc.
Opinions? Should we just pull a 'gtk-doc'? Is that acceptable to QA?
The bug has been referenced in the following commit(s): https://gitweb.gentoo.org/proj/kde.git/commit/?id=41f803a7f62ba178bff82b78e4455e271587a243 commit 41f803a7f62ba178bff82b78e4455e271587a243 Author: Andreas Sturmlechner <asturm@gentoo.org> AuthorDate: 2019-01-28 22:25:48 +0000 Commit: Andreas Sturmlechner <asturm@gentoo.org> CommitDate: 2019-01-28 22:41:16 +0000 kde-frameworks/kdoctools: Add /usr/share/help dir to list of doc dirs This is fed to kio_help from kde-frameworks/kio to populate kde-apps/khelpcenter runtime content. Bug: https://bugs.gentoo.org/667138 Package-Manager: Portage-2.3.59, Repoman-2.3.12 Signed-off-by: Andreas Sturmlechner <asturm@gentoo.org> .../kdoctools-5.54.0-gentoo-docbundledir.patch | 26 ++++++++++++++++++++++ kde-frameworks/kdoctools/kdoctools-9999.ebuild | 2 ++ 2 files changed, 28 insertions(+) https://gitweb.gentoo.org/proj/kde.git/commit/?id=290bbd89e17c723ca268f36ed01d2256c372a015 commit 290bbd89e17c723ca268f36ed01d2256c372a015 Author: Andreas Sturmlechner <asturm@gentoo.org> AuthorDate: 2019-01-28 19:29:12 +0000 Commit: Andreas Sturmlechner <asturm@gentoo.org> CommitDate: 2019-01-28 22:34:42 +0000 kde5.eclass: Relocate KDE_INSTALL_DOCBUNDLEDIR to /usr/share/help These are handbook files installed by hundreds of packages to a central location, to be accessed by KDE Helpcenter application, with compressed index cache files. This leads to the following QA issues on every package w/ USE handbook: * The ebuild is installing to one or more unexpected paths * One or more compressed files were found in docompress-ed directories We'll use the EAPI-7 transition to move the location from previously /usr/share/doc/HTML to /usr/share/help [1]. Transition for khelpcenter will be seemless as kde-frameworks/kdoctools can be easily patched to accept both locations, until eventually /usr/share/doc/HTML is empty. As a side-effect, we will be able to drop the workaround for disabling auto compression of files beneath /usr/share/doc together with EAPI-6. [1] See also: https://www.freedesktop.org/wiki/Specifications/help-system/ It is also the path upstream intends to migrate to in the future. Bug: https://bugs.gentoo.org/667138 Signed-off-by: Andreas Sturmlechner <asturm@gentoo.org> eclass/kde5.eclass | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-)
The bug has been referenced in the following commit(s): https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=68f1813bb6ff036b2f3d250effcaad28c051a20d commit 68f1813bb6ff036b2f3d250effcaad28c051a20d Author: Andreas Sturmlechner <asturm@gentoo.org> AuthorDate: 2019-01-28 19:29:12 +0000 Commit: Andreas Sturmlechner <asturm@gentoo.org> CommitDate: 2019-02-07 12:59:56 +0000 kde5.eclass: Relocate KDE_INSTALL_DOCBUNDLEDIR to /usr/share/help These are handbook files installed by hundreds of packages to a central location, to be accessed by KDE Helpcenter application, with compressed index cache files. This leads to the following QA issues on every package w/ USE handbook: * The ebuild is installing to one or more unexpected paths * One or more compressed files were found in docompress-ed directories We'll use the EAPI-7 transition to move the location from previously /usr/share/doc/HTML to /usr/share/help [1]. Transition for khelpcenter will be seemless as kde-frameworks/kdoctools can be easily patched to accept both locations, until eventually /usr/share/doc/HTML is empty. As a side-effect, we will be able to drop the workaround for disabling auto compression of files beneath /usr/share/doc together with EAPI-6. [1] See also: https://www.freedesktop.org/wiki/Specifications/help-system/ It is also the path upstream intends to migrate to in the future. Bug: https://bugs.gentoo.org/667138 Signed-off-by: Andreas Sturmlechner <asturm@gentoo.org> eclass/kde5.eclass | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-)
*** Bug 677506 has been marked as a duplicate of this bug. ***
All packages w/ USE handbook have been migrated to EAPI-7.
