gentoo-overlay/metadata/install-qa-check.d/60gtk-doc-paths

# Copyright 1999-2022 Gentoo Authors
# Distributed under the terms of the GNU General Public License v2

# QA check: ensure that gtk-doc files are installed in /usr/share/gtk-doc
# Maintainer: GNOME team <gnome@gentoo.org>

gtk_doc_path_check() {
	[[ -d ${ED%/}/usr/share/doc ]] || return

	local found=() f
	while read -d '' -r f; do
		found+=( "${f%/*}" )
	done < <(find "${ED%/}"/usr/share/doc -name '*.devhelp*' -print0 || die)

	if [[ ${found[@]} ]]; then
		eqawarn
		eqawarn "QA Notice: This package seems to install gtk-doc documentation into the"
		eqawarn "following location(s):"
		eqawarn
		eqatag -v gtk-doc-paths.invalid-path "${found[@]#${D%/}}"
		eqawarn
		eqawarn "gtk-doc documentation must always be installed into ${EPREFIX}/usr/share/gtk-doc."
		eqawarn "For more details, please see the GNOME team policy page:"
		eqawarn "https://wiki.gentoo.org/wiki/Project:GNOME/Gnome_Team_Ebuild_Policies#Handling_gtk-doc_documentation"
		eqawarn
	fi
}

gtk_doc_path_check
: # guarantee successful exit

# vim:ft=sh