media-sound/pulseaudio: Import version from pending PR (mostly)

I enforce doxygen as BDEPEND and dropped some unused metadata.xml
entries repoman complained about.

Package-Manager: Portage-3.0.19, Repoman-3.0.3
Signed-off-by: Nils Freydank <holgersson@posteo.de>

media-sound/pulseaudio/Manifest

@@ -1 +1,2 @@
 DIST pulseaudio-14.2_p20210423.tar.gz 2720092 BLAKE2B 259a4019a02ddf7ad4a760b96e50124923a83f4e995c1f7ca242350b0875d09f0488e0c6002f1b20f107ef8a0f1763629acfca9d4c0ce4850893de53a36f41d3 SHA512 2910634d1ef46707e2fb116aa84fd1a994a746ee8c5d8f99224a1b05fa4db05ef336f5108b4fe94d509346775b06abc640f214c02e21b082dc32dd55f4cde341
+DIST pulseaudio-14.99.1.tar.xz 1512740 BLAKE2B 3c79c76b2a241e4b2cd49004421b3164d9281311b165e0622589c21753a74db9c5edf1ff9ec32bf5d54c376eefe2a5d08b34bc04bb090c0702dacd4cae8fa43e SHA512 3d34e5ea83f19accbe646a132c04d42d0a13cabafeaa3f4d1ae8094de2ad1f264663dca88dd4a048c1f875c9d9a614bbb83f79b2b05d41d4762bb924ec6d9dde

media-sound/pulseaudio/metadata.xml

@@ -17,7 +17,11 @@
       PulseAudio plugin enabled. This ensures that clients supporting
       ALSA only will use PulseAudio.
     </flag>
-    <flag name="daemon">place holder desc., short: use PA instead of pipewire</flag>
+    <flag name="daemon">Build the pulseaudio binary (not-needed for pipewire-pulse)</flag>
+    <flag name="elogind">Use <pkg>sys-auth/elogind</pkg> for giving each session a PA client</flag>
+    <flag name="gnome">
+      Enables clearing of unavailable devices from database files which is recommended for GNOME.
+    </flag>
     <flag name="oss">
       Enable OSS sink/source (output/input). Deprecated, upstream does
       not support this on systems where other sink/source systems are

media-sound/pulseaudio/pulseaudio-14.99.1.ebuild

@@ -0,0 +1,386 @@
+# Copyright 1999-2021 Gentoo Authors
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=7
+
+inherit meson bash-completion-r1 flag-o-matic gnome2-utils linux-info optfeature systemd toolchain-funcs udev multilib-minimal
+
+# When COMMIT is defined, this ebuild turns from a release into a snapshot ebuild:
+#COMMIT="d21d0d89a55af491bfc7b9f3a142554a4d7ec8be"
+# When COMMIT is defined, this enables a work-around for missing .tarball-version file:
+#_SNAPSHOT_FIX_GITVERSION=1
+
+DESCRIPTION="A networked sound server with an advanced plugin system"
+HOMEPAGE="https://www.freedesktop.org/wiki/Software/PulseAudio/"
+if [[ ${PV} = 9999 ]]; then
+	inherit git-r3
+	EGIT_BRANCH="master"
+	EGIT_REPO_URI="https://gitlab.freedesktop.org/${PN}/${PN}"
+else
+	if [[ -n ${COMMIT} ]]; then
+		SRC_URI="https://gitlab.freedesktop.org/${PN}/${PN}/-/archive/${COMMIT}/${PN}-${COMMIT}.tar.gz -> ${P}.tar.gz"
+		S="${WORKDIR}"/${PN}-${COMMIT}
+	else
+		SRC_URI="https://freedesktop.org/software/${PN}/releases/${P}.tar.xz"
+	fi
+	KEYWORDS="~alpha ~amd64 ~arm ~arm64 ~hppa ~ia64 ~ppc ~ppc64 ~sparc ~x86 ~amd64-linux ~x86-linux"
+fi
+# libpulse-simple and libpulse link to libpulse-core; this is daemon's
+# library and can link to gdbm and other GPL-only libraries. In this
+# cases, we have a fully GPL-2 package. Leaving the rest of the
+# GPL-forcing USE flags for those who use them.
+LICENSE="!gdbm? ( LGPL-2.1 ) gdbm? ( GPL-2 )"
+
+SLOT="0"
+
+# +alsa-plugin as discussed in bug #519530
+# TODO: Deal with bluez5-gstreamer
+# NOTE: Add tdb IUSE?
+# TODO: Find out why webrtc-aec is + prefixed - there's already the always available speexdsp-aec
+# NOTE: The current ebuild sets +X almost certainly just for the pulseaudio.desktop file
+IUSE="+alsa +alsa-plugin +asyncns bluetooth dbus +daemon doc elogind equalizer +gdbm gstreamer
+gnome +glib gtk ipv6 jack lirc native-headset ofono-headset +orc oss selinux sox ssl systemd
+system-wide tcpd test +udev +webrtc-aec +X zeroconf"
+
+RESTRICT="!test? ( test )"
+
+# See "*** BLUEZ support not found (requires D-Bus)" in configure.ac
+# Basically all IUSE are either ${MULTILIB_USEDEP} for client libs or they belong under !daemon ()
+# We duplicate alsa-plugin, {native,ofono}-headset under daemon to let users deal with them at once
+REQUIRED_USE="
+	alsa-plugin? ( alsa )
+	bluetooth? ( dbus )
+	daemon? ( ?? ( elogind systemd ) )
+	!daemon? (
+		!alsa
+		!alsa-plugin
+		!bluetooth
+		!equalizer
+		!gdbm
+		!gtk
+		!jack
+		!lirc
+		!native-headset
+		!ofono-headset
+		!orc
+		!oss
+		!sox
+		!ssl
+		!system-wide
+		!udev
+		!webrtc-aec
+		!zeroconf
+	)
+	equalizer? ( dbus )
+	native-headset? ( bluetooth )
+	ofono-headset? ( bluetooth )
+	udev? ( || ( alsa oss ) )
+	zeroconf? ( dbus )
+"
+
+# libpcre needed in some cases, bug #472228 # TODO: Read it
+RDEPEND="
+	|| (
+		virtual/libc
+		dev-libs/libpcre
+	)
+	>=media-libs/libsndfile-1.0.20[${MULTILIB_USEDEP}]
+	X? (
+		>=x11-libs/libxcb-1.6[${MULTILIB_USEDEP}]
+		daemon? (
+			>=x11-libs/libX11-1.4.0
+			x11-libs/libSM
+			x11-libs/libICE
+			>=x11-libs/libXtst-1.0.99.2
+		)
+	)
+	>=sys-libs/libcap-2.22-r2
+	alsa? ( >=media-libs/alsa-lib-1.0.24 )
+	glib? ( >=dev-libs/glib-2.26.0:2[${MULTILIB_USEDEP}] )
+	zeroconf? ( >=net-dns/avahi-0.6.12[dbus] )
+	jack? ( virtual/jack )
+	tcpd? ( sys-apps/tcp-wrappers[${MULTILIB_USEDEP}] )
+	lirc? ( app-misc/lirc )
+	dbus? ( >=sys-apps/dbus-1.4.12[${MULTILIB_USEDEP}] )
+	gtk? ( x11-libs/gtk+:3 )
+	bluetooth? (
+		>=net-wireless/bluez-5
+		media-libs/sbc
+	)
+	asyncns? ( >=net-libs/libasyncns-0.1[${MULTILIB_USEDEP}] )
+	udev? ( >=virtual/udev-143[hwdb(+)] )
+	equalizer? (
+		sci-libs/fftw:3.0
+	)
+	ofono-headset? ( >=net-misc/ofono-1.13 )
+	orc? ( >=dev-lang/orc-0.4.15 )
+	sox? ( >=media-libs/soxr-0.1.1 )
+	ssl? ( dev-libs/openssl:= )
+	media-libs/speexdsp[${MULTILIB_USEDEP}]
+	gdbm? ( sys-libs/gdbm:= )
+	webrtc-aec? ( >=media-libs/webrtc-audio-processing-0.2 )
+	elogind? ( sys-auth/elogind )
+	systemd? ( sys-apps/systemd:=[${MULTILIB_USEDEP}] )
+	daemon? (
+		dev-libs/libltdl[${MULTILIB_USEDEP}]
+		sys-kernel/linux-headers
+	)
+	selinux? ( sec-policy/selinux-pulseaudio )
+	gstreamer? (
+		media-libs/gst-plugins-base
+		>=media-libs/gstreamer-1.14
+	)
+" # Multilib libltdl is used during building but final binaries only link against native libltdl
+
+# This is not a mistake, the build system needs multilib libltdl to function
+DEPEND="${RDEPEND}
+	X? ( x11-base/xorg-proto )
+	dev-libs/libatomic_ops
+	dev-libs/libltdl[${MULTILIB_USEDEP}]
+"
+# This is a PDEPEND to avoid a circular dep
+# TODO: Verify that alsa-plugins actually needs matching ${MULTILIB_USEDEP}
+PDEPEND="
+	alsa? ( alsa-plugin? ( >=media-plugins/alsa-plugins-1.0.27-r1[pulseaudio,${MULTILIB_USEDEP}] ) )
+"
+
+# alsa-utils dep is for the alsasound init.d script (see bug 155707); TODO: read it
+# NOTE: if (e)logind is now mandatory, then the act-group/audio is needed only with system-wide
+RDEPEND="${RDEPEND}
+	system-wide? (
+		alsa? ( media-sound/alsa-utils )
+		acct-user/pulse
+		acct-group/audio
+		acct-group/pulse-access
+	)
+"
+
+BDEPEND="
+	app-doc/doxygen
+	orc? ( >=dev-lang/orc-0.4.15 )
+	system-wide? ( dev-util/unifdef )
+	test? ( >=dev-libs/check-0.9.10 )
+	sys-devel/gettext
+	sys-devel/m4
+	virtual/libiconv
+	virtual/libintl
+	virtual/pkgconfig
+"
+
+DOCS=( NEWS README ) # todo is useless to install
+
+pkg_pretend() {
+	if use daemon; then
+		CONFIG_CHECK="~HIGH_RES_TIMERS"
+		WARNING_HIGH_RES_TIMERS="CONFIG_HIGH_RES_TIMERS:\tis not set (required for enabling timer-based scheduling in pulseaudio)\n"
+		check_extra_config
+
+		if linux_config_exists; then
+			local snd_hda_prealloc_size=$(linux_chkconfig_string SND_HDA_PREALLOC_SIZE)
+			if [[ -n "${snd_hda_prealloc_size}" && "${snd_hda_prealloc_size}" -lt 2048 ]]; then
+				elog "For best experience with HDA devices set the pre-allocated"
+				elog "sound buffer to at least 2048 kB. The current value is:"
+				elog "\tCONFIG_SND_HDA_PREALLOC_SIZE=${snd_hda_prealloc_size}"
+			fi
+		fi
+	fi
+}
+
+pkg_setup() {
+	linux-info_pkg_setup
+	gnome2_environment_reset # bug 543364 # TODO: read it
+}
+
+src_prepare() {
+	default
+
+	if [[ -n ${COMMIT} ]]; then
+		# This file really should be upstream's responsibility but what can you do other than hack
+		# together a work-around for an upstream's tarball generator lacking required integration?
+		if [[ -n ${_SNAPSHOT_FIX_GITVERSION} && ${_SNAPSHOT_FIX_GITVERSION} -ge 1 ]]; then
+			echo ${PV%_*}-${COMMIT:0:8} > .tarball-version
+		fi
+	fi
+}
+
+meson_native_true() {
+	if multilib_is_native_abi; then
+		echo "-D${1}=true"
+	else
+		echo "-D${1}=false"
+	fi
+}
+
+meson_native_feature() {
+	# Example usage: $(meson_native_feature foo bar) -> -Dbar=enabled if foo is true
+	# and the native ABI is being configured, disabled otherwise; if bar is omitted,
+	# then bar is replaced with foo e.g. $(meson_native_feature foo) -> -Dfoo=enabled.
+	echo "-D${2:-${1}}=$(multilib_native_usex ${1} enabled disabled)"
+}
+
+multilib_src_configure() {
+	local emesonargs=(
+		-Dadrian-aec=false # Not packaged?
+		--localstatedir="${EPREFIX}"/var
+		-Dmodlibexecdir="${EPREFIX}/usr/$(get_libdir)/${P}"
+#		-Dsystemduserunitdir=$(systemd_get_userunitdir)
+		-Dudevrulesdir="$(get_udevdir)"/rules.d
+		-Dbashcompletiondir="$(get_bashcompdir)" # Alternatively DEPEND on app-shells/bash-completion for pkg-config to provide the value
+		$(meson_native_feature alsa)
+		$(meson_native_true bluetooth bluez5)
+		$(meson_native_true daemon)
+		$(meson_native_true native-headset bluez5-native-headset)
+		$(meson_native_true ofono-headset bluez5-ofono-headset)
+		$(meson_native_feature glib gsettings) # Supposedly correct?
+		$(meson_native_feature gstreamer)
+		$(meson_native_feature gtk)
+		$(meson_native_feature jack)
+		-Dsamplerate=disabled # Matches upstream
+		$(meson_native_feature lirc)
+		$(meson_native_feature orc)
+		$(meson_native_feature oss oss-output)
+		$(meson_native_feature ssl openssl)
+		# tests involve random modules, so just do them for the native # TODO: tests should run always
+		$(meson_native_true test tests)
+		$(meson_native_feature udev)
+		$(meson_native_feature webrtc-aec)
+		$(meson_native_feature zeroconf avahi)
+		$(meson_native_feature equalizer fftw)
+		$(meson_native_feature sox soxr)
+		-Ddatabase=$(multilib_native_usex gdbm gdbm simple) # TODO: tdb is also an option
+		$(meson_use gnome stream-restore-clear-old-devices) # TODO: Get ACK'ed on this
+		$(meson_feature glib)
+		$(meson_feature asyncns)
+		#$(meson_use cpu_flags_arm_neon neon-opt)
+		$(meson_feature tcpd tcpwrap) # TODO: system-wide specific?
+		$(meson_feature dbus)
+		$(meson_feature elogind)
+		$(meson_feature X x11)
+		$(meson_feature systemd)
+		$(meson_use ipv6)
+	)
+
+	if multilib_is_native_abi; then
+		# Make padsp work for non-native ABI, supposedly only possible with glibc; this is used by /usr/bin/padsp that comes from native build, thus we need this argument for native build
+		if use elibc_glibc; then
+			emesonargs+=( -Dpulsedsp-location="${EPREFIX}"'/usr/\\$$LIB/pulseaudio' )
+		fi
+	else
+		if ! use elibc_glibc; then
+			# Non-glibc multilib is probably non-existent but just in case:
+			ewarn "padsp wrapper for OSS emulation will only work with native ABI applications!"
+		fi
+	fi
+
+	meson_src_configure
+}
+
+multilib_src_compile() {
+	meson_src_compile
+
+	if multilib_is_native_abi; then
+		use doc && meson_src_compile doxygen
+	fi
+}
+
+multilib_src_test() {
+	# For on-native ABIs we build only the client libraries, which means that upstream disables
+	# almost all tests. On the upside the few remaining ones should work, so we can at least noew
+	# run the src_test phase for non-native ABIs, too.
+	meson_src_test
+}
+
+multilib_src_install() {
+	# The files referenced in the DOCS array do not exist in the multilib source directory,
+	# therefore clear the variable when calling the function that will access it.
+	DOCS= meson_src_install
+}
+
+multilib_src_install_all() {
+	# Now we can install the DOCS. ;)
+	einstalldocs
+
+	if use doc; then
+		# TODO: check it's installing into the right place
+		docinto html
+		dodoc -r doxygen/html/
+	fi
+
+	if use system-wide; then
+		newconfd "${FILESDIR}"/pulseaudio.conf.d pulseaudio
+
+		use_define() {
+			local define=${2:-$(echo $1 | tr '[:lower:]' '[:upper:]')}
+
+			use "$1" && echo "-D$define" || echo "-U$define"
+		}
+
+		unifdef $(use_define zeroconf AVAHI) \
+			$(use_define alsa) \
+			$(use_define bluetooth) \
+			$(use_define udev) \
+			"${FILESDIR}"/pulseaudio.init.d-5 \
+			> "${T}"/pulseaudio || die
+
+		doinitd "${T}"/pulseaudio
+
+		systemd_dounit "${FILESDIR}"/${PN}.service
+
+		# We need /var/run/pulse, bug 442852
+		systemd_newtmpfilesd "${FILESDIR}"/${PN}.tmpfiles ${PN}.conf
+	else
+		# Prevent warnings when system-wide is not used, bug 447694
+		if use dbus && use daemon; then
+			rm "${ED}"/etc/dbus-1/system.d/pulseaudio-system.conf || die
+		fi
+	fi
+
+	if use zeroconf; then
+		sed -e '/module-zeroconf-publish/s:^#::' \
+			-i "${ED}/etc/pulse/default.pa" || die
+	fi
+
+	find "${ED}" \( -name '*.a' -o -name '*.la' \) -delete || die
+}
+
+pkg_postinst() {
+	gnome2_schemas_update
+	if use system-wide; then
+		elog "You have enabled the 'system-wide' USE flag for pulseaudio."
+		elog "This mode should only be used on headless servers, embedded systems,"
+		elog "or thin clients. It will usually require manual configuration, and is"
+		elog "incompatible with many expected pulseaudio features."
+		elog "On normal desktop systems, system-wide mode is STRONGLY DISCOURAGED."
+		elog "For more information, see"
+		elog "    https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/WhatIsWrongWithSystemWide/"
+		elog "    https://www.freedesktop.org/wiki/Software/PulseAudio/Documentation/User/SystemWide/"
+		elog "    https://wiki.gentoo.org/wiki/PulseAudio#Headless_server"
+	fi
+
+	if use equalizer; then
+		elog "You will need to load some extra modules to make qpaeq work."
+		elog "You can do that by adding the following two lines in"
+		elog "/etc/pulse/default.pa and restarting pulseaudio:"
+		elog "load-module module-equalizer-sink"
+		elog "load-module module-dbus-protocol"
+	fi
+
+	if use native-headset && use ofono-headset; then
+		elog "You have enabled both native and ofono headset profiles. The runtime decision"
+		elog "which to use is done via the 'headset' argument of module-bluetooth-discover."
+	fi
+
+	if use systemd && use daemon; then
+		elog "It's recommended to start pulseaudio via its systemd user units:"
+		elog "systemctl --user enable pulseaudio.service pulseaudio.socket"
+		elog "The change from autospawn to user units will take effect after restarting."
+	fi
+
+	optfeature_header "PulseAudio can be enhanced by installing the following:"
+	use equalizer && optfeature "using the qpaeq script" dev-python/PyQt5[dbus,widgets]
+	use dbus && optfeature "restricted realtime capabilities vai D-Bus" sys-auth/rtkit
+}
+
+pkg_postrm() {
+	gnome2_schemas_update
+}