![[BACK]](/icons/back.gif){kind=icon}
Up to [cvs.NetBSD.org] / pkgsrc / textproc / gtk-doc
Request diff between arbitrary revisions
Keyword substitution: kv
Default branch: MAIN
gtk-doc: updated to 1.34.0 GTK-Doc 1.34.0 (Mar 5 2024) Maintenance, some bug fixes Meson: fix some warnings, simplifications Translation updates
gtk-doc: Remove glib2 from buildlink3.mk. It appears to no longer be needed (added in 2015) and causes indirect dependency problems due to this file defaulting to DEPMETHOD of "build".
*: recursive bump for Python 3.11 as new default
revbump for icu and libffi
*: recursive bump for libffi
Update gtk-doc to 1.21
As per warning in 1.20, gtkdoc-scanobj and generating html via
sgml tools (options.mk) have been removed.
Added
# needed together with pkg-config by gtkdoc-depscan at runtime
.include "../../devel/glib2/buildlink3.mk"
to buildlink3.mk
GTK-Doc 1.21 (Jul 17 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-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 170860 : gtk-doc should have definitions for stability
o 644111 : one cannot specify against which libs gtkdoc-fixxref should
resolve links (problematic with multiple versions)
o 657444 : " enum foo { ... } " ; not recognized
o 671519 : Self-test relies on nonportable (GNU enhanced) 'date' command
o 678094 : the word "returns" in a function description can be parsed as
the "Returns:" section
o 722621 : gtk-doc tarball was created with 32bit uid/gid, unusable with
mingw/msys tar
o 724739 : Self-test fail: gtkdoc-mkdb misusing perl datatype
o 725505 : new syntax highlighting for code is weird
o 725663 : configure: non POSIX test usage
o 730658 : Deprecation warning for non-deprecated type GParamFlags
o 730777 : Add support for nullable and optional annotations
The latest gtk-doc does not create .devhelp files any more - bump buildlink3 required version to ensure PLISTs match
Update to 1.17: GTK-Doc 1.17 (Feb 16 2011) ============ Changes o 127049 : building reference documentation fails when builddir != srcdir o 640241 : non-srcdir builds busted Contributors Daniel Mustieles Javier Jardón Stefan Kost GTK-Doc 1.16 (Jan 14 2011) ============ o gtkdoc-check can do more checks, one might need to update Makefile.am from the examples/Makefile.am Changes o 625776 : serialise doubles and floats always with a decimal dot o 627269 : link to signalflags docs from signal descriptions o 467488 : GTK+ man pages request o 481811 : Inline function bodies are confused with declarations o 501107 : EXTRA_DIST automake warnings o 512565 : add GTK_DOC_IGNORE o 518427 : documentation best pratices needed o 597937 : Function pointers as parameters to other functions are parsed improperly o 612028 : gtkdoc-fixxref should call /usr/bin/vim -n -e -u NONE -T xterm o 617478 : Tooltip is a nuisance o 618379 : Navigation is hiding anchors title o 620249 : invalid xml for object_index with (n_objects % 3) == 0 o 621931 : support GType and GVariant types o 622971 : List of typos in the GTK-doc manual o 623777 : G_TYPE_STRV in signals generate wrong docs o 623968 : gtkdoc-mkdb generates invalid xml from sgml in inline comments o 624199 : parser picks up contents of large macros o 624200 : 'const' confuses the parser o 627223 : gtkdoc-fixxref vim highlight fails on xhtml suffix o 627920 : `make check` rule to list xml files missing from DOC_MAIN_SGML_FILE o 628611 : gtk-doc > = 1.13 creates automagic dependencies on syntax highlighters o 628794 : Issue in gtkdoc-mkman.in o 630288 : Fix 'scope notified' annotation o 631336 : remove lists of gtk+ signal args in gtkdoc-scanobj and -scangobj o 632587 : gtkdoc-scanner fails to identify (closure) annotation o 638330 : const in parameter list is ignored o 638831 : Support GTK+ 3 cell properties Contributors Bruno Brouard Christian Persch Claude Paroz Gilles Dartiguelongue Javier Jardón Jorge González Maarten Bosmans Mario Blättermann Matej Urbančič Matthias Clasen Pablo Castellano P. F. Chimento Philip Withnall Rodrigo Aliste Simón Pena Stefan Kost Tim-Philipp Müller Vasilis Tsivikis
Simply and speed up buildlink3.mk files and processing. This changes the buildlink3.mk files to use an include guard for the recursive include. The use of BUILDLINK_DEPTH, BUILDLINK_DEPENDS, BUILDLINK_PACKAGES and BUILDLINK_ORDER is handled by a single new variable BUILDLINK_TREE. Each buildlink3.mk file adds a pair of enter/exit marker, which can be used to reconstruct the tree and to determine first level includes. Avoiding := for large variables (BUILDLINK_ORDER) speeds up parse time as += has linear complexity. The include guard reduces system time by avoiding reading files over and over again. For complex packages this reduces both %user and %sys time to half of the former time.
Change the format of BUILDLINK_ORDER to contain depth information as well, and add a new helper target and script, "show-buildlink3", that outputs a listing of the buildlink3.mk files included as well as the depth at which they are included. For example, "make show-buildlink3" in fonts/Xft2 displays: zlib fontconfig iconv zlib freetype2 expat freetype2 Xrender renderproto
Track information in a new variable BUILDLINK_ORDER that informs us of the order in which buildlink3.mk files are (recursively) included by a package Makefile.
Over 1200 files touched but no revisions bumped :) RECOMMENDED is removed. It becomes ABI_DEPENDS. BUILDLINK_RECOMMENDED.foo becomes BUILDLINK_ABI_DEPENDS.foo. BUILDLINK_DEPENDS.foo becomes BUILDLINK_API_DEPENDS.foo. BUILDLINK_DEPENDS does not change. IGNORE_RECOMMENDED (which defaulted to "no") becomes USE_ABI_DEPENDS which defaults to "yes". Added to obsolete.mk checking for IGNORE_RECOMMENDED. I did not manually go through and fix any aesthetic tab/spacing issues. I have tested the above patch on DragonFly building and packaging subversion and pkglint and their many dependencies. I have also tested USE_ABI_DEPENDS=no on my NetBSD workstation (where I have used IGNORE_RECOMMENDED for a long time). I have been an active user of IGNORE_RECOMMENDED since it was available. As suggested, I removed the documentation sentences suggesting bumping for "security" issues. As discussed on tech-pkg. I will commit to revbump, pkglint, pkg_install, createbuildlink separately. Note that if you use wip, it will fail! I will commit to pkgsrc-wip later (within day).
Add buildlink3 file, defaulting to build dependency. Intended to be used by packages that look for gtk-doc using pkg-config.