Add doc USE flag to build documentation and man pages.

(Portage version: 2.2_rc47/cvs/Linux x86_64)

3 files changed, 33 insertions, 6 deletions

diff --git a/dev-util/perf/ChangeLog b/dev-util/perf/ChangeLog
index 88d4420fd75e..695e29c911bd 100644
--- a/dev-util/perf/ChangeLog
+++ b/dev-util/perf/ChangeLog
@@ -1,6 +1,10 @@
 # ChangeLog for dev-util/perf
 # Copyright 1999-2009 Gentoo Foundation; Distributed under the GPL v2
-# $Header: /var/cvsroot/gentoo-x86/dev-util/perf/ChangeLog,v 1.2 2009/10/30 22:18:21 flameeyes Exp $
+# $Header: /var/cvsroot/gentoo-x86/dev-util/perf/ChangeLog,v 1.3 2009/10/31 11:58:37 flameeyes Exp $
+
+  31 Oct 2009; Diego E. Pettenò <flameeyes@gentoo.org>
+  perf-2.6.32_rc5.ebuild, metadata.xml:
+  Add doc USE flag to build documentation and man pages.
 
 *perf-2.6.32_rc5 (30 Oct 2009)
 
diff --git a/dev-util/perf/metadata.xml b/dev-util/perf/metadata.xml
index a946a6d4dd47..184e9c89c93c 100644
--- a/dev-util/perf/metadata.xml
+++ b/dev-util/perf/metadata.xml
@@ -12,5 +12,12 @@
       package will have to be rebuilt after every version bump of
       binutils.
     </flag>
+    <flag name="doc">
+      Build documentation and man pages. With thise USE flag disabled,
+      the --help parameter for perf and its sub-tools will not be
+      available. This is optional because it depends on a few
+      documentation handling tools that are not always welcome on user
+      systems.
+    </flag>
   </use>
 </pkgmetadata>
diff --git a/dev-util/perf/perf-2.6.32_rc5.ebuild b/dev-util/perf/perf-2.6.32_rc5.ebuild
index 0016a26ab2a1..58b523f4a740 100644
--- a/dev-util/perf/perf-2.6.32_rc5.ebuild
+++ b/dev-util/perf/perf-2.6.32_rc5.ebuild
@@ -1,6 +1,6 @@
 # Copyright 1999-2009 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
-# $Header: /var/cvsroot/gentoo-x86/dev-util/perf/perf-2.6.32_rc5.ebuild,v 1.2 2009/10/30 22:30:51 flameeyes Exp $
+# $Header: /var/cvsroot/gentoo-x86/dev-util/perf/perf-2.6.32_rc5.ebuild,v 1.3 2009/10/31 11:58:37 flameeyes Exp $
 
 EAPI=2
 
@@ -28,11 +28,12 @@ SRC_URI="${SRC_URI} mirror://kernel/linux/kernel/v$(get_version_component_range
 LICENSE="GPL-2"
 SLOT="0"
 KEYWORDS="~amd64"
-IUSE="+demangle"
+IUSE="+demangle +doc"
 
 RDEPEND="demangle? ( sys-devel/binutils )
 	dev-libs/elfutils"
-DEPEND="${RDEPEND}"
+DEPEND="${RDEPEND}
+	doc? ( app-text/asciidoc app-text/xmlto )"
 
 if [[ -n ${LINUX_PATH} ]]; then
 	DEPEND="${DEPEND}
@@ -93,6 +94,12 @@ src_compile() {
 		prefix="/usr" bindir_relative="sbin" \
 		CFLAGS_OPTIMIZE="${CFLAGS}" \
 		LDFLAGS_OPTIMIZE="${LDFLAGS}" || die
+
+	if use doc; then
+		pushd Documentation
+		emake ${makeargs} || die
+		popd
+	fi
 }
 
 src_test() {
@@ -104,9 +111,18 @@ src_install() {
 	dosbin perf || die
 
 	dodoc CREDITS || die
+
+	if use doc; then
+		dodoc Documentation/*.txt || die
+		dohtml Documentation/*.html || die
+		doman Documentation/*.1 || die
+	fi
 }
 
 pkg_postinst() {
-	elog "We currently provide no documentation with perf; we're sorry"
-	elog "but there will be no man page nor --help output."
+	if ! use doc; then
+		elog "Without the doc USE flag you won't get any documentation nor man pages."
+		elog "And without man pages, you won't get any --help output for perf and its"
+		elog "sub-tools."
+	fi
 }