Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 08 May 2022 23:54:51 +0000
From:      bugzilla-noreply@freebsd.org
To:        gnome@FreeBSD.org
Subject:   maintainer-feedback requested: [Bug 263872] www/webkit2-gtk3: Patch for installing gtk-doc/devhelp documentation
Message-ID:  <bug-263872-6497-hFjysMIC99@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-263872-6497@https.bugs.freebsd.org/bugzilla/>
References:  <bug-263872-6497@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
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=3D263872



--- 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 patc=
hes
plist, for the documentation to be installed to a path accessible to devhel=
p.

Candidly, in looking at the patch before publishing it here I notice that t=
he
patch has set a
-DCMAKE_INSTALL_DOCDIR=3Dshare/gtk-doc/html/${PORTNAME}${PKGNAMESUFFIX} whi=
le the
documentation actually winds up installed under other subdirectories of
-DCMAKE_INSTALL_DOCDIR=3Dshare/gtk-doc/html e.g with one manual installed to
share/gtk-doc/html/jsc-glib-4.0/ under the prefix dir.=20

I haven't tried building with a different CMAKE_INSTALL_DOCDIR. The docs ar=
e 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.=20

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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-263872-6497-hFjysMIC99>