[gentoo-commits] repo/gentoo:master commit in: app-doc/gnucash-docs/files/, app-doc/gnucash-docs/

[Aaron W. Swenson]

commit:     2c6b17fa9043f381a2b183326cc8713c2e4be9aa
Author:     Aaron W. Swenson <titanofold <AT> gentoo <DOT> org>
AuthorDate: Thu Mar 16 12:23:19 2023 +0000
Commit:     Aaron W. Swenson <titanofold <AT> gentoo <DOT> org>
CommitDate: Thu Mar 16 12:38:37 2023 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=2c6b17fa

app-doc/gnucash-docs: add 4.13

Signed-off-by: Aaron W. Swenson <titanofold <AT> gentoo.org>

 app-doc/gnucash-docs/Manifest                      |  1 +
 .../gnucash-docs-4.13-reverese-kde-help-dir.patch  | 75 ++++++++++++++++++++++
 app-doc/gnucash-docs/gnucash-docs-4.13.ebuild      | 72 +++++++++++++++++++++
 3 files changed, 148 insertions(+)

diff --git a/app-doc/gnucash-docs/Manifest b/app-doc/gnucash-docs/Manifest
index 5a1c8e3f1e42..bd47ea5de82b 100644
--- a/app-doc/gnucash-docs/Manifest
+++ b/app-doc/gnucash-docs/Manifest
@@ -1 +1,2 @@
 DIST gnucash-docs-4.12.tar.gz 76306600 BLAKE2B 78fb413099701da8c251681fa9724867f94cd731f396a80fd2be647790f32285a45eb857bfeae4ed6c36f5ec7664bc5aabfbdc2237d155a9f95aab78bf3227fa SHA512 29db1a402f7d417ad1a2f4db683974447add597e1b9e1b421789f3d2c8f987d1692202bb9052548b5ce544973c12bd538abab5ff33d3253330f0535ef920c8f7
+DIST gnucash-docs-4.13.tar.gz 76306335 BLAKE2B 61944e3da12d4f7b4a26f1301e640deca87656c4a9c7cd935f4c52ae69e49bf746850f09513d8fbd92314827f683c3a9c83c59479d583c192d977afdf9d8fce4 SHA512 7081a84c3426ef84e88aef520458a0d06382853cb9a51880766033b655f873d0926848387d573a38eca82cf0c6bceecdbd56704ab9ecb3068c78d7ce5c8d4da0

diff --git a/app-doc/gnucash-docs/files/gnucash-docs-4.13-reverese-kde-help-dir.patch b/app-doc/gnucash-docs/files/gnucash-docs-4.13-reverese-kde-help-dir.patch
new file mode 100644
index 000000000000..0f48fd5056b8
--- /dev/null
+++ b/app-doc/gnucash-docs/files/gnucash-docs-4.13-reverese-kde-help-dir.patch
@@ -0,0 +1,75 @@
+From 513747413efc4732f5ae824ccc84316169b1523f Mon Sep 17 00:00:00 2001
+From: Geert Janssens <geert@×××××××××.be>
+Date: Thu, 20 Oct 2022 11:25:19 +0200
+Subject: [PATCH] Ensure our documentation is also found when gnucash is run in
+ KDE
+
+Turns out KDE is not adhering to the xdg spec after all.
+It has support for the old ghelp mechanism, but when using
+the help: prefix, it falls back to an internal protocol.
+In that case the requested document is searched for in
+<prefix>/share/doc/HTML/<lang>.
+Extra caveat - the English documentation is searched for
+in a directory 'en' instead of 'C'.
+This is not a problem in yelp, only in khelpcenter. Unfortunately
+khelpcenter is the default application to process help: prefixes
+in a Kde plasma desktop, hence the workaround.
+---
+ cmake/AddXdgHelpTarget.cmake | 28 +++++++++++++++++++++++++---
+ 1 file changed, 25 insertions(+), 3 deletions(-)
+
+diff --git a/cmake/AddXdgHelpTarget.cmake b/cmake/AddXdgHelpTarget.cmake
+index efbe20f25..f0c800f2e 100644
+--- a/cmake/AddXdgHelpTarget.cmake
++++ b/cmake/AddXdgHelpTarget.cmake
+@@ -10,7 +10,16 @@
+ 
+ function (add_xdghelp_target docname lang entities figures)
+ 
+-    set(BUILD_DIR "${DATADIR_BUILD}/help/${lang}/${docname}")
++    set(BUILD_DIR_BASE "${DATADIR_BUILD}/help/${lang}")
++    set(BUILD_DIR "${BUILD_DIR_BASE}/${docname}")
++
++    # Define location where KDE's help system looks for <doc>
++    # when invoked with help:<doc>
++    set(kde_lang ${lang})
++    if (lang STREQUAL "C")
++        set(kde_lang "en")
++    endif()
++    set(BUILD_DIR_KDE_BASE "${DATADIR_BUILD}/doc/HTML")
+ 
+     set(source_files "")
+     foreach(xml_file ${entities} index.docbook)
+@@ -33,6 +42,10 @@ function (add_xdghelp_target docname lang entities figures)
+       OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/xdghelptrigger"
+       COMMAND ${CMAKE_COMMAND} -E make_directory "${BUILD_DIR}"
+       COMMAND ${CMAKE_COMMAND} -E make_directory "${BUILD_DIR}/figures"
++
++      # Add links to make our documentation visible for KDE's help system
++      COMMAND ${CMAKE_COMMAND} -E make_directory "${BUILD_DIR_KDE_BASE}"
++      COMMAND ${CMAKE_COMMAND} -E create_symlink "${BUILD_DIR_BASE}" "${BUILD_DIR_KDE_BASE}/${kde_lang}"
+       COMMAND touch "${CMAKE_CURRENT_BINARY_DIR}/xdghelptrigger")
+ 
+ 
+@@ -66,10 +79,19 @@ function (add_xdghelp_target docname lang entities figures)
+ 
+     add_dependencies(${docname}-xdghelp "${lang}-${docname}-xdghelp")
+ 
++    set(doc_install_dir_base "${CMAKE_INSTALL_DATADIR}/help/${lang}")
++    set(doc_install_dir "${doc_install_dir_base}/${docname}")
+     install(FILES ${source_files}
+-        DESTINATION "${CMAKE_INSTALL_DATADIR}/help/${lang}/${docname}"
++        DESTINATION "${doc_install_dir}"
+         COMPONENT "xdghelp")
+     install(FILES ${figures}
+-        DESTINATION "${CMAKE_INSTALL_DATADIR}/help/${lang}/${docname}/figures"
++        DESTINATION "${doc_install_dir}/figures"
++        COMPONENT "xdghelp")
++
++    # Add links to make our documentation visible for KDE's help system
++    set(doc_install_dir_kde_base "${CMAKE_INSTALL_PREFIX}/${CMAKE_INSTALL_DATADIR}/doc/HTML")
++    install(CODE "execute_process (COMMAND ${CMAKE_COMMAND} -E make_directory \"${doc_install_dir_kde_base}\")"
++        COMPONENT "xdghelp")
++    install(CODE "execute_process (COMMAND ${CMAKE_COMMAND} -E create_symlink \"../../../${doc_install_dir_base}\" \"${doc_install_dir_kde_base}/${kde_lang}\")"
+         COMPONENT "xdghelp")
+ endfunction()

diff --git a/app-doc/gnucash-docs/gnucash-docs-4.13.ebuild b/app-doc/gnucash-docs/gnucash-docs-4.13.ebuild
new file mode 100644
index 000000000000..b53e45835b28
--- /dev/null
+++ b/app-doc/gnucash-docs/gnucash-docs-4.13.ebuild
@@ -0,0 +1,72 @@
+# Copyright 1999-2023 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=8
+
+# Please bump with app-office/gnucash
+
+CMAKE_MAKEFILE_GENERATOR=emake
+inherit cmake optfeature
+
+DESCRIPTION="Documentation package for GnuCash"
+HOMEPAGE="https://www.gnucash.org/"
+SRC_URI="https://github.com/Gnucash/${PN}/archive/${PV}.tar.gz -> ${P}.tar.gz"
+
+LICENSE="GPL-2 FDL-1.1"
+SLOT="0"
+KEYWORDS="~amd64 ~arm64 ~ppc ~ppc64 ~riscv ~x86"
+LOCALES=( de it ja pt )
+IUSE="${LOCALES[*]/#/l10n_}"
+
+BDEPEND="
+	app-text/docbook-xml-dtd:4.5
+	app-text/docbook-xsl-stylesheets
+	dev-libs/libxml2
+	dev-libs/libxslt
+"
+
+src_prepare() {
+	eapply -R "${FILESDIR}/${P}-reverese-kde-help-dir.patch"
+	cmake_src_prepare
+}
+
+src_compile() {
+	cmake_src_compile -j1
+}
+
+src_install() {
+	local doc_type my_lang
+
+	for doc_type in manual guide; do
+		for my_lang in C ${L10N}; do
+			[[ -z ${my_lang} ]] && continue
+
+			case "${my_lang}" in
+				# Both help and guides translated
+				C|de|it|pt) ;;
+				ja|ru) # Only guides translated
+					if [[ "${doc_type}" == "manual" ]] ; then
+						elog "Help documentation hasn't been translated for ${my_lang}"
+						elog "Will do English instead."
+						continue
+					fi
+					;;
+				*)
+					die "Invalid locale: ${my_lang}"
+					;;
+			esac
+
+			emake \
+				-C "${BUILD_DIR}/${doc_type}/${my_lang}" \
+				DESTDIR="${D}" \
+				install
+		done
+	done
+
+	einstalldocs
+}
+
+pkg_postinst() {
+	optfeature "generating PDF files" dev-java/fop
+	optfeature "viewing the docs" gnome-extra/yelp
+}