annotate po/README @ 6488:e5e8d21bd4d8

[gaim-migrate @ 7002] Some documentation updates. Really nothing great. committer: Tailor Script <tailor@pidgin.im>
author Christian Hammond <chipx86@chipx86.com>
date Mon, 18 Aug 2003 10:08:26 +0000
parents 89208bb9357a
children ebf3b709a77a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
5180
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
1 Translation README
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
2
6419
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
3
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
4
5180
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
5 Updated: 19-April-2003
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
6 ------------------
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
7
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
8 To supply a new translation, you first need a copy of gaim.pot.
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
9 This can be built by typing:
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
10
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
11 ./update.pl --pot
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
12
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
13 from the gaim/po/ directory.
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
14
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
15 To update an exsting translation, type:
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
16
5537
3becf79500d2 [gaim-migrate @ 5937]
Mark Doliner <mark@kingant.net>
parents: 5180
diff changeset
17 ./update.pl LANG
5180
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
18
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
19 where LANG is the language code to update, such as fr or ja. This will build
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
20 a new gaim.pot and update the translation with the changes. You may then
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
21 begin editing the updated file.
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
22
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
23 New or updated translations should be sent to the gaim-devel listserv
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
24 (see http://lists.sourceforge.net/lists/listinfo/gaim-devel)
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
25
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
26 Please check your translations carefully. Make sure you have the same
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
27 number of newlines and %s or other formatting codes in the translation as
ea261ce36f0b [gaim-migrate @ 5544]
Christian Hammond <chipx86@chipx86.com>
parents:
diff changeset
28 you have in the original.
6419
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
29
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
30
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
31
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
32 Updated: 05-August-2003
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
33 ------------------
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
34
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
35 All translations should be in UTF-8. You can use the following command to
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
36 convert from one encoding to another, if needed:
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
37 > iconv -f iso-8859-1 -t utf-8 xx.po > xx.po.new
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
38
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
39 Before submitting updated or new translations, please run the following
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
40 command to ensure the file does not contain errors:
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
41 > msgfmt -c --statistics xx.po
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
42
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
43 The comments at the top of each .po file should appear as follows:
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
44 # Gaim Xxxxx translation
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
45 # Copyright (C) 2002, Another Name <email@something.com>
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
46 # Copyright (C) 2003, Your Name <email@whatever.com>
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
47 #
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
48 # This file is distributed under the same license as the Gaim package.
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
49 #
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
50
89208bb9357a [gaim-migrate @ 6926]
Mark Doliner <mark@kingant.net>
parents: 5537
diff changeset
51 Thank you for flying Valu-Jet.