GNOME Bugzilla – Bug 336104
[doc] Please migrate to gnome-doc-utils
Last modified: 2008-08-04 06:31:27 UTC
Please migrate to gnome-doc-utils for user manual build system as explained in http://live.gnome.org/GnomeDocUtilsMigrationHowTo BTW, this should also fix #323949.
Created attachment 62060 [details] [review] gnome-doc-utils migration patch
Hi Tommi. Thanks for doing this. Unfortunately, several of the diffs in the attachment seem to be already applied to the latest sources so I'm confused on exactly what still needs to be changed. Any chance you could check out the latest gcalctool sources from CVS HEAD and work out what changes still need to be applied, and generate a new patch? Thanks
Created attachment 62139 [details] [review] Regenerated oatch Only conflicts I got was with ChangeLog and Makefile.am version numbers. Maybe you were confused because there is autogenerated files omf.make and xmldocs.make (+ po/Makefile.in.in but it is not related to docs) in repository even though same time those are listed in .cvsignore. It would be better to not have those in repository because autogen.sh generates those. But if this looks okay to you, just say and I can commit this with conflicts resolved by myself.
The problems I was having were actually with the new m4 sub-directory (and the .cvsignore file in there). The patch didn't create them (although it created a couple of other files). To be safe, please go ahead and check in your changes. You understand this code, much better than I currently do. Thanks!
Committed.
Many thanks!
--disable-scrollkeeper does not work for me (in 5.8.13). It still runs update-scrollkeper. On a quick glance, I think it's the existence of omf.make and/or omf.make needing fixing. In the following sniplet you can see, that the ENABLE_SK_TRUE test does not happen at all. ---- snip --- install-data-hook-omf: $(mkinstalldirs) $(DESTDIR)$(omf_dest_dir) for file in $(omffile); do \ $(INSTALL_DATA) $$file.out $(DESTDIR)$(omf_dest_dir)/$$file; \ done -scrollkeeper-update -p $(DESTDIR)$(scrollkeeper_localstate_dir) -o $(DESTDIR)$(omf_dest_dir) uninstall-local-omf: -for file in $(srcdir)/*.omf; do \ basefile=`basename $$file`; \ rm -f $(DESTDIR)$(omf_dest_dir)/$$basefile; \ done -rmdir $(DESTDIR)$(omf_dest_dir) -scrollkeeper-update -p $(DESTDIR)$(scrollkeeper_localstate_dir) ---- snip ----
The remaining problem here is that there are various translations of the gcalctool online help that still aren't using gnome-doc-utils. I see that .../gcalctool/help/sv has been updated, but all others (except C locale) still need to be done.
There are still some translations that need converting over to the new gnome-doc-utils format. Reassigning to the GNOME Doc. people to get this translation completed.
This looks like a bug where target milestone makes sense but using a gnome-target does not. I'm removing the latter. Note that gnome-target is meant to be used on bugs severe enough to possibly require delaying GNOME releases. The target milestone is the field you want for bugs you'd like to remember to fix by a certain release. See also the "Target Milestone" and "GNOME Target Milestone" sections of http://bugzilla.gnome.org/page.cgi?id=bug-status.html. :-)
Recategorizing with component "docs".
Remaining manual conversions: bg ja zh_CN zh_HK zh_TW
Any update on this? I would like to solve this for GNOME 2.24.0, anything I can do to help?
If translators are not willing to convert their help translations, I think it is safe to not distribute them anymore in the next release.
It looks difficult to migrate immediately for me since xml2po does not work for current help/ja/gcalctool.xml. It results to output only a header like: $ xml2po -o ja.po -r gcalctool.xml msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2008-07-20 11:09+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" It should cut & paste gcalctool.xml to ja/ja.po by hand (800 over strings!), maybe.
Created attachment 114877 [details] Japanese po file I admit the migration is non trivial, because you have to find first the base version that was used for the translation. For Japanese, the rev. 242 of gcalctool.xml was the best match (even if I had to touch the file a little). I hope you'll be able to do the remainder of the work :-)
Hi Claude. Thank you so much. I could migrate Japanese translation to G-D-U now. Then I will do updating it until next release. Thanks again.
Converted bg and zh_CN: http://svn.gnome.org/viewvc/gcalctool?view=revision&revision=2139 Some damage may have been done in the conversion so please check if you are a native speaker of these languages. Just zh_HK and zh_TW to go...
Converted everything to close this bug: http://svn.gnome.org/viewvc/gcalctool?view=revision&revision=2144 http://svn.gnome.org/viewvc/gcalctool?view=revision&revision=2145 Again please check/repair if you are a native speaker as the conversion is probably not perfect.