Created attachment 233799 [details] patch for installing documentation directly to DOCSDIR This patch updates the Makefile and pkg-plist for graphics/cairo as to ensure that the documentation will be installed directly to the port's DOCSDIR. Rationale: In the Devehelp User Documentation - available under the GNOME Yelp documentation browser, with the documentation installed from the devel/devhelp port - the section "Installing API Documentation" mentions a number of standard pathnames that documentation may be installed to, such as to be accessible in the Devhelp browser. With the devehelp build under FreeBSD ports, it seems that documentation installed directly to a port's DOCSDIR may also be accessible in the Devhelp browser. Previous to this changeset, then with the DOCS option enabled for graphics/cairo, documentation was being installed to a subdirectory of the graphics/cairo DOCSDIR, i.e was installed to the directory /usr/local/share/doc/cairo/cairo/. While accessible for normal browsing, this documentation was not appearing in the Devhelp UI. When setting the HTML_DIR for the build to the parent directory of the port's docsdir, then at least with the graphics/cairo port, the documentation will be installed directly into the port's DOCSDIR. This documentation may then be browsed normally with Devhelp. for graphics/cairo the HTML_DIR for build may be set in configure, using the configure arg --with-html-dir=...
With the patch as initially attached here, graphics/cairo would continue to install docs under the port's DOCSDIR. Looking at where the *.devhelp2 files are being installed for other ports, maybe it could be more effective to set something like the following instead, in the Makefile DOCS_CONFIGURE_ON+= --with-html-dir=${LOCALBASE}/share/gtk-doc/html Of course this would affect pkg-plist. It might serve to move the cairo docs to under a same general subdir as other manuals generally built with gtk-doc tools and accessible with GNOME devhelp
This is a duplicate of 263785, which has much less information but was marked "in progress". Tobias says it'll be done with the update to 1.17.6.
A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/ports/commit/?id=064fa58763573d636c1a83724b37bc507a79d4f8 commit 064fa58763573d636c1a83724b37bc507a79d4f8 Author: Adriaan de Groot <adridg@FreeBSD.org> AuthorDate: 2022-09-17 14:22:36 +0000 Commit: Adriaan de Groot <adridg@FreeBSD.org> CommitDate: 2022-09-17 14:26:59 +0000 graphics/cairo: make documentation available in devhelp GNOME devhelp looks for documentation in particular places, and cairo was putting it somewhere subtly different. Switch DOCSDIR (since it was already being used in the Makefile and pkg-plist, this is the smallest change) to point to where it should. This approach is copied from devel/libsoup/ and was suggested by Sean Champ. PR: 263852 263785 graphics/cairo/Makefile | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-)
Sean, I took your suggestion, not your patch, and munged it a bit. Now Cairo shows up in devhelp.