![[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
*: recursive bump for icu 76 shlib major version bump
*: revbump for icu downgrade
*: recursive bump for icu 76.1 shlib bump
revbump after icu and protobuf updates
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
*: recursive bump for icu 74.1
gtk-doc: improve HOMEPAGE
gtk-doc: switch to yelp-tools upstream changed their requirement some years ago. Bump PKGREVISION.
*: recursive bump for Python 3.11 as new default
revbump after textproc/icu update
massive revision bump after textproc/icu update
*: Revbump packages that use Python at runtime without a PKGNAME prefix
gtk-doc: depend on latest docbook-xsl Bump PKGREVISION.
revbump for textproc/icu update
revbump for icu and libffi
*: Use the tools framework for itstool Now it should be more obvious when a package needs it as a dependency, as it will fail loudly if it isn't declared as a tool. While here, some duplicate dependencies on itstool were removed from the MATE packages
revbump for textproc/icu
Revbump packages with a runtime Python dep but no version prefix. For the Python 3.8 default switch.
*: Recursive revbump from textproc/icu-68.1
Revbump for icu
*: recursive bump for libffi
gtk-doc: update to 1.32nb1. Remove unneeded dependency. Add missing test dependency. Update test status, all tests currently pass.
gtk-doc: update to 1.32. GTK-Doc 1.32 (Aug 15 2019) =============== Hotfix release. GTK-Doc 1.31 (Aug 5 2019) =============== Nonmaintainer release to fix "Wrong permissions for style CSS file" (#84) GTK-Doc 1.30 (May 08 2019) =============== GTK-Doc is now using python-pygments to do the syntax highlighing. It is not depending on highligh or source-highligh anymore. This version ships with a new expermiental gtkdoc-mkhtml2 toolchain replacing gktdoc-mkhtml+gtkdoc-fixxref.
Recursive revbump from boost-1.71.0
Recursive revbump from boost-1.70.0
PKGREVISION bump for anything using python without a PYPKGPREFIX. This is a semi-manual PKGREVISION bump.
revbump for boost 1.69.0
gtk-doc: No longer supports python27.
gtk-doc: update to 1.29. GTK-Doc 1.29 (Aug 28 2018) =============== GTK-Doc now requires python-3.X. It does not requires python-six anymore. Note that this is a nonmaintainer release and that tests are known to be broken. Changes o 674163 : – html-build.stamp rule broken for out-of-tree builds with absolute paths o 795744 : Too much escaped string - " & lt;child > " in description of " GtkOverlay as GtkBuildable " section o 796011 : Crash in ScanDirectory caused by overlooked use of renamed `dir` variable o 796012 : Several places in rebase.py incorrectly use `match.groups(1)` instead of `match.group(1)`, one causes a crash Contributors Adam Williamson Anders Jonsson Daniel Mustieles David D LRN Marek Cernocky Martin Blanchard Michael Biebl Michael Catanzaro Rafael Fontenelle Sebastian Geiger Stefan Sauer Tim Sabsch
revbump after boost-libs update
extend PYTHON_VERSIONS_ for Python 3.7
revbump for boost-libs update
gtk-doc: update to 1.28. GTK-Doc 1.28 (Mar 24 2018) ============== Bug fixes. o 791928 : gtk-doc doesn't understand 'stability: Obsolete' o 792148 : cmake: Installed GtkDocConfig.cmake has incorrect bindir path o 792661 : use pygments to do syntax highlighing o 793599 : Please run testsuite with V=0 o 794051 : rebase: fix on-line location extraction from devhelp files o 794182 : private_header regex is broken
gtk-doc: update to 1.27. GTK-Doc 1.27 (Dec 07 2017) ============== Finetune the python port. Changes o 773879 : scangobj: Do not generate unused parameters o 786174 : Several test failures on Arch Linux o 787495 : gtkdoc-fixxref crashes when running vim for syntax highlighting o 787768 : Aborts when glib2.0-dev is not installed o 787862 : Always open files in text mode and always use utf-8 o 788473 : fixxref crashes if a .devhelp2.gz file is found o 789531 : Don't depend on the system shell o 790022 : mkdb: Add support for (not optional) annotation o 791131 : gtk-doc and python3: fixxref failures
Revbump after boost update
gtk-doc: Depend on source-highlight for highlighting. The current default of vim (if found) is broken, but the upstream patch to fix it doesn't work in isolation, and updating to the latest release breaks other things, so this is currently the least-worst option to unbreak other packages like poppler-glib unfortunately. Really this should be a package option and set explicitly rather than relying on finding random binaries on the system. Bump PKGREVISION.
gtk-doc: not make-jobs safe with itstool-2.0.4 works fine for me with 2.0.2 but with 2.0.4 I see GEN el/ Error: Could not merge translations: 'NoneType' object is not subscriptable Makefile:522: recipe for target 'cs/cs.stamp' failed
gtk-doc: Add comment about failing test case.
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
Follow some http redirects.
Add python-3.6 to incompatible versions.
Remove python33: adapt all packages that refer to it.
Bump PKGREVISION for perl-5.24.0 for everything mentioning perl.
Bump PKGREVISION for pkg-config -> pkgconf change.
Extend PYTHON_VERSIONS_INCOMPATIBLE to 35
Recursive PKGREVISION bump for all packages mentioning 'perl', having a PKGNAME of p5-*, or depending such a package, for perl-5.22.0.
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
Bump for perl-5.20.0. Do it for all packages that * mention perl, or * have a directory name starting with p5-*, or * depend on a package starting with p5- like last time, for 5.18, where this didn't lead to complaints. Let me know if you have any this time.
Mark packages that are not ready for python-3.3 also not ready for 3.4, until proven otherwise.
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
Recursive PKGREVISION bump for libgcrypt-1.6.0 shlib major bump.
Bump all packages for perl-5.18, that a) refer 'perl' in their Makefile, or b) have a directory name of p5-*, or c) have any dependency on any p5-* package Like last time, where this caused no complaints.
Drop superfluous PKG_DESTDIR_SUPPORT, "user-destdir" is default these days.
Bump all packages that use perl, or depend on a p5-* package, or are called p5-*. I hope that's all of them.
Recursive PKGREVISION bump for libxml2 buildlink addition.
bump PKGREVISION from python default change to 2.7.
update to 1.18 changes: -bugfixes -cleanup: does not generate pre-0.11 devhelp files any more
recursive bump from gettext-lib shlib bump.
gtk-doc requires msgfmt to build, so add it to USE_TOOLS. Should fix build on DragonFly as reported in PR pkg/44757 by F. Tigeot.
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
update to 1.15 changes: -Support for multiple DOC_SOURCE_DIR directories -many bugfixes
Bump revision for PYTHON_VERSION_DEFAULT change.
Add two patches from upstream to fix --module and 'make dist' problems. Bump PKGREVISION.
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
Remove USE_DIRS from pkgsrc. Shared directories can now be created independently by the pacakges needing them and will be removed automatically by pkg_delete when empty. Packages needing empty directories can use the @pkgdir command in PLIST. Discussed and ok'd in thread starting at http://mail-index.netbsd.org/tech-pkg/2009/06/30/msg003546.html
Use mk/omf-scrollkeeper.mk instead of textproc/rarian/omf.mk.
Switch to Python 2.5 as default. Bump revision of all packages that have changed runtime dependencies now.
Move scrollkeeper/omf.mk to rarian/omf.mk. scrollkeeper is nowadays included in rarian, so the omf.mk file should be there as well. Adapt all references.
Update to 1.11: GTK-Doc 1.11 (Nov 16 2008) ============ Changes o 531572 : one-page generation option o 448879 : Use a footer when generating HTML documentation o 311857 : xsltproc very slow generating index for gtk-docs.sgml o 335239 : Using gnome-doc-utils for gtk-doc documentation o 460753 : enable vpath build in gtkdoc-mkhtml o 473342 : Warn about repeated symbols in sections o 487727 : DocBook XML DTD version o 523669 : make check: Element publisher content does not follow the... o 530758 : gtk-doc should not expand XML tags and their attributes o 533262 : no-template mode scans different source files o 534627 : gtk-doc uses non-standard HTML element o 542137 : No declaration found for: gsf_output_* o 543855 : Fix for Bug 460753 (enable vpath build in gtkdoc-mkhtml) ... o 544172 : Fails to parse return value of 'char const *' o 552822 : Add rules to create $(REPORT_FILES) o 553407 : Example Makefile.am uses obsolete INCLUDES instead of AM_... o 554718 : gtk-doc needs to allow versioned TARGET_DIR o 554833 : Be more careful with " struct _ < struct_name > " o 558082 : evince docs build fails with GTK_DISABLE_SINGLE_INCLUDES o 559281 : Correct check for existance of gtkdoc-rebase Contributors Behdad Esfahbod Christian Persch David Nečas Felix Riemann Jeffrey Stedfast Marc-Andre Lureau Matthew Barnes Peter Kjellerstedt Sebastian Dröge Simon Josefsson Stefan Kost
Mark as destdir ready.
Add python dependency for gtk-doc-depscan. Configure stopped without it, so no PKGREVISION++.
Update to 1.10. Fix HOMEPAGE. GTK-Doc 1.10 (Mar 20 2008) ============ Changes o 460753 : enable vpath build in gtkdoc-mkhtml o 503119 : Add dependency on content_files to SGML target o 127049 : building reference documentation fails when builddir != s... o 481811 : Inline function bodies are confused with declarations o 448879 : Use a footer when generating HTML documentation o 492005 : Deprecation guard warnings for properties and signals o 498521 : Inconsistent compiler flags passed in gtk-doc.make o 365913 : gtk-doc output is not predictable o 446648 : gtk-doc does not handle forward typedef'd enums o 468278 : Display proper types for properties o 497367 : don't use US-ASCII for output encoding o 501066 : Missing quotes around gtkdoc-rebase check cause a warning o 508897 : [PATCH] Fix build when gtk-doc is not installed o 509539 : Building documentation aborts when no .types file is present o 512154 : Struct member type attributes are limited to one token o 513318 : gtk-doc.el doesn't work fine with emacs22 Contributors Benjamin Otte Carlos Garnacho Damon Chaplin David Nečas Frederic Peters Joe Marcus Clarke Kouhei Sutou Loïc Minier Mathias Hasselmann Petteri Räty Rouslan Solomakhin Stefan Kost Sven Herzberg Yeti
update to 1.9 changes: bugfixes
update to 1.8 pkgsrc change: make SGML output optional, off per default, which saves the heavyweight dependency on jade other changes: o Made it easier to include example code in the source code comment blocks. "|[ ... ]|" can be used to delineate example code (it just gets converted to "<informalexample><programlisting>"), and most of the text in example code is left as it is. The only thing that is still expanded is '#' to allow links to a symbol's documentation, e.g. '#GtkWidget'. o Made the field widths wider for the HTML output, so it looks a bit nicer. o Added a '--rebuild-sections' option to gtkdoc-scan to automatically rebuild the MODULE-sections.txt file. This only works if all the header files are organized neatly and functions don't need rearranging in the docs. o Added a '--rebuild-types' option to gtkdoc-scan to automatically rebuild the MODULE.types file, so you don't need to add new types manually. o Leave CDATA sections as they are, in the extra XML content files and within source code comment blocks. o Allow the section id and #include's to be set within the "SECTION:" comment block, using "@Section_ID:xxx" and "@Include:". o Added "--default-includes" option to specify the default #include's (for people who are using --rebuild-sections and so can't specify it in MODULE-sections.txt). o Added a '--query-child-properties' argument to help document child properties of arbitrary GObjects (used by things like canvas widgets). o Fixed documentation of signals of interfaces.
Update to 1.7: o Fixed bug that resulted in empty "@:" lines in the templates. o Fixed a few bugs with the XSL code. o Supported a few more variations of C syntax. o Remove the internally-used '-struct' suffix from links to widget structs. o Fixed a few missing build dependencies. o Added a new "C-x4s" binding to the emacs lisp code, to insert a blank section header in the source code. o Fixed bug that ignored inline section header docs with '-' in their names. o Added a 'make docs' target that can be used to build the docs even when gtk-doc has been disabled at configure time. (Yeah, I know I updated it to 1.6 earlier today... thanks to wiz@ for pointing out the newest version.)
Update to 1.6: o Removed the hard dependancy on openjade or jade, since XML is used mainly now rather than SGML. o Install the .pc file in $(datadir) rather than $(libdir) since gtk-doc is architecture-independant. o Added "--ignore-decorators" option to ignore a list of declarators in function declarations. o Support '#Object::signal'/'#Object:property' to link to signals/properties o Fixed missing index terms.
Register the installed documentation in the scrollkeeper database. This is to add an explicit dependency on this utility so that gtk-doc does not install unmanaged files when scrollkeeper is already installed. Bump PKGREVISION to 2.
Bump PKGREVISION for all packages that had broken INSTALL/DEINSTALL scripts prior to revision 1.43 of bsd.pkginstall.mk.
Update to 1.5: GTK-Doc 1.5 (Mar 7 2006) =========== o Output the new version of devhelp2 information, but still generate the old devhelp files so older versions of DevHelp still work OK. o Fixed the initial creation of the *-sections.txt file so the object hierarchy, signals and properties all work automatically. o Show information about signal flags (run first/last). o Support a --source-suffixes argument specifying which source files to scan. o Support other root object types besides GObject and GInterface. o Use a fixed navigation bar for the generated documentation. o New documentation from Stefan Kost. o Handle more variations of C syntax.
Point MAINTAINER to pkgsrc-users@NetBSD.org in the case where no developer is officially maintaining the package. The rationale for changing this from "tech-pkg" to "pkgsrc-users" is that it implies that any user can try to maintain the package (by submitting patches to the mailing list). Since the folks most likely to care about the package are the folks that want to use it or are already using it, this would leverage the energy of users who aren't developers.
Recursive revision bump / recommended bump for gettext ABI change.
Drop maintainership. I can't seriously be the maintainer of so many packages - specially of packages that I haven't touched for a long while or those that other people can handle better than me.
Ran "pkglint --autofix", which corrected some of the quoting issues in CONFIGURE_ARGS.
Update to 1.4: o Use the new style.css stylesheet instead of hard-wiring the styles. o Updated the documentation and example build files. o Added support for a gallery of widget images. o Output default values for widget properties and allowed ranges. o Only underline links in the docs when the mouse hovers over them. o Added support for placing the parameter table anywhere within the function documentation (using the "<!--PARAMETERS-->" marker). o Handle more variations of C syntax.
Remove some unnecessarily strong dependencies on perl that resulted from including perl5/buildlink3.mk. These packages just need the Perl interpreter, and can just add "perl" to USE_TOOLS instead.
Given that I've done all the latest updates, pick up maintainership. Requested by the current maintainer, schmonz@.
Remove USE_BUILDLINK3 and NO_BUILDLINK; these are no longer used.
Update to 1.3: GTK-Doc 1.3 (Jan 9 2005) =========== o Use the new style.css stylesheet instead of hard-wiring the styles. o Updated the documentation and example build files. o Added support for a gallery of widget images. o Output default values for widget properties and allowed ranges. o Only underline links in the docs when the mouse hovers over them. o Added support for placing the parameter table anywhere within the function documentation (using the "<!--PARAMETERS-->" marker). o Handle more variations of C syntax.
Libtool fix for PR pkg/26633, and other issues. Update libtool to 1.5.10 in the process. (More information on tech-pkg.) Bump PKGREVISION and BUILDLINK_DEPENDS of all packages using libtool and installing .la files. Bump PKGREVISION (only) of all packages depending directly on the above via a buildlink3 include.
bump PKGREVISIONs since libxslt needs libgcrypt now
bl3ify
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.
PKGCONFIG_OVERRIDE is relative to WRKSRC.
Update to 1.1: 2003-04-18 James Henstridge <james@daa.com.au> * NEWS: add news items. * configure.in: increment version number. 2003-03-14 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (OutputBook): Fix the public identifier for DocBook V3.0: Davenport, not DavenPort. (#108343, Mariano Suarez-Alvarez) 2003-03-10 James Henstridge <james@daa.com.au> * configure.in: associate the chmod commands with the files they are chmod'ing. This way config.status will always run the correct chmod command. 2003-03-04 James Henstridge <james@daa.com.au> * configure.in: look up the docbook DTD by public id rather than system id. 2003-02-26 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkdb.in (GetArgs): Prefer template or comment docs over blurbs only if they're nonempty, otherwise the empty docs from the templates override all the blurbs. 2003-02-26 James Henstridge <james@daa.com.au> * autogen.sh (THEDIR): set up so that it will choose automake 1.7 or 1.6 in preference to 1.4. Passes distcheck okay. * configure.in: update configure.in script to match recommendations of newer autoconf's, and add an AC_PREREQ() statement, since the xml catalog checks are using new autoconf features. * gtk-doc.make (xml-build.stamp): since other bits of the makefile were assuming xml, may as well hard code --output-format=xml. 2003-02-19 James Henstridge <james@daa.com.au> * Makefile.am: get rid of the dist-hook, and just include the given files in EXTRA_DIST instead. * configure.in: provide meaningful names for the commands. * acinclude.m4 (JH_CHECK_XML_CATALOG): add some extra arguments: a friendly name for the catalog entry, and actions to run if the entry was found or not. Also include a bit more information in the config.log file if an error occurs. 2003-02-18 Matthias Clasen <maclas@gmx.de> * gtkdoc-mkhtml.in (declaration): Avoid the unportable grep option -q. (#105311) 2003-02-19 James Henstridge <james@daa.com.au> * devhelp.xsl: put chapters that aren't at the top level into the toc tree (to make gtk's .devhelp tree look better). * gtk-doc.spec.in (Requires): make the requires lines match current requirements ... * gtkdoc-mkhtml.in (XSLTPROC): pass --nonet to xsltproc, so we don't try to download DTDs and XSLT over the net. The configure checks should catch people who don't have the correct files in their catalog. 2003-02-17 James Henstridge <james@daa.com.au> * gtkdocize.in (--version): add --version argument. 2003-02-14 James Henstridge <james@daa.com.au> * gtkdoc-mkdb.in (GetOptions): actually accept --tmpl-dir as a command line option. Based on a patch from Simon Josefsson <jas@extundo.com>. * gtk-doc.xsl: remove the xmlns declaration. Not really needed for html output anyway ... 2003-02-13 James Henstridge <james@daa.com.au> * devhelp.xsl: remove refsect1's and refsect2's from book tree, as suggested by Hallski. * gtk-doc.make (install-data-local): the change to install images was superfluous, so I have removed it. (CLEANFILES): move some more stuff to CLEANFILES from the distclean-local rule. 2003-02-12 James Henstridge <james@daa.com.au> * gtk-doc.make: add some chmod calls to work arround distcheck on automake >= 1.6. (install-data-local): copy the images as well as the html files during install. (uninstall-local): add an uninstall rule to remove the docs. (CLEANFILES): add $(DOC_MODULE)-scan.o to the list of files to be cleaned up. 2003-02-09 James Henstridge <james@daa.com.au> * gtkdocize.in: script used to copy gtk-doc.make into another module. * gtk-doc.make: automake makefile fragment to handle gtk-doc support in other modules. * configure.in: check to make sure DocBook XML DTD and XSLT stylesheets are present in the XML catalog. * acinclude.m4 (JH_CHECK_XML_CATALOG): new macro to check for entries in the XML catalog. 2003-02-04 James Henstridge <james@daa.com.au> * gtk-doc.m4: a macro to check for gtk-doc. * Makefile.am (gtkdocdata_DATA): don't bother installing xml.dcl. It isn't used anymore (since switching xml mode to xsltproc). * gtkdoc-mkhtml.in (gtkdocdir): and here. * Makefile.am (gtkdocdatadir): change dir. * configure.in: put data files in $(datadir)/gtk-doc/data, so that they don't all get mixed up with the html docs installed by other packages.
Update to 1.0. This version includes lots of changes WRT 0.9. Some of them are the inclusion of a pkg-config file, and support to convert documentation from XML to XHTML using xsltproc. Bug fixes, too.
COMMENT should start with a capital letter.
s/netbsd.org/NetBSD.org/
Use buildlink2.
Update my email address.
Updated gtk-doc to 0.9 (privided by Amitai Schlair in pkg/15484) * examples/Makefile.am: added SCANOBJ_OPTIONS in case the module needs to pass options to gtkdoc-scanobj or gtkdoc-scangobj. * tools/gtk-doc.el: added Zucchi's emacs lisp for automatically adding skeleton comment blocks above functions. Very handy! * gtkdoc-scangobj.in: we now default to calling g_type_init() to initialize the type system, rather than gtk_init(). This means you don't need an X connection to build the docs any more. Hurrah! Also added a '--type-init-func' argument so you can change the function to be called. GTK+ uses --type-init-func="gtk_type_init(0)". * gtkdoc-scan.in (ScanHeader): removed 'Found object' debug message.
Added gtk-doc-0.8 (provided by Amitai Schlair in pkg/15071) The GTK+ Reference Documentation Project (RDP) aims to provide a complete set of reference material for the GLib, GDK, and GTK+ libraries. It is created using the gtk-doc system, which parses C header files and creates 'template' files which are then filled in by the authors. These template files are then converted into DocBook SGML, and from there to HTML or printed output.
Initial revision