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
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
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.
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
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).
