http://marcin-wiacek.fkn.pl/english/zips/mygnokii.tar.gz

[gnokii.git] / Docs / developers / gnokii / gettext-howto

diff --git a/Docs/developers/gnokii/gettext-howto b/Docs/developers/gnokii/gettext-howto
new file mode 100644 (file)
index 0000000..b014220
--- /dev/null
+++ b/Docs/developers/gnokii/gettext-howto
@@ -0,0 +1,102 @@
+1. What do I need?\r
+\r
+- a reasonably recent version of GNU gettext (e.g. 0.10.35)\r
+  Check the version using e.g. msgfmt -V\r
+\r
+- autoconf\r
+\r
+- gnokii distribution :-)\r
+\r
+- if you have the variable LINGUAS in the environment\r
+  (most Red Hats have, no idea about other distributions),\r
+  unset it\r
+\r
+\r
+2. How to make gnokii.pot file?\r
+\r
+gnokii.pot file is a collection of all localizable strings\r
+in the gnokii package. It will be generated automagically\r
+and is included in the standard distribution package.\r
+\r
+If you need to regenerate it, goto "po" directory,\r
+remove gnokii.pot and say\r
+\r
+        make gnokii.pot\r
+\r
+\r
+3.1 How to start translating for a new language?\r
+\r
+First, you would like to contact the authors or write\r
+to the mailing list - maybe there already is someone\r
+working on this translation. \r
+\r
+If you get the OK from the maintainer, there are several\r
+steps to do:\r
+\r
+- add the code of your language to the ALL_LINGUAS line\r
+  in the configure.in file\r
+\r
+  Caution: the language code may differ from the country\r
+  code, e.g. czech language is cs, Czech Republic is cz \r
+\r
+- run autoconf to recreate configure script\r
+\r
+- reconfigure the package (./configure)\r
+\r
+- in the po directory, copy gnokii.pot to <country>.po\r
+\r
+- start translating\r
+  \r
+\r
+3.2 How to merge existing translations with the updated gnokii.pot?\r
+\r
+This is simple. Rename the old file and use msgmerge to create\r
+an updated one:\r
+\r
+        mv cs.po cs.po.bak\r
+        msgmerge -o cs.po cs.po.bak gnokii.pot\r
+\r
+\r
+4. How to generate a .mo file\r
+\r
+When you say make in the po directory, all existing\r
+translations will be generated. The suffix will be .gmo.\r
+\r
+If you want to do this manually, use the msgfmt utility, e.g.\r
+\r
+        msgfmt -o cs.mo -v cs.po \r
+\r
+\r
+5. How to install the files\r
+\r
+Again, the makefile takes care of this. Simply use (as root)\r
+\r
+        make install\r
+\r
+in the po directory. If you want to do this manually (and/or\r
+for your language only), move the .mo file to\r
+/usr/share/locale/<your locale>/LC_MESSAGES/gnokii.mo \r
+\r
+\r
+I'm from Czech republic, so I did (well, I did not, but if you would\r
+like to localize gnokii, you should :-):\r
+\r
+        cd po\r
+        make gnokii.pot\r
+        cp gnokii.pot cs.po\r
+        <translating messages in cs.po>\r
+        <checking the translations using> msgfmt -o cs.mo -v cs.po\r
+       make\r
+        make install\r
+\r
+And now:\r
+\r
+SnowWhite:/tmp/gnokii$ export LC_MESSAGES=cs_CZ\r
+SnowWhite:/tmp/gnokii$ ./gnokii --version\r
+GNOKII Version 0.3.1 Copyright (C) Hugh Blemings 1999. <hugh@linuxcare.com>\r
+        Kompilace: 19:09:02 Mar 13 1999 pro model 6110 na portu /dev/ttyS0 \r
+SnowWhite:/tmp/gnokii$ \r
+\r
+The second line is in czech language :-) There are some problems - for\r
+example with "Mar" which is substitute by the C preprocessor.\r
+\r