Mercurial > pidgin.yaz
annotate doc/connection-signals.dox @ 7724:613b20c69d2c
[gaim-migrate @ 8369]
this didn't cause me any problems yesterday, and it compiles, and bug fixing is a good thing.
"Some month ago I introduced translatable texts for "gaim --help" and
"gaim-remote --help".
Unfortunately the output of the translated text is often unreadable.
The problem is, that Gaim's *.po files have the UTF-8 locale (because
this is the default charset for GTK+ 2.0). But the users may have
configured other locales. For instance my SuSE Linux 9.0 system is
configured with LANG=de_DE@euro. "euro" is ISO-8859-1 (Western
character set, 8 Bit, with the Euro currency symbol). Lots of UTF-8
characters are unreadable if they are displayed in a 8 Bit charset
without conversion. Only the 7 Bit chars are displayed right.
There are two possible solutions:
1) Make the console texts untranslatable. This isn't very clever.
2) Convert the texts from UTF-8 to user's locale.
I choose the second solution.
The conversion cannot be made during the translation, because gettext
does not allow a mix of different character sets in one po-file.
My patch converts the console strings from UTF-8 to users locale.
Normally this works right, because most users have a locale which is
compatible with their language.
The case where a user uses a language (for instance German:
LANG=de_DE) with an incompatible character set (for instance the 7Bit
charset LC_CTYPE=C) is also handled. The user then sees a warning and
the original UTF-8 message.
At first I tried to make a new UTF-8 function in src/util.c. But the
function is needed 5 times in src/gaim-remote.c and 2 times in
src/main.c. gaim-remote is not linked against util.o. Also there are a
lot of dependencies from util.o to other files, so I will introduce a
lot of trouble to link gaim-remote against util.o.
So I only wrote a function in src/gaim-remote.c and used the UTF-8
conversion inline in src/main.c." --Bjoern Voigt
committer: Tailor Script <tailor@pidgin.im>
author | Luke Schierer <lschiere@pidgin.im> |
---|---|
date | Wed, 03 Dec 2003 13:21:55 +0000 |
parents | aca39e77db85 |
children | 8cf53d7a0887 |
rev | line source |
---|---|
6724
aca39e77db85
[gaim-migrate @ 7251]
Christian Hammond <chipx86@chipx86.com>
parents:
6611
diff
changeset
|
1 /** @page connection-signals Connection Signals |
6611 | 2 |
3 @signals | |
4 @signal signing-on | |
5 @signal signed-on | |
6 @signal signing-off | |
7 @signal signed-off | |
8 @endsignals | |
9 | |
10 <hr> | |
11 | |
12 @signaldef signing-on | |
13 @signalproto | |
14 void (*signing_on)(GaimConnection *gc); | |
15 @endsignalproto | |
16 @signaldesc | |
17 Emitted when a connection is about to sign on. | |
18 @param gc The connection that is about to sign on. | |
19 @endsignaldef | |
20 | |
21 @signaldef signed-on | |
22 @signalproto | |
23 void (*signed_on)(GaimConnection *gc); | |
24 @endsignalproto | |
25 @signaldesc | |
26 Emitted when a connection has signed on. | |
27 @param gc The connection that has signed on. | |
28 @endsignaldef | |
29 | |
30 @signaldef signing-off | |
31 @signalproto | |
6724
aca39e77db85
[gaim-migrate @ 7251]
Christian Hammond <chipx86@chipx86.com>
parents:
6611
diff
changeset
|
32 void (*signing_off)(GaimConnection *gc); |
6611 | 33 @endsignalproto |
34 @signaldesc | |
35 Emitted when a connection is about to sign off. | |
36 @param gc The connection that is about to sign off. | |
37 @endsignaldef | |
38 | |
39 @signaldef signed-off | |
40 @signalproto | |
6724
aca39e77db85
[gaim-migrate @ 7251]
Christian Hammond <chipx86@chipx86.com>
parents:
6611
diff
changeset
|
41 void (*signed_off)(GaimConnection *gc); |
6611 | 42 @endsignalproto |
43 @signaldesc | |
44 Emitted when a connection has signed off. | |
45 @param gc The connection that has signed off. | |
46 @endsignaldef | |
47 | |
48 */ | |
49 // vim: syntax=c tw=75 et |