[gentoo-commits] repo/gentoo:master commit in: eclass/

[Michał Górny]

commit:     76bc068be542c46ac73264a306c78a1ac8142003
Author:     Michał Górny <mgorny <AT> gentoo <DOT> org>
AuthorDate: Mon Oct 26 11:32:26 2020 +0000
Commit:     Michał Górny <mgorny <AT> gentoo <DOT> org>
CommitDate: Mon Oct 26 16:48:40 2020 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=76bc068b

llvm.org.eclass: Add manpage build/install utilities

Signed-off-by: Michał Górny <mgorny <AT> gentoo.org>

 eclass/llvm.org.eclass | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/eclass/llvm.org.eclass b/eclass/llvm.org.eclass
index ec2c73c7276..c6f4d2a56c1 100644
--- a/eclass/llvm.org.eclass
+++ b/eclass/llvm.org.eclass
@@ -82,6 +82,13 @@ inherit multiprocessing
 # @DESCRIPTION:
 # List of additional components needed for tests.
 
+# @ECLASS-VARIABLE: LLVM_MANPAGES
+# @DEFAULT_UNSET
+# @DESCRIPTION:
+# Set to 'build', include the dependency on dev-python/sphinx to build
+# the manpages.  If set to 'pregenerated', fetch and install
+# pregenerated manpages from the archive.
+
 
 # == global scope logic ==
 
@@ -118,6 +125,26 @@ llvm.org_set_globals() {
 		RESTRICT+=" !test? ( test )"
 	fi
 
+	case ${LLVM_MANPAGES:-__unset__} in
+		__unset__)
+			# no manpage support
+			;;
+		build)
+			IUSE+=" doc"
+			# NB: this is not always the correct dep but it does no harm
+			BDEPEND+=" dev-python/sphinx"
+			;;
+		pregenerated)
+			IUSE+=" doc"
+			SRC_URI+="
+				!doc? (
+					https://dev.gentoo.org/~mgorny/dist/llvm/llvm-${PV}-manpages.tar.bz2
+				)"
+			;;
+		*)
+			die "Invalid LLVM_MANPAGES=${LLVM_MANPAGES}"
+	esac
+
 	# === useful defaults for cmake-based packages ===
 
 	# least intrusive of all
@@ -204,3 +231,23 @@ llvm.org_src_prepare() {
 get_lit_flags() {
 	echo "-vv;-j;${LIT_JOBS:-$(makeopts_jobs "${MAKEOPTS}" "$(get_nproc)")}"
 }
+
+# @FUNCTION: llvm_are_manpages_built
+# @DESCRIPTION:
+# Return true (0) if manpages are going to be built from source,
+# false (1) if preinstalled manpages will be used.
+llvm_are_manpages_built() {
+	use doc || [[ ${LLVM_MANPAGES} == build ]]
+}
+
+# @FUNCTION: llvm_install_manpages
+# @DESCRIPTION:
+# Install pregenerated manpages if available.  No-op otherwise.
+llvm_install_manpages() {
+	# install pre-generated manpages
+	if ! llvm_are_manpages_built; then
+		# (doman does not support custom paths)
+		insinto "/usr/lib/llvm/${SLOT}/share/man/man1"
+		doins "${WORKDIR}/llvm-${PV}-manpages/${LLVM_COMPONENTS[0]}"/*.1
+	fi
+}