commit: f5dde25bf996f0623b1769a226fd72ea6fff2b61
parent 263a17385423a2f029c98d0ba48f1292e73367b3
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Sun, 27 Jun 2021 10:23:09 +0200
dev-util/gtk-doc: Superseeded by gentoo
Diffstat:
6 files changed, 0 insertions(+), 331 deletions(-)
diff --git a/dev-util/gtk-doc/Manifest b/dev-util/gtk-doc/Manifest
@@ -1 +0,0 @@
-DIST gtk-doc-1.32.tar.xz 762000 BLAKE2B e87b0ed5dffd04acc7569171343839a742a874438248546b1b85ca71102d5a546f41b450c5cedf54ecab5b7b6585a4dac36d7600b21b5cce491470a50f82d3b0 SHA512 6d28395968c2951f1685570e5778b5add76d1b9cff8fcb8632b200b3ba251602a1ea59b1def84fc28560988b87fc0dbbc6947af88d268db6ff23e9c28aea3b28
diff --git a/dev-util/gtk-doc/files/1.32-deprecation-parse-fixes.patch b/dev-util/gtk-doc/files/1.32-deprecation-parse-fixes.patch
@@ -1,180 +0,0 @@
-From 2667d8cd95a2a29c35c1bb8f4629c22fd0aa98e9 Mon Sep 17 00:00:00 2001
-From: Xavier Claessens <xavier.claessens@collabora.com>
-Date: Thu, 2 Jan 2020 21:56:10 -0500
-Subject: [PATCH 1/3] Skip G_GNUC_(BEGIN|END)_IGNORE_DEPRECATIONS lines
-
-For some reason, glib has to put empty line before and after each of
-these lines otherwise the symbol following it is undeclared.
----
- gtkdoc/scan.py | 5 +++++
- 1 file changed, 5 insertions(+)
-
-diff --git a/gtkdoc/scan.py b/gtkdoc/scan.py
-index d04d4d4..7de08ad 100644
---- a/gtkdoc/scan.py
-+++ b/gtkdoc/scan.py
-@@ -561,6 +561,11 @@ def ScanHeaderContent(input_lines, decl_list, get_types, options):
- logging.info('Found start of comment: %s', line.strip())
- continue
-
-+ # Skip begin/end deprecation macros.
-+ m = re.search(r'^\s*G_GNUC_(BEGIN|END)_IGNORE_DEPRECATIONS', line)
-+ if m:
-+ continue
-+
- logging.info('no decl: %s', line.strip())
-
- cm = [m.match(line) for m in CLINE_MATCHER]
---
-2.20.1
-
-
-From 9e58548688c9768cf41c59ccef531d438ffb2504 Mon Sep 17 00:00:00 2001
-From: Xavier Claessens <xavier.claessens@collabora.com>
-Date: Fri, 3 Jan 2020 06:47:47 -0500
-Subject: [PATCH 2/3] typedef can be followed by decorator
-
----
- gtkdoc/scan.py | 30 +++++++++++++++++-------------
- 1 file changed, 17 insertions(+), 13 deletions(-)
-
-diff --git a/gtkdoc/scan.py b/gtkdoc/scan.py
-index 7de08ad..5a5da92 100644
---- a/gtkdoc/scan.py
-+++ b/gtkdoc/scan.py
-@@ -96,19 +96,8 @@ CLINE_MATCHER = [
- (struct|union)\s*
- \w*\s*{""", re.VERBOSE),
- # 12-14: OTHER TYPEDEFS
-- re.compile(
-- r"""^\s*typedef\s+
-- (?:struct|union)\s+\w+[\s\*]+
-- (\w+) # 1: name
-- \s*;""", re.VERBOSE),
-- re.compile(
-- r"""^\s*
-- (?:G_GNUC_EXTENSION\s+)?
-- typedef\s+
-- (.+[\s\*]) # 1: e.g. 'unsigned int'
-- (\w+) # 2: name
-- (?:\s*\[[^\]]+\])*
-- \s*;""", re.VERBOSE),
-+ None, # in InitScanner()
-+ None, # in InitScanner()
- re.compile(r'^\s*typedef\s+'),
- # 15: VARIABLES (extern'ed variables)
- None, # in InitScanner()
-@@ -267,6 +256,21 @@ def InitScanner(options):
- %s # 3: optional decorator
- \s*;""" % optional_decorators_regex, re.VERBOSE)
- # OTHER TYPEDEFS
-+ CLINE_MATCHER[12] = re.compile(
-+ r"""^\s*typedef\s+
-+ (?:struct|union)\s+\w+[\s\*]+
-+ (\w+) # 1: name
-+ %s # 2: optional decorator
-+ \s*;""" % optional_decorators_regex, re.VERBOSE)
-+ CLINE_MATCHER[13] = re.compile(
-+ r"""^\s*
-+ (?:G_GNUC_EXTENSION\s+)?
-+ typedef\s+
-+ (.+?[\s\*]) # 1: e.g. 'unsigned int'
-+ (\w+) # 2: name
-+ (?:\s*\[[^\]]+\])*
-+ %s # 3: optional decorator
-+ \s*;""" % optional_decorators_regex, re.VERBOSE)
- CLINE_MATCHER[15] = re.compile(
- r"""^\s*
- (?:extern|[A-Za-z_]+VAR%s)\s+
---
-2.20.1
-
-
-From 5bfe23f0257e1b4c6c9a4e3a2dbb180455f753f2 Mon Sep 17 00:00:00 2001
-From: Jason Crain <jason@inspiresomeone.us>
-Date: Mon, 6 Jan 2020 19:05:42 -0700
-Subject: [PATCH 3/3] scan: support deprecated struct members
-
-gcc allows deprecating members of structs. For example:
-
-struct data {
- int x G_GNUC_DEPRECATED_FOR(replacement);
-};
-
-However, this currently causes the entire struct to be marked as
-deprecated and confuses mkdb because it doesn't understand the
-G_GNUC_DEPRECATED_FOR symbol.
-
-Fix this by having the whole struct only be marked as deprecated if the
-'_DEPRECATED' is after the closing bracket of the struct, similar to how
-it already does for enums, and having scan automatically remove all
-G_GNUC_* decorators from struct members, similar to how it already does
-for functions.
----
- gtkdoc/scan.py | 12 ++++++++++--
- tests/scan.py | 17 +++++++++++++++++
- 2 files changed, 27 insertions(+), 2 deletions(-)
-
-diff --git a/gtkdoc/scan.py b/gtkdoc/scan.py
-index 5a5da92..6c6534a 100644
---- a/gtkdoc/scan.py
-+++ b/gtkdoc/scan.py
-@@ -538,7 +538,7 @@ def ScanHeaderContent(input_lines, decl_list, get_types, options):
- # section (#endif /* XXX_DEPRECATED */
- if deprecated_conditional_nest == 0 and '_DEPRECATED' in line:
- m = re.search(r'^\s*#\s*(if*|define|endif)', line)
-- if not (m or in_declaration == 'enum'):
-+ if not (m or in_declaration == 'enum' or in_declaration == 'struct'):
- logging.info('Found deprecation annotation (decl: "%s"): "%s"',
- in_declaration, line.strip())
- deprecated_conditional_nest += 0.1
-@@ -953,9 +953,17 @@ def ScanHeaderContent(input_lines, decl_list, get_types, options):
- title = '<TITLE>%s</TITLE>' % objectname
-
- logging.info('Store struct: "%s"', symbol)
-+ # Structs could contain deprecated members and that doesn't
-+ # mean the whole struct is deprecated, so they are ignored when
-+ # setting deprecated_conditional_nest above. Here we can check
-+ # if the _DEPRECATED is between '}' and ';' which would mean
-+ # the struct as a whole is deprecated.
-+ if re.search(r'\n\s*\}.*_DEPRECATED.*;\s*$', decl):
-+ deprecated = '<DEPRECATED/>\n'
- if AddSymbolToList(slist, symbol):
- structsym = in_declaration.upper()
-- stripped_decl = re.sub('(%s)' % optional_decorators_regex, '', decl)
-+ regex = r'(?:\s+(?:G_GNUC_\w+(?:\(\w*\))?%s))' % ignore_decorators
-+ stripped_decl = re.sub(regex, '', decl)
- decl_list.append('<%s>\n<NAME>%s</NAME>\n%s%s</%s>\n' %
- (structsym, symbol, deprecated, stripped_decl, structsym))
- if symbol in forward_decls:
-diff --git a/tests/scan.py b/tests/scan.py
-index ad63541..6d608b6 100755
---- a/tests/scan.py
-+++ b/tests/scan.py
-@@ -552,6 +552,23 @@ class ScanHeaderContentStructs(ScanHeaderContentTestCase):
- slist, doc_comments = self.scanHeaderContent([header])
- self.assertDecl('data', expected, slist)
-
-+ def test_HandleDeprecatedMemberDecorator(self):
-+ """Struct with deprecated members."""
-+ header = textwrap.dedent("""\
-+ struct data {
-+ int x1 G_GNUC_DEPRECATED;
-+ int x2 G_GNUC_DEPRECATED_FOR(replacement);
-+ };""")
-+ expected = textwrap.dedent("""\
-+ struct data {
-+ int x1;
-+ int x2;
-+ };""")
-+ scan.InitScanner(self.options)
-+ slist, doc_comments = self.scanHeaderContent(
-+ header.splitlines(keepends=True))
-+ self.assertDecl('data', expected, slist)
-+
-
- class ScanHeaderContentUnions(ScanHeaderContentTestCase):
- """Test parsing of union declarations."""
---
-2.20.1
-
diff --git a/dev-util/gtk-doc/files/61gtk-doc-gentoo.el b/dev-util/gtk-doc/files/61gtk-doc-gentoo.el
@@ -1,9 +0,0 @@
-
-;;; 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
@@ -1,17 +0,0 @@
---- 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.32-r2.ebuild b/dev-util/gtk-doc/gtk-doc-1.32-r2.ebuild
@@ -1,110 +0,0 @@
-# Copyright 1999-2019 Gentoo Authors
-# Distributed under the terms of the GNU General Public License v2
-
-EAPI=6
-PYTHON_COMPAT=( python3_{7,8,9} )
-
-inherit eutils elisp-common gnome2 python-single-r1 readme.gentoo-r1
-
-DESCRIPTION="GTK+ Documentation Generator"
-HOMEPAGE="https://gitlab.gnome.org/GNOME/gtk-doc"
-
-LICENSE="GPL-2 FDL-1.1"
-SLOT="0"
-KEYWORDS="~alpha ~amd64 ~arm ~arm64 ~hppa ~ia64 ~m68k ~mips ~ppc ~ppc64 ~s390 ~sparc ~x86 ~amd64-linux ~x86-linux ~ppc-macos ~sparc-solaris ~x64-solaris"
-
-IUSE="debug doc emacs pdf test"
-REQUIRED_USE="${PYTHON_REQUIRED_USE}"
-
-RDEPEND="
- ${PYTHON_DEPS}
- dev-libs/libxslt
- dev-libs/libxml2
- app-text/docbook-xsl-stylesheets
- $(python_gen_cond_dep '
- dev-python/pygments[${PYTHON_MULTI_USEDEP}]
- ')
- doc? ( app-text/yelp-tools )
- emacs? ( virtual/emacs )
- pdf? (
- || (
- app-text/dblatex
- dev-java/fop
- )
- )
- test? ( >=dev-libs/glib-2.38.0:2 )
-"
-DEPEND="${RDEPEND}
- ~dev-util/gtk-doc-am-${PV}
- dev-util/itstool
- 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
-
- # Apply upstream commit 1baf9a6, bug #646850
- sed -e '1,/exit 1/s/exit 1/exit $1/' \
- -i gtkdoc-mkpdf.in || die
-
- # Fix dev-libs/glib[gtk-doc] doc generation tests by fixing stuff surrounding deprecations
- # https://gitlab.gnome.org/GNOME/glib/-/merge_requests/1488
- eapply "${FILESDIR}"/${PV}-deprecation-parse-fixes.patch
-
- gnome2_src_prepare
-}
-
-src_configure() {
- gnome2_src_configure \
- $(use_enable debug)
-}
-
-src_compile() {
- gnome2_src_compile
- use emacs && elisp-compile tools/gtk-doc.el
-}
-
-src_install() {
- gnome2_src_install
-
- python_fix_shebang "${ED}"/usr/bin/
-
- 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
-}
-
-src_test() {
- emake -j1 check
-}
-
-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
@@ -1,14 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE pkgmetadata SYSTEM "http://www.gentoo.org/dtd/metadata.dtd">
-<pkgmetadata>
- <maintainer type="person">
- <email>contact@hacktivis.me</email>
- <name>Haelwenn (lanodan) Monnier</name>
- </maintainer>
- <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>
