maintainer-feedback requested: [Bug 263852] [patch] graphics/cairo: Install documentation to a path accessible in the GNOME Devehlp browser

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 accessible
in the GNOME Devehlp browser
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=263852



--- 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=...