maintainer-feedback requested: [Bug 258624] devel/glib20: missing gtk-doc documentation

From: <bugzilla-noreply_at_freebsd.org>
Date: Mon, 20 Sep 2021 11:21:05 UTC
Bugzilla Automation <bugzilla@FreeBSD.org> has asked freebsd-desktop (Team)
<desktop@FreeBSD.org> for maintainer-feedback:
Bug 258624: devel/glib20: missing gtk-doc documentation
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=258624



--- Description ---
Hello.

glib-2.68.4/meson_options.txt includes gtk_doc option.

option('gtk_doc',
       type : 'boolean',
       value : false,
       description : 'use gtk-doc to build documentation')

With this option, html files can be produced.

MESON_ARGS=	-Db_lundef=false \
		-Ddefault_library=both \
		-Dinstalled_tests=false \
		-Dlibmount=disabled \
		-Dlocalstatedir=/var \
		-Dselinux=disabled \
		-Dxattr=false \
		-Dgtk_doc=true
ex)
/usr/ports/devel/glib20/work/stage/usr/local/share/gtk-doc/html % ls
gio	glib	gobject
...
usr/local/share/gtk-doc/html/glib/glib-Warnings-and-Assertions.html
usr/local/share/gtk-doc/html/glib/glib-URI-Functions.html
usr/local/share/gtk-doc/html/glib/Sorted_binary_tree_preorder.svg
usr/local/share/gtk-doc/html/glib/glib-String-Chunks.html
usr/local/share/gtk-doc/html/glib/glib-Bookmark-file-parser.html
usr/local/share/gtk-doc/html/glib/glib-Pointer-Arrays.html
...

These files are very useful when using devhelp.