Mercurial > pidgin
view src/gtkft.h @ 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 | feb3d21a7794 |
children | 8e60ddc28a22 |
line wrap: on
line source
/** * @file gtkft.h GTK+ file transfer UI * @ingroup gtkui * * gaim * * Copyright (C) 2003 Christian Hammond <chipx86@gnupdate.org> * * This program is free software; you can redistribute it and/or modify * it under the terms of the GNU General Public License as published by * the Free Software Foundation; either version 2 of the License, or * (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU General Public License for more details. * * You should have received a copy of the GNU General Public License * along with this program; if not, write to the Free Software * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA */ #ifndef _GAIM_GTK_FT_H_ #define _GAIM_GTK_FT_H_ #include "ft.h" /** * A file transfer dialog. * * The structure is opaque, as nobody should be touching anything inside of * it. */ typedef struct _GaimGtkXferDialog GaimGtkXferDialog; /**************************************************************************/ /** @name GTK+ File Transfer Dialog API */ /**************************************************************************/ /*@{*/ /** * Creates a new file transfer dialog. * * @return The new dialog. */ GaimGtkXferDialog *gaim_gtkxfer_dialog_new(void); /** * Destroys a file transfer dialog. * * @param dialog The file transfer dialog. */ void gaim_gtkxfer_dialog_destroy(GaimGtkXferDialog *dialog); /** * Displays the file transfer dialog. * * @param dialog The file transfer dialog to show. */ void gaim_gtkxfer_dialog_show(GaimGtkXferDialog *dialog); /** * Hides the file transfer dialog. * * @param dialog The file transfer dialog to hide. */ void gaim_gtkxfer_dialog_hide(GaimGtkXferDialog *dialog); /** * Shows the file transfer dialog, creating a new one if necessary */ void gaim_show_xfer_dialog(); /** * Adds a file transfer to the dialog. * * @param dialog The file transfer dialog. * @param xfer The file transfer. */ void gaim_gtkxfer_dialog_add_xfer(GaimGtkXferDialog *dialog, GaimXfer *xfer); /** * Removes a file transfer from the dialog. * * @param dialog The file transfer dialog. * @param xfer The file transfer. */ void gaim_gtkxfer_dialog_remove_xfer(GaimGtkXferDialog *dialog, GaimXfer *xfer); /** * Indicate in a file transfer dialog that a transfer was canceled. * * @param dialog The file transfer dialog. * @param xfer The file transfer that was canceled. */ void gaim_gtkxfer_dialog_cancel_xfer(GaimGtkXferDialog *dialog, GaimXfer *xfer); /** * Updates the information for a transfer in the dialog. * * @param dialog The file transfer dialog. * @param xfer The file transfer. */ void gaim_gtkxfer_dialog_update_xfer(GaimGtkXferDialog *dialog, GaimXfer *xfer); /*@}*/ /**************************************************************************/ /** @name GTK+ File Transfer API */ /**************************************************************************/ /*@{*/ /** * Initializes the GTK+ file transfer system. */ void gaim_gtk_xfers_init(void); /** * Sets gaim's main file transfer dialog. * * @param dialog The main dialog. */ void gaim_set_gtkxfer_dialog(GaimGtkXferDialog *dialog); /** * Returns gaim's main file transfer dialog. * * @return The main dialog. */ GaimGtkXferDialog *gaim_get_gtkxfer_dialog(void); /** * Returns the UI operations structure for the GTK+ file transfer UI. * * @return The GTK+ file transfer UI operations structure. */ GaimXferUiOps *gaim_gtk_xfers_get_ui_ops(void); /*@}*/ #endif /* _GAIM_GTK_FT_H_ */