Mercurial > pidgin.yaz
annotate doc/gaim-remote.1.in @ 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 | 01c297526fad |
children | a47f038ecf9a |
rev | line source |
---|---|
6954 | 1 .TH gaim-remote 1 |
2 | |
3 .SH "NAME" | |
4 gaim-remote v@VERSION@ \- Gaim command-line remote control | |
5 | |
6 .SH "SYNOPSIS" | |
7 .TP 5 | |
8 \fBgaim-remote \fI[command]\fR \fI[parameters]\fR | |
9 .TP 5 | |
10 \fBgaim-remote -h \fI[command]\fR | |
11 | |
12 .SH "DESCRIPTION" | |
13 .PP | |
14 \fbgaim-remote\fR is a command-line interface for controlling an already-running instance of the Gaim Instant Messaging client. It currently has only rudimentary support for launching AIM-style URIs, and closing the running instance, although further functionality is planned. | |
15 | |
16 .SH "OPTIONS" | |
17 The following options are provided by \fBgaim-remote\fR: | |
18 .TP | |
19 .B \-h [\fIcommand\fB] | |
20 Display help for \fBgaim-remote\fR or a specific command (see below). | |
21 | |
22 .SH "COMMANDS" | |
23 The following commands are implemented by \fBgaim-remote\fR: | |
24 .TP | |
25 .B quit | |
26 Closes the currently-running instance of \fBGaim\fR. | |
27 .TP | |
28 .B uri [URI] | |
29 Sends the given AIM-style URI to the currently running instance of \fBGaim\fR (see below). | |
30 | |
31 .SH "URIs" | |
32 The following URIs are currently valid. These default to acting on the first AIM account you have in your list: | |
33 .TP | |
34 .B aim:goim?screenname=[SCREENNAME] | |
35 Opens a new conversation window to the given screenname. | |
36 .TP | |
37 .B aim:goim?screenname=[SCREENNAME]&message=[MESSAGE] | |
38 Sends the given message to the screenname. Spaces in the message must be replaced with +. | |
39 .TP | |
40 .B aim:gochat?roomname=[CHATROOM] | |
41 Opens a chat window in the given room. | |
42 .TP | |
43 .B aim:addbuddy?screenname=[SCREENNAME] | |
44 Opens a dialog to adds the specified buddy to your buddy list. | |
45 | |
46 .SH "FILES" | |
47 .TP | |
48 .I /tmp/gaim_[USERNAME].[INSTANCE] | |
49 The UNIX domain socket used to contact the running instance of \fBGaim\fR. | |
50 | |
51 .SH "SEE ALSO" | |
52 .BR gaim (1), | |
53 .BR \fIhttp://gaim.sourceforge.net/\fR, | |
54 .BR \fIhttp://www.sourceforge.net/projects/gaim/\fR | |
55 | |
56 .SH "AUTHOR" | |
57 .PP | |
58 This manpage was written by Robert McQueen <\fIrobot101@debian.org\fR> | |
59 for the Debian GNU/Linux system (but may be used by others). | |
60 |