GNOME Bugzilla – Bug 327946
gnome-doc-utils is not properly setup and OMF category is incorrect
Last modified: 2006-04-06 00:40:26 UTC
I'm attaching a patch that fixes some issues with gnome-keyring-manager and gnome-doc-utils. this also fixes the OMF category, which is currently invalid and therefore does not list the help in the Table of Contents in yelp. Yes, the docbook file is currently just a skeleton. We need another bug for someone to write some documentation for this program.
Created attachment 57772 [details] [review] patch to fix gnome-doc-utils integration issues and OMF category See http://live.gnome.org/GnomeDocUtilsMigrationHowTo
*** Bug 319704 has been marked as a duplicate of this bug. ***
confirmed
Fixed in the development version. The fix will be available in the next major release. Thank you for your bug report. Note that I couldn't get it to appear under the TOC for Applications/System Tools though... not sure what the issue there is.
Hi. Note that this patch broke build, as described in bug 337310. Brent, any reason you introduced the m4/ macro dir? Intltool doesn't need that, and it's recommended to not duplicated macros unless really necessary.
Behdad: please see http://live.gnome.org/GnomeDocUtilsMigrationHowTo Shaun McCance is the author of gnome-doc-utils - those are his instructions for how to migrate to gnome-doc-utils. I'm not particularly sure the significance of that directory, but I was unable to include it in the patch (there's no way to do that, is there?) I think gnome-doc-prepare might have copied gnome-doc-utils.m4 into the m4 directory at one point, but it just seems to create a symlink now - Shaun, can you comment here?
Thanks. I see where it came from. Shaun, can you enlighten us? I don't see any reason to do that. For packages using gnome-autogen.sh, all the m4 stuff is handled transparently and gnome-doc-utils.m4 contents goes into aclocal.m4 when running autogen.sh, if there is no m4 directory. And recently I've simply removed the m4 directory from some packages because the outdated macros where actually breaking autogen.sh... m4/ should be used when you have your own homegrown macros, while in gnome-autogen.sh takes care of all the common m4 macros.