#1104191 git-buildpackage: gnome devhelp can't find git-buildpackage documentation index

#1104191#5
Date:
2025-04-27 05:44:24 UTC
From:
To:
Dear Maintainer,

I was experimenting with devhelp for reading and searching documentation locally and I discovered that though git-buildpackage does include an index file for devhelp, devhelp can't find the documentation.

The devhelp2 file that's is created by git-buildpackage's documentation build process gets installed as
/usr/share/doc/git-buildpackage/manual-html/book.devhelp2
and as far as I can tell to get devhelp to load documentation it needs a link to the html documention in /usr/share/devhelp/books pointing to the html directory containing a devhelp2 index with the same name as the link.

So to get the git-buildpackage documentation to appear I think the current file book.devhelp2 should be called git-buildpackage.devhelp2, and a symlink should be added from /usr/share/devhelp/books/git-buildpackage pointing at  /usr/share/doc/git-buildpackage/manual-html.

I think the reason the devhelp2 file is getting created is as a side effect of using gtk-doc. Attached is a small patch against 0.9.38 that tells gtk-doc to name the package, and adds the symlink so the git-buildpackage manual show up in devhelp as "Building Debian Packages with git-buildpackage".

Diane