pkgsrc/textproc/gtk-doc/Makefile

47 lines
1.7 KiB
Makefile
Raw Normal View History

2020-03-08 17:47:24 +01:00
# $NetBSD: Makefile,v 1.81 2020/03/08 16:48:14 wiz Exp $
DISTNAME= gtk-doc-1.32
2020-03-08 17:47:24 +01:00
PKGREVISION= 2
CATEGORIES= textproc gnome
MASTER_SITES= ${MASTER_SITE_GNOME:=sources/gtk-doc/${PKGVERSION_NOREV}/}
Update to 1.20. Add some dependencies so that gtk-depscan runs. Mark as not ready for python-3.x. GTK-Doc 1.20 (Feb 16 2014) ============ Important notice - starting with the next release these long deprecated features will be removed, please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-scanobj (only used for gtkobject) o return values need to be documented using "Returns:". We will remove the heuristic that turns a paragraph starting with "Returns " into return docs. o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 605537 : Returns: listed among parameters o 624001 : Support attribute-based method to deprecate symbols o 662424 : Class hierarchy about interfaces not generated by default o 665926 : should not have to document object structures o 666509 : Specifying --enable-gtk-doc should not be required to build source packages o 669417 : Duplicate IDs generated for unions registered as boxed types o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command o 692367 : gtkdocize should take a srcdir argument o 696570 : style updates o 697940 : Race condition between setup-build.stamp and scan-build.stamp o 701259 : /bin/bash: -chmod: command not found o 701638 : Support automake parallel test harness (fix error with GTKDOC_CHECK) o 706404 : Minor bug in gtkdoc-mkdb o 706438 : Empty lines added at the beginning and at the end of a programlisting o 707426 : master is broken in picking up flavour from configure.ac o 707717 : Support " Deprecated: X.Y " o 708268 : New *-insensitive.png files are not distributes o 710478 : gtkdoc-mkdb: Don't complain about annotations with hyphen o 711111 : gtkdoc-mkdb: sort entries in the glossary o 711598 : gtkdoc-scan doesn't ignore decorators containing parentheses o 719644 : docs: make yelp usage conditional in manual o 719645 : configure: emit message when looking for yelp o 720061 : make: create subdirectories of the content_files to the builddir o 721228 : configure: search for xml catalog in XDG_DATA_DIRS o 722479 : cp -u is not portable o 723118 : Mark |[ blocks as CDATA o 723288 : Fix MarkDown support o 723417 : New MarkDown parser o 723696 : Add support for blockquote o 723812 : Add support for reference links o 723913 : List in markdown: < p > inside the last element of a < ul > list o 723991 : Improve the display of the synopsis o 724002 : gtkdoc-scan: Fix use of uninitialised value in trace logging Contributors Alban Browaeys Alexander Kanavin Carlos Garcia Campos Christian Kirbach Daniel Mustieles David King David Nečas Dieter Verfaillie Dimitris Spingos Hib Eris Matthias Clasen Philip Chimento Philip Withnall Rafael Ferreira Rico Tzschichholz Ryan Lortie Sebastian Rasmussen Sébastien Wilmet Stefan Sauer Stef Walter William Jon McCann Zbigniew Jędrzejewski-Szmek
2014-02-20 10:43:33 +01:00
EXTRACT_SUFX= .tar.xz
MAINTAINER= pkgsrc-users@NetBSD.org
2017-08-16 22:21:03 +02:00
HOMEPAGE= https://www.gtk.org/gtk-doc/
COMMENT= Tools for authors of the GTK+ reference documentation
Update to 1.13: GTK-Doc 1.13 (Dec 18 2009) ============ o 604891 : gtk-doc tarball does not build Contributors Stefan Kost GTK-Doc 1.12 (Dec 18 2009) ============ Changes o 591450 : Build related fixes o 466535 : generate documentation as pdf o 502191 : acronym support o 532395 : inline function parsing problems (e.g. in glib api docs) o 536928 : have syntax highlghted and xrefs source code samples o 562064 : index generation trouble o 562310 : glib 2.18.3: /bin/sh: line 1: gtkdoc-rebase: command not found o 562655 : doesn't produce deprecation note for signals o 565126 : linking to struct members o 565835 : Three spelling errors in gtk-doc-manual o 566911 : add support for --help and --version to remaining tools o 567132 : Take FOO_GET_INTERFACE as standard o 568702 : gtkdoc-mkhtml no longer works when symlinked o 568706 : gtkdoc-scan: use CamelCase id for interfaces o 568708 : gtkdoc-scan should try not to scan files twice o 568714 : Perl errors when syntax highlighting is not available o 568732 : missing long descriptions undetected o 568734 : configure check for gtk-doc prints that gtk-doc cannot be built o 569339 : abbreviation are not expanded at the start of text o 572396 : Fix to use shave + gtk-doc + libtool 1.x o 572612 : Mistakenly substitute -1 with G_MAXULONG in x86_64 o 572967 : use g_strerror o 574654 : --ignore-decorators does not ignore trailing stuff o 575574 : Be more friendly for files with a space in their name o 575623 : Update FSF address o 575711 : < table > element mismatch in highlighted code o 576313 : implicit declarations in testsuite ? o 577059 : Gnome-doc support can't be disabled o 577774 : Test suite run even when built with --disable-gtk-doc o 580206 : gcc warnings in < module > -scan.c o 580300 : gtkdoc-scan picks up _get_type functions it should not o 580622 : xml dir is both part of distclean and dist rules o 581237 : gtk-doc uses wrong gtkdoc-check in " make check " phase o 584952 : " uninitialized value in concatenation " gtkdoc-mkdb line 938 o 587103 : return values of function-like macros o 587196 : Typo in a string o 589426 : Python is a required dependency o 591789 : master FTBFS with automake 1.11 o 594224 : Please fix manual about inlined SECTION comments (and show warnings when invalid) o 596730 : Signed vs. unsigned comparison in gtkdoc-scangobj.in causing compile errors o 596731 : autogen.sh doesn't recognize automake-1.11 o 602026 : Warn if non-existing function gets referenced o 602518 : Doesn't support " long int " return type o 604798 : tests/fail.sh and tests/tools.sh.in use bashisms Contributors Claude Paroz Dan Williams Daniel Mustieles Daniel Nylander H. Habighorst Jannis Pohlmann Javier Jardón Jennie Petoumenou Jorge González Mario Blättermann Nicola Fontana Philip Chimento Philip Withnall Simos Xenitellis Stefan Kost Sven Herzberg
2010-01-20 12:12:01 +01:00
LICENSE= gnu-gpl-v3 AND gnu-fdl-v1.1
DEPENDS+= docbook-xml>=4.4nb1:../../textproc/docbook-xml
DEPENDS+= docbook-xsl>=1.68.1:../../textproc/docbook-xsl
DEPENDS+= ${PYPKGPREFIX}-anytree-[0-9]*:../../devel/py-anytree
DEPENDS+= ${PYPKGPREFIX}-lxml-[0-9]*:../../textproc/py-lxml
DEPENDS+= ${PYPKGPREFIX}-pygments-[0-9]*:../../textproc/py-pygments
gtk-doc: update to 1.26. GTK-Doc 1.26 (Aug 11 2017) ============== Remove tmpl support (gtkdoc-mktmpl). Port all tools from bash/perl to python. Changes o 773879 : - scangobj: Do not generate unused parameters o 780789 : Convert gtkdoc-scan from Perl to Python o 752126 : Add support for inline program documentation o 753052 : _() causes element a: validity error : ID idx already defined o 758137 : GtkLabel and GtkShortcutsShortcut notes on escaping character entities don't render properly o 764407 : Broken links to structs in function definitions o 764543 : /usr/bin/gtkdoc-mkpdf always exits with an error o 768675 : make check fails on master o 769125 : gtkdoc-mkhtml/pdf fails on spaces in search path o 769341 : gtkdoc-mkdb line 3966 triggers " Negative repeat count does nothing " warnings o 771255 : " Symbol name not found at the start of comment block " warning with " attributes " annotation. o 773151 : configure: Lower perl dependency to 5.16.0 o 774168 : gobject introspection annotations and gtk-doc parser do not agree o 774812 : Error messages from xsltproc are hidden by gtkdoc-mkhtml o 778144 : Allow disabling introspection for ancillary property mechanisms o 779566 : Replace shell executables with Python GTK-Doc 1.25 (Mar 21 2016) ============== Changes o 763465 : - released version of gtk-doc no longer understands cross-reference data in gtk+ o 742404 : unify index.sgml and *.devhelp2 + change gtkdoc-fixxref to use *.devhelp2 o 743182 : Automatically support PACKAGE variables as XML entities o 744061 : Skip standard g_iface, parent_instance and parent_class struct members o 751479 : help: Document the Stability tag for documentation comments o 751777 : gtk-doc -sections.txt file documentation is a bit confusing o 751783 : Creating master xml document documentation is a bit lacking o 751906 : help: Fix incorrect example syntax for embedded images o 752795 : documentation is not rebuilt when only content of doc comments change o 753145 : gtkdoc-mkhtml fails on spaces in file names o 753348 : gtkdocize does not handle -flat flavours o 756297 : Add CMake module o 756368 : gtkdocize mistakenly parses options from comments in configure.ac o 756519 : `make check' fails - Sequence (?R...) not recognized in regex o 756684 : Support (not nullable) annotation o 756998 : Support |[ <!-- language= " plain " --> ]| o 758996 : gtkdoc-mkdb: ensure macros appear in the correct section o 759017 : autogenerated ids in return and parameter blocks GTK-Doc 1.24 (May 29 2015) ============ This is another quick bugfix release for a regression, see bug #749591 Changes o 749591 : gtk-doc 1.23 no longer includes xml namespace in .devhelp2 files o 749706 : .gitignore files should not be under version control o 749816 : Support syntax highlighting of different languages (patch included) o 749901 : Strip common indent when highlighting with vim GTK-Doc 1.23 (May 17 2015) ============ This is a quick bugfix release for a regression, see bug #749142. Changes o 749142 : Can't build totem-pl-parser from master using gtk-doc 1.22 o 749210 : mkman: Use full URL to refer to the docbook manpages stylesheet GTK-Doc 1.22 (May 07 2015) ============ Important notice - starting with the next release these long deprecated features will be removed - you'll now see a warning if you actually use these features. Please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 727778 : - gtk-doc doesn't understand annotations for GList-contained types o 729911 : Using #TypeName inshort_description makes " - " in HTML index disappear o 732689 : strange result on a generated html page o 734689 : " Specific -> General " document title format o 736073 : Regression: problems with enum constants o 736725 : Documentation consists mostly of empty space o 741305 : Scanner issue with enum containing value ='{' o 741763 : Example Makefile.am improvements o 741941 : Last function argument missing in docs (possibly due to macro in code) o 743879 : special case G_DECLARE_*_TYPE o 743967 : Make build results reproducible o 744075 : Missing struct members if forward declared in another header o 744368 : gtkdoc-depscan doesn't handle unicode in .devhelp2 files correctly o 746118 : gtkdoc-scan: fix regex for get_type() functions o 746120 : Expand annotation recognition on symbol lines o 746121 : gtkdoc-mkdb: don't warn on 'deprecated entities' o 747207 : Typos in documentation o 747298 : Test still tries to check gtkdoc-scanobj o 748456 : xsl: Enable ToC generation on empty <toc/> elements
2017-10-11 17:46:46 +02:00
BUILD_DEPENDS+= itstool-[0-9]*:../../textproc/itstool
TEST_DEPENDS+= ${PYPKGPREFIX}-mock-[0-9]*:../../devel/py-mock
TEST_DEPENDS+= ${PYPKGPREFIX}-parameterized-[0-9]*:../../devel/py-parameterized
GNU_CONFIGURE= YES
PKGCONFIG_OVERRIDE= gtk-doc.pc.in
CONFIGURE_ARGS+= --with-xml-catalog=${XML_DEFAULT_CATALOG:Q}
gtk-doc: update to 1.26. GTK-Doc 1.26 (Aug 11 2017) ============== Remove tmpl support (gtkdoc-mktmpl). Port all tools from bash/perl to python. Changes o 773879 : - scangobj: Do not generate unused parameters o 780789 : Convert gtkdoc-scan from Perl to Python o 752126 : Add support for inline program documentation o 753052 : _() causes element a: validity error : ID idx already defined o 758137 : GtkLabel and GtkShortcutsShortcut notes on escaping character entities don't render properly o 764407 : Broken links to structs in function definitions o 764543 : /usr/bin/gtkdoc-mkpdf always exits with an error o 768675 : make check fails on master o 769125 : gtkdoc-mkhtml/pdf fails on spaces in search path o 769341 : gtkdoc-mkdb line 3966 triggers " Negative repeat count does nothing " warnings o 771255 : " Symbol name not found at the start of comment block " warning with " attributes " annotation. o 773151 : configure: Lower perl dependency to 5.16.0 o 774168 : gobject introspection annotations and gtk-doc parser do not agree o 774812 : Error messages from xsltproc are hidden by gtkdoc-mkhtml o 778144 : Allow disabling introspection for ancillary property mechanisms o 779566 : Replace shell executables with Python GTK-Doc 1.25 (Mar 21 2016) ============== Changes o 763465 : - released version of gtk-doc no longer understands cross-reference data in gtk+ o 742404 : unify index.sgml and *.devhelp2 + change gtkdoc-fixxref to use *.devhelp2 o 743182 : Automatically support PACKAGE variables as XML entities o 744061 : Skip standard g_iface, parent_instance and parent_class struct members o 751479 : help: Document the Stability tag for documentation comments o 751777 : gtk-doc -sections.txt file documentation is a bit confusing o 751783 : Creating master xml document documentation is a bit lacking o 751906 : help: Fix incorrect example syntax for embedded images o 752795 : documentation is not rebuilt when only content of doc comments change o 753145 : gtkdoc-mkhtml fails on spaces in file names o 753348 : gtkdocize does not handle -flat flavours o 756297 : Add CMake module o 756368 : gtkdocize mistakenly parses options from comments in configure.ac o 756519 : `make check' fails - Sequence (?R...) not recognized in regex o 756684 : Support (not nullable) annotation o 756998 : Support |[ <!-- language= " plain " --> ]| o 758996 : gtkdoc-mkdb: ensure macros appear in the correct section o 759017 : autogenerated ids in return and parameter blocks GTK-Doc 1.24 (May 29 2015) ============ This is another quick bugfix release for a regression, see bug #749591 Changes o 749591 : gtk-doc 1.23 no longer includes xml namespace in .devhelp2 files o 749706 : .gitignore files should not be under version control o 749816 : Support syntax highlighting of different languages (patch included) o 749901 : Strip common indent when highlighting with vim GTK-Doc 1.23 (May 17 2015) ============ This is a quick bugfix release for a regression, see bug #749142. Changes o 749142 : Can't build totem-pl-parser from master using gtk-doc 1.22 o 749210 : mkman: Use full URL to refer to the docbook manpages stylesheet GTK-Doc 1.22 (May 07 2015) ============ Important notice - starting with the next release these long deprecated features will be removed - you'll now see a warning if you actually use these features. Please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 727778 : - gtk-doc doesn't understand annotations for GList-contained types o 729911 : Using #TypeName inshort_description makes " - " in HTML index disappear o 732689 : strange result on a generated html page o 734689 : " Specific -> General " document title format o 736073 : Regression: problems with enum constants o 736725 : Documentation consists mostly of empty space o 741305 : Scanner issue with enum containing value ='{' o 741763 : Example Makefile.am improvements o 741941 : Last function argument missing in docs (possibly due to macro in code) o 743879 : special case G_DECLARE_*_TYPE o 743967 : Make build results reproducible o 744075 : Missing struct members if forward declared in another header o 744368 : gtkdoc-depscan doesn't handle unicode in .devhelp2 files correctly o 746118 : gtkdoc-scan: fix regex for get_type() functions o 746120 : Expand annotation recognition on symbol lines o 746121 : gtkdoc-mkdb: don't warn on 'deprecated entities' o 747207 : Typos in documentation o 747298 : Test still tries to check gtkdoc-scanobj o 748456 : xsl: Enable ToC generation on empty <toc/> elements
2017-10-11 17:46:46 +02:00
USE_TOOLS+= gmake pkg-config:run msgfmt
SUBST_CLASSES+= fix-pc
SUBST_STAGE.fix-pc= pre-configure
SUBST_MESSAGE.fix-pc= Unwrapping pkg-config path in installed helper tools.
SUBST_FILES.fix-pc+= gtkdoc-depscan.in
SUBST_FILES.fix-pc+= gtkdoc/config.py.in
SUBST_SED.fix-pc= -e 's,@PKG_CONFIG@,pkg-config,g'
2018-09-05 15:22:31 +02:00
PYTHON_VERSIONS_INCOMPATIBLE= 27
gtk-doc: update to 1.26. GTK-Doc 1.26 (Aug 11 2017) ============== Remove tmpl support (gtkdoc-mktmpl). Port all tools from bash/perl to python. Changes o 773879 : - scangobj: Do not generate unused parameters o 780789 : Convert gtkdoc-scan from Perl to Python o 752126 : Add support for inline program documentation o 753052 : _() causes element a: validity error : ID idx already defined o 758137 : GtkLabel and GtkShortcutsShortcut notes on escaping character entities don't render properly o 764407 : Broken links to structs in function definitions o 764543 : /usr/bin/gtkdoc-mkpdf always exits with an error o 768675 : make check fails on master o 769125 : gtkdoc-mkhtml/pdf fails on spaces in search path o 769341 : gtkdoc-mkdb line 3966 triggers " Negative repeat count does nothing " warnings o 771255 : " Symbol name not found at the start of comment block " warning with " attributes " annotation. o 773151 : configure: Lower perl dependency to 5.16.0 o 774168 : gobject introspection annotations and gtk-doc parser do not agree o 774812 : Error messages from xsltproc are hidden by gtkdoc-mkhtml o 778144 : Allow disabling introspection for ancillary property mechanisms o 779566 : Replace shell executables with Python GTK-Doc 1.25 (Mar 21 2016) ============== Changes o 763465 : - released version of gtk-doc no longer understands cross-reference data in gtk+ o 742404 : unify index.sgml and *.devhelp2 + change gtkdoc-fixxref to use *.devhelp2 o 743182 : Automatically support PACKAGE variables as XML entities o 744061 : Skip standard g_iface, parent_instance and parent_class struct members o 751479 : help: Document the Stability tag for documentation comments o 751777 : gtk-doc -sections.txt file documentation is a bit confusing o 751783 : Creating master xml document documentation is a bit lacking o 751906 : help: Fix incorrect example syntax for embedded images o 752795 : documentation is not rebuilt when only content of doc comments change o 753145 : gtkdoc-mkhtml fails on spaces in file names o 753348 : gtkdocize does not handle -flat flavours o 756297 : Add CMake module o 756368 : gtkdocize mistakenly parses options from comments in configure.ac o 756519 : `make check' fails - Sequence (?R...) not recognized in regex o 756684 : Support (not nullable) annotation o 756998 : Support |[ <!-- language= " plain " --> ]| o 758996 : gtkdoc-mkdb: ensure macros appear in the correct section o 759017 : autogenerated ids in return and parameter blocks GTK-Doc 1.24 (May 29 2015) ============ This is another quick bugfix release for a regression, see bug #749591 Changes o 749591 : gtk-doc 1.23 no longer includes xml namespace in .devhelp2 files o 749706 : .gitignore files should not be under version control o 749816 : Support syntax highlighting of different languages (patch included) o 749901 : Strip common indent when highlighting with vim GTK-Doc 1.23 (May 17 2015) ============ This is a quick bugfix release for a regression, see bug #749142. Changes o 749142 : Can't build totem-pl-parser from master using gtk-doc 1.22 o 749210 : mkman: Use full URL to refer to the docbook manpages stylesheet GTK-Doc 1.22 (May 07 2015) ============ Important notice - starting with the next release these long deprecated features will be removed - you'll now see a warning if you actually use these features. Please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 727778 : - gtk-doc doesn't understand annotations for GList-contained types o 729911 : Using #TypeName inshort_description makes " - " in HTML index disappear o 732689 : strange result on a generated html page o 734689 : " Specific -> General " document title format o 736073 : Regression: problems with enum constants o 736725 : Documentation consists mostly of empty space o 741305 : Scanner issue with enum containing value ='{' o 741763 : Example Makefile.am improvements o 741941 : Last function argument missing in docs (possibly due to macro in code) o 743879 : special case G_DECLARE_*_TYPE o 743967 : Make build results reproducible o 744075 : Missing struct members if forward declared in another header o 744368 : gtkdoc-depscan doesn't handle unicode in .devhelp2 files correctly o 746118 : gtkdoc-scan: fix regex for get_type() functions o 746120 : Expand annotation recognition on symbol lines o 746121 : gtkdoc-mkdb: don't warn on 'deprecated entities' o 747207 : Typos in documentation o 747298 : Test still tries to check gtkdoc-scanobj o 748456 : xsl: Enable ToC generation on empty <toc/> elements
2017-10-11 17:46:46 +02:00
TEST_TARGET= check
Update to 1.20. Add some dependencies so that gtk-depscan runs. Mark as not ready for python-3.x. GTK-Doc 1.20 (Feb 16 2014) ============ Important notice - starting with the next release these long deprecated features will be removed, please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-scanobj (only used for gtkobject) o return values need to be documented using "Returns:". We will remove the heuristic that turns a paragraph starting with "Returns " into return docs. o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 605537 : Returns: listed among parameters o 624001 : Support attribute-based method to deprecate symbols o 662424 : Class hierarchy about interfaces not generated by default o 665926 : should not have to document object structures o 666509 : Specifying --enable-gtk-doc should not be required to build source packages o 669417 : Duplicate IDs generated for unions registered as boxed types o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command o 692367 : gtkdocize should take a srcdir argument o 696570 : style updates o 697940 : Race condition between setup-build.stamp and scan-build.stamp o 701259 : /bin/bash: -chmod: command not found o 701638 : Support automake parallel test harness (fix error with GTKDOC_CHECK) o 706404 : Minor bug in gtkdoc-mkdb o 706438 : Empty lines added at the beginning and at the end of a programlisting o 707426 : master is broken in picking up flavour from configure.ac o 707717 : Support &quot; Deprecated: X.Y &quot; o 708268 : New *-insensitive.png files are not distributes o 710478 : gtkdoc-mkdb: Don't complain about annotations with hyphen o 711111 : gtkdoc-mkdb: sort entries in the glossary o 711598 : gtkdoc-scan doesn't ignore decorators containing parentheses o 719644 : docs: make yelp usage conditional in manual o 719645 : configure: emit message when looking for yelp o 720061 : make: create subdirectories of the content_files to the builddir o 721228 : configure: search for xml catalog in XDG_DATA_DIRS o 722479 : cp -u is not portable o 723118 : Mark |[ blocks as CDATA o 723288 : Fix MarkDown support o 723417 : New MarkDown parser o 723696 : Add support for blockquote o 723812 : Add support for reference links o 723913 : List in markdown: &lt; p &gt; inside the last element of a &lt; ul &gt; list o 723991 : Improve the display of the synopsis o 724002 : gtkdoc-scan: Fix use of uninitialised value in trace logging Contributors Alban Browaeys Alexander Kanavin Carlos Garcia Campos Christian Kirbach Daniel Mustieles David King David Nečas Dieter Verfaillie Dimitris Spingos Hib Eris Matthias Clasen Philip Chimento Philip Withnall Rafael Ferreira Rico Tzschichholz Ryan Lortie Sebastian Rasmussen Sébastien Wilmet Stefan Sauer Stef Walter William Jon McCann Zbigniew Jędrzejewski-Szmek
2014-02-20 10:43:33 +01:00
.include "../../lang/python/application.mk"
.include "../../textproc/gnome-doc-utils/buildlink3.mk"
Update to 1.20. Add some dependencies so that gtk-depscan runs. Mark as not ready for python-3.x. GTK-Doc 1.20 (Feb 16 2014) ============ Important notice - starting with the next release these long deprecated features will be removed, please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-scanobj (only used for gtkobject) o return values need to be documented using "Returns:". We will remove the heuristic that turns a paragraph starting with "Returns " into return docs. o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 605537 : Returns: listed among parameters o 624001 : Support attribute-based method to deprecate symbols o 662424 : Class hierarchy about interfaces not generated by default o 665926 : should not have to document object structures o 666509 : Specifying --enable-gtk-doc should not be required to build source packages o 669417 : Duplicate IDs generated for unions registered as boxed types o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command o 692367 : gtkdocize should take a srcdir argument o 696570 : style updates o 697940 : Race condition between setup-build.stamp and scan-build.stamp o 701259 : /bin/bash: -chmod: command not found o 701638 : Support automake parallel test harness (fix error with GTKDOC_CHECK) o 706404 : Minor bug in gtkdoc-mkdb o 706438 : Empty lines added at the beginning and at the end of a programlisting o 707426 : master is broken in picking up flavour from configure.ac o 707717 : Support &quot; Deprecated: X.Y &quot; o 708268 : New *-insensitive.png files are not distributes o 710478 : gtkdoc-mkdb: Don't complain about annotations with hyphen o 711111 : gtkdoc-mkdb: sort entries in the glossary o 711598 : gtkdoc-scan doesn't ignore decorators containing parentheses o 719644 : docs: make yelp usage conditional in manual o 719645 : configure: emit message when looking for yelp o 720061 : make: create subdirectories of the content_files to the builddir o 721228 : configure: search for xml catalog in XDG_DATA_DIRS o 722479 : cp -u is not portable o 723118 : Mark |[ blocks as CDATA o 723288 : Fix MarkDown support o 723417 : New MarkDown parser o 723696 : Add support for blockquote o 723812 : Add support for reference links o 723913 : List in markdown: &lt; p &gt; inside the last element of a &lt; ul &gt; list o 723991 : Improve the display of the synopsis o 724002 : gtkdoc-scan: Fix use of uninitialised value in trace logging Contributors Alban Browaeys Alexander Kanavin Carlos Garcia Campos Christian Kirbach Daniel Mustieles David King David Nečas Dieter Verfaillie Dimitris Spingos Hib Eris Matthias Clasen Philip Chimento Philip Withnall Rafael Ferreira Rico Tzschichholz Ryan Lortie Sebastian Rasmussen Sébastien Wilmet Stefan Sauer Stef Walter William Jon McCann Zbigniew Jędrzejewski-Szmek
2014-02-20 10:43:33 +01:00
# needed together with pkg-config by gtkdoc-depscan at runtime
.include "../../devel/glib2/buildlink3.mk"
2004-04-26 12:34:09 +02:00
.include "../../textproc/libxslt/buildlink3.mk"
Update to 1.2: 2004-02-16 Damon Chaplin <damon@gnome.org> * Released 1.2. 2004-02-16 Damon Chaplin <damon@gnome.org> * gtk-doc.cat.in: removed public ID for gtk-doc.dtd, since we don't use it any more. Sat Feb 14 02:14:27 2004 Matthias Clasen <maclas@gmx.de> * gtk-doc.m4: Avoid unnecessary checks if gtk-doc is disabled. (#134221, Julio M. Merino Vidal) Sat Feb 14 02:03:01 2004 Matthias Clasen <maclas@gmx.de> * gtk-doc.make: Don't create unneeded empty directories. (#134319, Julio M. Merino Vidal) Sat Feb 14 01:37:38 2004 Matthias Clasen <maclas@gmx.de> * gtk-doc.make: Add an empty all-local target to make it work with non-GNU make. (#134343, Julio M. Merino Vidal) Wed Jan 28 00:52:00 2004 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (OutputObjectList): Avoid emitting invalid docbook markup if there are no objects. Partial fix for #132661. Sun Jan 25 22:01:15 2004 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in: Accept both the old and the new XInclude namespace. (#131675, Edd Dumbill) 2004-01-23 Thomas Vander Stichele <thomas at apestaart dot org> * gtkdoc-mkhtml.in: exit when tools return non-zero so errors can be caught. Thu Jan 15 23:06:10 2004 Matthias Clasen <maclas@gmx.de> * gtk-doc.xsl: Set the chunk.fast parameter, to gain some speed. Thu Jan 15 23:05:23 2004 Matthias Clasen <maclas@gmx.de> * gtkdoc-fixxref.in: Make it work again without explicit --module. Sat Dec 27 01:36:08 2003 Matthias Clasen <maclas@gmx.de> * gtkdoc-scangobj.in: * gtkdoc-mktmpl.in: * gtkdoc-scan.in: * gtkdoc-fixxref.in: Add --help. (#126915) Sat Dec 27 00:43:42 2003 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (ParseEnumDeclaration): * gtkdoc-mktmpl.in (ParseEnumDeclaration): Support a trailing , in enum declarations. These are a GNU C extension, but also blessed by C99. (#129949, Thomas Vander Stichele) Sun Nov 16 00:29:03 2003 Matthias Clasen <maclas@gmx.de> * gtkdoc-scangobj.in: Don't use g_strdown(). (#127028, David Schleef) Sun Nov 16 00:26:05 2003 Matthias Clasen <maclas@gmx.de> * gtkdoc-scangobj.in: If compiled against GLib >= 2.3.0, look for properties on interfaces. (#127068, James M. Cape) 2003-11-03 Dan Winship <danw@ximian.com> * gtkdoc-scangobj.in: Clean up $MODULE-scan.o even when using libtool * gtkdoc-scanobj.in: Likewise * gtk-doc.make (CLEANFILES): Remove $(MODULE)-scan.o from here (clean-local): rm -rf .libs Wed Oct 8 01:21:54 2003 Matthias Clasen <maclas@gmx.de> * gtkdoc-scan.in (ScanHeader): Make gtkdoc-scan grok typedef struct { } foo; in addition to the more baroque typedef struct _foo foo; struct _foo { }; (#116807, Malcolm Tredinnick) Wed Oct 8 01:21:35 2003 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (OutputParamDescriptions): Remove a pointless warning. 2003-10-01 Matthias Clasen <maclas@gmx.de> Make signals and properties end up in the right template file (#116569, Owen Taylor): * gtkdoc-mktmpl.in (OutputSignalTemplates): (OutputArgTemplates): Return a string rather than directly writing to OUTPUT. (OutputTemplateFile): Don't interpret $title as the name of the object to print signal and property templates for. (UpdateTemplates): Collect signal and property templates for all objects contained in the section. 2003-08-10 James Henstridge <james@daa.com.au> * acinclude.m4 (JH_PATH_XML_CATALOG): allow caller to specify actions if found or not found. (JH_CHECK_XML_CATALOG): when requiring JH_PATH_XML_CATALOG, don't error out if it is not found. 2003-08-03 Matthias Clasen <maclas@gmx.de> * doc/gnome.txt: Add some hints regarding markup of examples. 2003-07-22 Matthias Clasen <maclas@gmx.de> * configure.in: * gtk-doc.cat: Fix a problem with the previous commit. 2003-07-21 Matthias Clasen <maclas@gmx.de> Applied patches from Sebastian Rittau to add maintainer mode and an SGML catalog. (#117955, #117956) * gtk-doc.cat.in: New catalog file. * configure.in: Added gtk-doc.catalog to output files. * Makefile.am: Install gtk-doc.catalog. * configure.in: Added AM_MAINTAINER_MODE. * autogen.sh: Added --enable-maintainer-mode to configure options. 2003-07-09 Matthias Clasen <maclas@gmx.de> * gtkdoc-mktmpl.in (ParseStructDeclaration): * gtkdoc-mkdb.in (ParseStructDeclaration): Accept volatile struct members, which have just made their appearance in glib. 2003-06-29 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (ExpandAbbreviations): When expanding @param, catch the common @param->field and @param.field, to reduce the need for littering the C sources with <literal>foo->bar</literal>. 2003-06-25 Matthias Clasen <maclas@gmx.de> Changes for #115528: * gtkdoc-mkdb.in (OutputSGML): Collect hierarchy, interfaces, implementations, prerequisites and derived interfaces separately. (OutputSGMLFile): Take two more arguments: implementations and derived interfaces. (GetHierarchy): Also put immediate children in the local tree. (GetInterfaces): Split into GetInterfaces and GetImplementations. (GetImplementations): New function to get the implementations of an interface. (GetDerived): New function to get the known derived interfaces of an interface. * gtkdoc-mkdb.in (MakeXRef): Accept a second, optional parameter for the text of the link. (ExpandAbbreviations): Add semantic markup inside the links, so that non-crossreferenced symbols come out properly formatted after link removal. (#61345) 2003-06-15 Matthias Clasen <maclas@gmx.de> Support for a flat index of all symbols. (#92861) To use, put an empty <index/> element in your driver document. * gtkdoc-mkdb.in (MakeIndexterms): New function, emits an indexterm. (OutputMacro, OutputTypedef, OutputStruct, OutputEnum, OutputUnion, OutputVariable, OutputFunction): Use MakeIndexterms. to emit indexterms for symbols. * gtkdoc-mkdb.in (GetSignals): (GetArgs): Emit Since: information for signals and properties. Thu Jun 12 15:55:57 2003 Owen Taylor <otaylor@redhat.com> * gtkdoc-mkhtml.in (declaration): Replace head -1 with -n 1. (Merge change by Elliot Lee from Red Hat package) 2003-06-11 Matthias Clasen <maclas@gmx.de> * doc/gnome.txt: Updates to the documentation of inline comments. 2003-06-03 Matthias Clasen <maclas@gmx.de> * gtk-doc.spec.in: Add a missing Provides: and include the .pc file. (#106568, Joe Pranevich) 2003-05-27 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (GetSignals): (GetArgs): Add signals and properties to the statistics. (OutputMissingDocumentation): Emit undocumented signals and properties. (#113645) 2003-04-21 Matthias Clasen <maclas@gmx.de> * tools/docpercentages.pl: Fix autolinkification for undocumented symbols. * doc/style-guide.txt: Typo fix.
2004-02-19 17:49:52 +01:00
.include "../../textproc/xmlcatmgr/catalogs.mk"
.include "../../mk/bsd.pkg.mk"
gtk-doc: update to 1.26. GTK-Doc 1.26 (Aug 11 2017) ============== Remove tmpl support (gtkdoc-mktmpl). Port all tools from bash/perl to python. Changes o 773879 : - scangobj: Do not generate unused parameters o 780789 : Convert gtkdoc-scan from Perl to Python o 752126 : Add support for inline program documentation o 753052 : _() causes element a: validity error : ID idx already defined o 758137 : GtkLabel and GtkShortcutsShortcut notes on escaping character entities don't render properly o 764407 : Broken links to structs in function definitions o 764543 : /usr/bin/gtkdoc-mkpdf always exits with an error o 768675 : make check fails on master o 769125 : gtkdoc-mkhtml/pdf fails on spaces in search path o 769341 : gtkdoc-mkdb line 3966 triggers " Negative repeat count does nothing " warnings o 771255 : " Symbol name not found at the start of comment block " warning with " attributes " annotation. o 773151 : configure: Lower perl dependency to 5.16.0 o 774168 : gobject introspection annotations and gtk-doc parser do not agree o 774812 : Error messages from xsltproc are hidden by gtkdoc-mkhtml o 778144 : Allow disabling introspection for ancillary property mechanisms o 779566 : Replace shell executables with Python GTK-Doc 1.25 (Mar 21 2016) ============== Changes o 763465 : - released version of gtk-doc no longer understands cross-reference data in gtk+ o 742404 : unify index.sgml and *.devhelp2 + change gtkdoc-fixxref to use *.devhelp2 o 743182 : Automatically support PACKAGE variables as XML entities o 744061 : Skip standard g_iface, parent_instance and parent_class struct members o 751479 : help: Document the Stability tag for documentation comments o 751777 : gtk-doc -sections.txt file documentation is a bit confusing o 751783 : Creating master xml document documentation is a bit lacking o 751906 : help: Fix incorrect example syntax for embedded images o 752795 : documentation is not rebuilt when only content of doc comments change o 753145 : gtkdoc-mkhtml fails on spaces in file names o 753348 : gtkdocize does not handle -flat flavours o 756297 : Add CMake module o 756368 : gtkdocize mistakenly parses options from comments in configure.ac o 756519 : `make check' fails - Sequence (?R...) not recognized in regex o 756684 : Support (not nullable) annotation o 756998 : Support |[ <!-- language= " plain " --> ]| o 758996 : gtkdoc-mkdb: ensure macros appear in the correct section o 759017 : autogenerated ids in return and parameter blocks GTK-Doc 1.24 (May 29 2015) ============ This is another quick bugfix release for a regression, see bug #749591 Changes o 749591 : gtk-doc 1.23 no longer includes xml namespace in .devhelp2 files o 749706 : .gitignore files should not be under version control o 749816 : Support syntax highlighting of different languages (patch included) o 749901 : Strip common indent when highlighting with vim GTK-Doc 1.23 (May 17 2015) ============ This is a quick bugfix release for a regression, see bug #749142. Changes o 749142 : Can't build totem-pl-parser from master using gtk-doc 1.22 o 749210 : mkman: Use full URL to refer to the docbook manpages stylesheet GTK-Doc 1.22 (May 07 2015) ============ Important notice - starting with the next release these long deprecated features will be removed - you'll now see a warning if you actually use these features. Please write to gtk-doc-list@gnome.org and tell us your concerns: o gtkdoc-mktmpl - please move all the comments into the sources. o generating html via sgml tools (jade/openjade), using xsltproc and docbook-xslt is pretty common and preferred since version 1.6 Changes o 727778 : - gtk-doc doesn't understand annotations for GList-contained types o 729911 : Using #TypeName inshort_description makes " - " in HTML index disappear o 732689 : strange result on a generated html page o 734689 : " Specific -> General " document title format o 736073 : Regression: problems with enum constants o 736725 : Documentation consists mostly of empty space o 741305 : Scanner issue with enum containing value ='{' o 741763 : Example Makefile.am improvements o 741941 : Last function argument missing in docs (possibly due to macro in code) o 743879 : special case G_DECLARE_*_TYPE o 743967 : Make build results reproducible o 744075 : Missing struct members if forward declared in another header o 744368 : gtkdoc-depscan doesn't handle unicode in .devhelp2 files correctly o 746118 : gtkdoc-scan: fix regex for get_type() functions o 746120 : Expand annotation recognition on symbol lines o 746121 : gtkdoc-mkdb: don't warn on 'deprecated entities' o 747207 : Typos in documentation o 747298 : Test still tries to check gtkdoc-scanobj o 748456 : xsl: Enable ToC generation on empty <toc/> elements
2017-10-11 17:46:46 +02:00
TEST_ENV+= LC_ALL=en_US.UTF-8