maintainer-feedback requested: [Bug 263872] www/webkit2-gtk3: Patch for installing gtk-doc/devhelp documentation
Date: Sun, 08 May 2022 23:54:51 UTC
Bugzilla Automation <bugzilla@FreeBSD.org> has asked freebsd-gnome (Nobody)
<gnome@FreeBSD.org> for maintainer-feedback:
Bug 263872: www/webkit2-gtk3: Patch for installing gtk-doc/devhelp
documentation
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263872
--- Description ---
webkit2-gtk3 provides a cmake option for enabling a gtk-doc build for the
JavaScriptCore, WebKitGTK and WebKitDOMGTK+ components. If installed to a
directory accessible to Devhelp, the documentation can be browsed like other
devhelp manuals.
The attached patch adds a DOCS option to the www/webkit2-gtk3 port and patches
plist, for the documentation to be installed to a path accessible to devhelp.
Candidly, in looking at the patch before publishing it here I notice that the
patch has set a
-DCMAKE_INSTALL_DOCDIR=share/gtk-doc/html/${PORTNAME}${PKGNAMESUFFIX} while the
documentation actually winds up installed under other subdirectories of
-DCMAKE_INSTALL_DOCDIR=share/gtk-doc/html e.g with one manual installed to
share/gtk-doc/html/jsc-glib-4.0/ under the prefix dir.
I haven't tried building with a different CMAKE_INSTALL_DOCDIR. The docs are at
least installed to the pathnames conditionally in the pkg-plist and can be
browsed with Devhelp, with the port as patched with the attached diff.
After the next port-updates build locally, I'll try to test out how
CMAKE_INSTALL_DOCDIR is being used in the docs build
Maybe the documention could even help to inform any goal of using the Ruby,
Python, or other GTK WebKit bindings.