GNOME Bugzilla – Bug 470812
Doc utils migration
Last modified: 2011-06-14 15:54:28 UTC
What about using good doc support from gnome-doc-utils? It requires only libxslt, so windows should also work. That would help translators and the doc would be on library.gnome.org
Created attachment 94460 [details] [review] gnome-doc-utils migration.patch.bz2 the patch is *HUGE* and unfinished (no man, no pdf)
Is it suitable if the man page is non-translatable? I have no idea how gnome-doc-utils handle man pages or pdf. I might ask.
let me add 2/3 things: - the patch is big, but the commit is rather small with svn mv - the current translations will be obsolete (unfortunately) - it also rename cvsingore files to svnignore.
current doc (as of in 0.96 tarball) doesn't work at all in yelp and the trick used to switch installation directory with --enable-gnome doesn't work because it seems newer autoconf doesn't parse included make with embedded automake conditions. This lead to https://bugs.gentoo.org/show_bug.cgi?id=159381. I'm not sure that gnome-doc-utils would solve this by itself but doc generation can fail because flacky net connection, see https://bugs.gentoo.org/show_bug.cgi?id=205067 As for man generation, I think the current system could still work alongside gnome-doc-utils even though it might not be the best solution. I'll look more into this to hopefully speed up migration to a saner solution because in it's current state, doc is just unusable for users.
there is a lot of work done as part of bug #465460
Looks like the doc util migration is not going to happen. The possibly remaining issue here is also covered by bug 558690 so I'm resolving this one as obsolete.