Bug 258624 - devel/glib20: missing gtk-doc documentation
Summary: devel/glib20: missing gtk-doc documentation
Status: New
Alias: None
Product: Ports & Packages
Classification: Unclassified
Component: Individual Port(s) (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: freebsd-desktop (Team)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2021-09-20 11:21 UTC by Hodong
Modified: 2021-09-20 11:21 UTC (History)
1 user (show)

See Also:
bugzilla: maintainer-feedback? (desktop)


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Hodong 2021-09-20 11:21:05 UTC
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.