annotate plugins/gaim-remote/remote-socket.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 <[e-mail]>

/*
 * gaim-remote
 *
 * Copyright (C) 2003 Christian Hammond <[e-mail]>
 * Copyright (C) 2002, Sean Egan <[e-mail]>
 * 
 * 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_SOCKET_H_
#define _GAIM_SOCKET_H_

#include <glib.h>

typedef struct
{
	unsigned char type;
	unsigned char subtype;
	unsigned long length;
	char *data;

} GaimRemotePacket;

void gaim_remote_session_send_packet(int fd, GaimRemotePacket *packet);
int gaim_remote_session_connect(int session);
gboolean gaim_remote_session_exists(int sess);
GaimRemotePacket *gaim_remote_session_read_packet(int fd);

GaimRemotePacket *gaim_remote_packet_new(guchar type, guchar subtype);
void gaim_remote_packet_free(GaimRemotePacket *p);
void gaim_remote_packet_append_string(GaimRemotePacket *p, char *str);
void gaim_remote_packet_append_char(GaimRemotePacket *p, char c);
void gaim_remote_packet_append_raw(GaimRemotePacket *p, char *str, int len);

#endif /* _GAIM_SOCKET_H_ */