Date: Sat, 07 May 2022 20:12:10 +0000 From: bugzilla-noreply@freebsd.org To: desktop@FreeBSD.org Subject: maintainer-feedback requested: [Bug 263852] [patch] graphics/cairo: Install documentation to a path accessible in the GNOME Devehlp browser Message-ID: <bug-263852-39348-Nyovk3mgPx@https.bugs.freebsd.org/bugzilla/> In-Reply-To: <bug-263852-39348@https.bugs.freebsd.org/bugzilla/> References: <bug-263852-39348@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-desktop (Team) <desktop@FreeBSD.org> for maintainer-feedback: Bug 263852: [patch] graphics/cairo: Install documentation to a path accessi= ble in the GNOME Devehlp browser https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D263852 --- Description --- 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=3D...
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-263852-39348-Nyovk3mgPx>