5 files changed, 161 insertions, 0 deletions
diff --git a/dev-util/gtk-doc/Manifest b/dev-util/gtk-doc/Manifest
new file mode 100644
index 000000000000..cff79f5d0976
--- /dev/null
+++ b/dev-util/gtk-doc/Manifest
@@ -0,0 +1,7 @@
+AUX 61gtk-doc-gentoo.el 283 SHA256 211c75484f2a4651a1e65a00c066640c3bf782030cfff5872a7af51bafd027c8 SHA512 d9e7c8bacd97a5147dbbe9ad568323356c9c38ad982ce88c63ef5f8e3955289274393a91e07d2159c082ac2a058455a1905c251ff3676f60bad596379fb12837 WHIRLPOOL ad0c1b52f70ef49c007c5b59849fa247cee94523cf9c95f4f0a07433250322dcdd5e67f13d3f2f48810ad4fbdf2a23be236f183082c713fb0ca26eedd607d118
+AUX gtk-doc-1.8-emacs-keybindings.patch 582 SHA256 e81eb1d06c489e19567277c9a14d84122025b0184e8773db2d421ab074fc8b38 SHA512 360e97c0d2603c17dd1c1ca92739eb5ac229f3bcda6dc76267b95cac73db1008a52164ac9cba5a0e43f7b6359b5e6d3b242fde757fa1b7409051bade5f6f35a6 WHIRLPOOL dd5c595f0c1aa6b736060f334c5f3c166b3a5efd7d56c15ed4cc52021fd231ec2daeddf1f1819b927b08ead8150710c1edb06399ec1a9183e74f162e3af90b47
+DIST gtk-doc-1.25.tar.xz 673184 SHA256 1ea46ed400e6501f975acaafea31479cea8f32f911dca4dff036f59e6464fd42 SHA512 7ac8c73ab9f9ecb6a142bd2232450a6431c3e4fe2372ff40460145b5d0bcffa1953c8cf49436539db86c3a32461cbd4180c714cb19cdd68bfd557816b789339c WHIRLPOOL 6e1acc14d6d034a8c42af36fef866da9805043b15e49fe1bf3dbe484bf8970b1f3f005c28ec390ab6b6914ae8c22864b59c864bc3d50aada09e9dac5ee850a70
+EBUILD gtk-doc-1.25-r1.ebuild 2591 SHA256 85b9e02c5068a596cbfb3d8ee712701e6a23a4c02fc2bfe3493179bb5353be88 SHA512 0fb36786bccc6d31b14cd47fbcd2c5f17728cb993b98d1e1406fd75fb0a37041aad8f385e9b27f0960903d033fdb240ebbb6eb744f9df216f1c04bb4365d2b06 WHIRLPOOL 4fe915dc4e7babc2fecd1991754b7b715d04104cfcf0e3a8b26cedddcb0ea0dd3790fe5d7933b2817361fc3588f6f03223978b50c4506e9a24bc75fa7d1e1802
+MISC ChangeLog 4938 SHA256 8cc9916e1764cc908cdec6f1ec71cf9b738ac031252b65e27da740d77aeb9340 SHA512 4963944e27d1a1772684f6f1d12f0a70762451cea6833a6218bbcc452339fec3fd9e6a4c2157c04099958363fff48af1ade31718e6997b8fc5f000ee67bbb9af WHIRLPOOL 4cbad59e81b397d3175f8bf890470799ba85e681872e7f27074c5cfcb78d490218d48ccf39cb308e8b263ad116b7681fc2fcf0ed4c0ad9e561bf5c617898ff33
+MISC ChangeLog-2015 30414 SHA256 6f56079b34f97086e52c8cae697824f2999d73a18a13611ef1fb503bb878f340 SHA512 385886987e285f5e6513cc1c0e1defe413013be0e6fe128acb9c1edd6d1cfff40195987138f7d56c9ffb00bcc38c5b95d1422436aeca8b30d6fda060cb4d729d WHIRLPOOL 97cac0992ad48fd93d6efa837866dcb1f706a92a7107a5d6e89fa83a8c3200101703df03410e0c25ef3aa4aba7fc9dfdc5124445ea4cb6f7e3737cab4ed27ac3
+MISC metadata.xml 659 SHA256 ec1b198ef72d475bfa7d84ce3f82920519c5d1fe6a90739f535f9518b8deb615 SHA512 4ffcd239d0a5788ed94a204395a51d8b706663ac69139965e7d28282c473b55cd006cf3786a3cfd60386439f9ffa5d9242ed43ba05783962cbac002f8a00539b WHIRLPOOL 9a8e7814130c16bb4160419af669400aee6868e35d5228665309634d98278ec06fb1c7a47f027d930aea9a351a25e3b509b558c57bd98e5e4bce9d851de97e44
diff --git a/dev-util/gtk-doc/files/61gtk-doc-gentoo.el b/dev-util/gtk-doc/files/61gtk-doc-gentoo.el
new file mode 100644
index 000000000000..488a57c02555
--- /dev/null
+++ b/dev-util/gtk-doc/files/61gtk-doc-gentoo.el
@@ -0,0 +1,9 @@
+
+;;; gtk-doc site-lisp configuration
+
+(add-to-list 'load-path "@SITELISP@")
+
+(autoload 'gtk-doc-insert "gtk-doc"
+  "Add a documentation header to the current function." t)
+(autoload 'gtk-doc-insert-section "gtk-doc"
+  "Add a section documentation header at the current position." t)
diff --git a/dev-util/gtk-doc/files/gtk-doc-1.8-emacs-keybindings.patch b/dev-util/gtk-doc/files/gtk-doc-1.8-emacs-keybindings.patch
new file mode 100644
index 000000000000..bbc989afb2b7
--- /dev/null
+++ b/dev-util/gtk-doc/files/gtk-doc-1.8-emacs-keybindings.patch
@@ -0,0 +1,17 @@
+--- gtk-doc-1.8-orig/tools/gtk-doc.el	2007-01-03 16:04:14.000000000 +0100
++++ gtk-doc-1.8/tools/gtk-doc.el	2007-07-29 21:56:45.000000000 +0200
+@@ -262,7 +262,7 @@
+ 
+ ;; set global binding for this key (follows the format for
+ ;;   creating a changelog entry ...)
+-(global-set-key "\C-x4h"  'gtk-doc-insert)
++;;(global-set-key "\C-x4h"  'gtk-doc-insert)
+ 
+ 
+ ;; Define another function for inserting a section header.
+@@ -280,4 +280,4 @@
+ 	  " */\n"))
+ 
+ ;; Set the key binding.
+-(global-set-key "\C-x4s" 'gtk-doc-insert-section)
++;;(global-set-key "\C-x4s" 'gtk-doc-insert-section)
diff --git a/dev-util/gtk-doc/gtk-doc-1.25-r1.ebuild b/dev-util/gtk-doc/gtk-doc-1.25-r1.ebuild
new file mode 100644
index 000000000000..002cb3d2d718
--- /dev/null
+++ b/dev-util/gtk-doc/gtk-doc-1.25-r1.ebuild
@@ -0,0 +1,109 @@
+# Copyright 1999-2017 Gentoo Foundation
+# Distributed under the terms of the GNU General Public License v2
+
+EAPI=6
+PYTHON_COMPAT=( python2_7 )
+
+inherit eutils elisp-common gnome2 python-single-r1 readme.gentoo-r1
+
+DESCRIPTION="GTK+ Documentation Generator"
+HOMEPAGE="https://www.gtk.org/gtk-doc/"
+
+LICENSE="GPL-2 FDL-1.1"
+SLOT="0"
+KEYWORDS="alpha amd64 arm ~arm64 hppa ia64 ~m68k ~mips ppc ppc64 ~s390 ~sh sparc x86 ~amd64-fbsd ~sparc-fbsd ~x86-fbsd ~amd64-linux ~x86-linux ~ppc-macos ~x86-macos ~sparc-solaris ~x64-solaris"
+
+IUSE="debug doc emacs highlight vim"
+REQUIRED_USE="${PYTHON_REQUIRED_USE}"
+
+RDEPEND="
+	${PYTHON_DEPS}
+	>=dev-libs/glib-2.6:2
+	>=dev-lang/perl-5.18
+	dev-libs/libxslt
+	>=dev-libs/libxml2-2.3.6:2
+	~app-text/docbook-xml-dtd-4.3
+	app-text/docbook-xsl-stylesheets
+	~app-text/docbook-sgml-dtd-3.0
+	>=app-text/docbook-dsssl-stylesheets-1.40
+	emacs? ( virtual/emacs )
+	highlight? (
+		vim? ( || ( app-editors/vim app-editors/gvim ) )
+		!vim? ( dev-util/source-highlight )
+	)
+"
+DEPEND="${RDEPEND}
+	~dev-util/gtk-doc-am-${PV}
+	app-text/yelp-tools
+	virtual/pkgconfig
+"
+
+pkg_setup() {
+	DOC_CONTENTS="gtk-doc does no longer define global key bindings for Emacs.
+		You may set your own key bindings for \"gtk-doc-insert\" and
+		\"gtk-doc-insert-section\" in your ~/.emacs file."
+	SITEFILE=61${PN}-gentoo.el
+	python-single-r1_pkg_setup
+}
+
+src_prepare() {
+	# Remove global Emacs keybindings, bug #184588
+	eapply "${FILESDIR}"/${PN}-1.8-emacs-keybindings.patch
+
+	gnome2_src_prepare
+}
+
+src_configure() {
+	local myconf
+	if use vim; then
+		myconf="${myconf} $(use_with highlight highlight vim)"
+	else
+		myconf="${myconf} $(use_with highlight highlight source-highlight)"
+	fi
+
+	gnome2_src_configure \
+		--with-xml-catalog="${EPREFIX}"/etc/xml/catalog \
+		$(use_enable debug) \
+		${myconf}
+}
+
+src_compile() {
+	gnome2_src_compile
+	use emacs && elisp-compile tools/gtk-doc.el
+}
+
+src_install() {
+	gnome2_src_install
+
+	python_fix_shebang "${ED}"/usr/bin/gtkdoc-depscan
+
+	# Don't install those files, they are in gtk-doc-am now
+	rm "${ED}"/usr/share/aclocal/gtk-doc.m4 || die "failed to remove gtk-doc.m4"
+	rm "${ED}"/usr/bin/gtkdoc-rebase || die "failed to remove gtkdoc-rebase"
+
+	if use doc; then
+		docinto doc
+		dodoc doc/*
+		docinto examples
+		dodoc examples/*
+	fi
+
+	if use emacs; then
+		elisp-install ${PN} tools/gtk-doc.el*
+		elisp-site-file-install "${FILESDIR}/${SITEFILE}"
+		readme.gentoo_create_doc
+	fi
+}
+
+pkg_postinst() {
+	gnome2_pkg_postinst
+	if use emacs; then
+		elisp-site-regen
+		readme.gentoo_print_elog
+	fi
+}
+
+pkg_postrm() {
+	gnome2_pkg_postrm
+	use emacs && elisp-site-regen
+}
diff --git a/dev-util/gtk-doc/metadata.xml b/dev-util/gtk-doc/metadata.xml
new file mode 100644
index 000000000000..1a3871ad27fb
--- /dev/null
+++ b/dev-util/gtk-doc/metadata.xml
@@ -0,0 +1,19 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
+<pkgmetadata>
+<maintainer type="project">
+	<email>gnome@gentoo.org</email>
+	<name>Gentoo GNOME Desktop</name>
+</maintainer>
+<use>
+	<flag name="highlight">Enable source code highlighting</flag>
+	<flag name="vim">Enable source code highlighting through
+	<pkg>app-editors/vim</pkg></flag>
+</use>
+<longdescription lang="en">
+	GTK-Doc is used to document C code.
+	It is typically used to document the public API of libraries,
+	such as the GTK+ and GNOME libraries, but it can also be used
+	to document application code.
+</longdescription>
+</pkgmetadata>