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.