diff --git a/doc/en/weechat.en.xml b/doc/en/weechat.en.xml
index e2a4d0abc..e47c2cea4 100644
--- a/doc/en/weechat.en.xml
+++ b/doc/en/weechat.en.xml
@@ -782,9 +782,18 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
- %Cnn
+ %Cxx
- text color "nn" (see colors table below)
+ text color "xx"
+ (see colors table below)
+
+
+
+ %Cxx,yy
+
+ text color "xx"
+ and background "yy"
+ (see colors table below)
@@ -2186,20 +2195,24 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ Type
Field
Description
+ char *
server
IRC server
+ char *
channel
IRC channel
+ int
type
DCC type:
@@ -2210,6 +2223,7 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ int*
status
DCC status:
@@ -2222,51 +2236,82 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ time_t
start_time
date/time of DCC creation
+ time_t
start_transfer
date/time of DCC transfer start
+ unsigned long
addr
IP address of remote user
+ int
port
port used for DCC
+ char *
nick
remote nick
+ char *
filename
file name
+ char *
local_filename
local file name
+ int
+ filename_suffix
+ suffix if renaming file
+
+
+ unsigned long
size
file size
+ unsigned long
pos
position in file
+ unsigned long
start_resume
start position after interruption
+ unsigned long
bytes_per_sec
number of bytes per second since transfer start
+
+ t_plugin_dcc_info *
+ prev_dcc
+
+ pointer to previous DCC info
+
+
+
+ t_plugin_dcc_info *
+ next_dcc
+
+ pointer to next DCC info
+
+
+
@@ -2294,7 +2339,7 @@ if (dcc_info)
free_dcc_info
- Prototype :
+ Prototype:
void free_dcc_info (t_weechat_plugin *plugin,
t_plugin_dcc_info *dcc_info)
@@ -2327,12 +2372,561 @@ if (dcc_info)
plugin->free_dcc_info (plugin, dcc_info);
+
+
+ get_server_info
+
+
+ Prototype:
+
+ t_plugin_server_info *get_server_info (t_weechat_plugin *plugin)
+
+
+
+ Return list of IRC servers (connected or not).
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+
+ Return value: linked list of IRC servers.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ char *
+ name
+ server internal name
+
+
+ int
+ autoconnect
+ 1 if autoconnect at start-up, 0 otherwise
+
+
+ int
+ autoreconnect
+
+ 1 if autoreconnect when disconnected,
+ 0 otherwise
+
+
+
+ int
+ autoreconnect_delay
+ delay before trying again connection
+
+
+ int
+ command_line
+
+ 1 if server was on command line (so it is temporary),
+ 0 otherwise
+
+
+
+ char *
+ address
+ server address (host or IP)
+
+
+ int
+ port
+ port
+
+
+ int
+ ipv6
+ IPv6 connection
+
+
+ int
+ ssl
+ SSL connection
+
+
+ char *
+ password
+ server password
+
+
+ char *
+ nick1
+ first nickname
+
+
+ char *
+ nick2
+ alternate nickname
+
+
+ char *
+ nick3
+ second alternate nickname
+
+
+ char *
+ username
+ user name
+
+
+ char *
+ real name
+ real name
+
+
+ char *
+ command
+ command run once connected
+
+
+ int
+ command_delay
+ delay after execution of command
+
+
+ char *
+ autojoin
+ channels joined automatically
+
+
+ int
+ autorejoin
+
+ 1 if channels are rejoined when kicked,
+ 0 otherwise
+
+
+
+ char *
+ notify_levels
+ channels notify levels
+
+
+ char *
+ charset_decode_iso
+ channels charsets for decoding ISO
+
+
+ char *
+ charset_decode_utf
+ channels charsets for decoding UTF
+
+
+ char *
+ charset_encode
+ channels charsets for encoding messages
+
+
+ int
+ is_connected
+ 1 if connected to server, 0 otherwise
+
+
+ int
+ ssl_connected
+ 1 if connected with SSL, 0 otherwise
+
+
+ char *
+ nick
+ current nickname
+
+
+ int
+ is_away
+ 1 if away, 0 otherwise
+
+
+ time_t
+ away_time
+ time when user is marking as away
+
+
+ int
+ lag
+ lag (in milliseconds)
+
+
+ t_plugin_server_info *
+ prev_server
+ pointer to previous server info
+
+
+ t_plugin_server_info *
+ next_server
+ pointer to next server info
+
+
+
+
+
+
+ Note: result has to be free by a call to "free_server_info"
+ function after use.
+
+
+ Example:
+
+t_plugin_server_info *server_info, *ptr_server_info;
+server_info = plugin->get_server_info (plugin);
+if (server_info)
+{
+ for (ptr_server_info = server_info; ptr_server_info;
+ ptr_server_info = ptr_server_info->next_server)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ "server: %s, address: %s, port: %d %s",
+ ptr_server_info->name,
+ ptr_server_info->address,
+ ptr_server_info->port,
+ (ptr_server_info->is_connected) ? "(connected)" : "");
+ }
+ plugin->free_server_info (plugin, server_info);
+}
+
+
+
+
+
+ free_server_info
+
+
+ Prototype:
+
+ void free_server_info (t_weechat_plugin *plugin,
+ t_plugin_server_info *server_info)
+
+
+
+ Free memory used by server info list.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+ : pointer to server list
+ returned by "get_server_info" function
+
+
+
+
+
+ Return value: none.
+
+
+ Example:
+ plugin->free_server_info (plugin, server_info);
+
+
+
+
+ get_channel_info
+
+
+ Prototype:
+
+ t_plugin_channel_info *get_channel_info (t_weechat_plugin *plugin,
+ char *server)
+
+
+
+ Return list of IRC channels for a server.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+ : internal server name
+
+
+
+
+
+ Return value: linked list of IRC channels for server.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ int
+ type
+ 0 for a channel, 1 for a private
+
+
+ char *
+ name
+ name of channel
+
+
+ char *
+ topic
+ topic of channel
+
+
+ char *
+ modes
+ channel modes
+
+
+ int
+ limit
+ user limit
+
+
+ char *
+ key
+ channel key
+
+
+ int
+ nicks_count
+ number of nicks on channel
+
+
+ t_plugin_channel_info *
+ prev_channel
+ pointer to previous channel info
+
+
+ t_plugin_channel_info *
+ next_channel
+ pointer to next channel info
+
+
+
+
+
+
+ Note: result has to be free by a call to "free_channel_info"
+ function after use.
+
+
+ Example:
+
+t_plugin_channel_info *channel_info, *ptr_chan_info;
+channel_info = plugin->get_channel_info (plugin, "freenode");
+if (channel_info)
+{
+ for (ptr_chan_info = channel_info; ptr_chan_info;
+ ptr_chan_info = ptr_chan_info->next_channel)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (type %d)",
+ ptr_chan_info->name,
+ ptr_chan_info->type);
+ }
+ plugin->free_channel_info (plugin, channel_info);
+}
+
+
+
+
+
+ free_channel_info
+
+
+ Prototype:
+
+ void free_channel_info (t_weechat_plugin *plugin,
+ t_plugin_channel_info *channel_info)
+
+
+
+ Free memory used by channel info list.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+ : pointer to channel info list
+ returned by "get_channel_info" function
+
+
+
+
+
+ Return value: none.
+
+
+ Example:
+ plugin->free_channel_info (plugin, channel_info);
+
+
+
+
+ get_nick_info
+
+
+ Prototype:
+
+ t_plugin_nick_info *get_nick_info (t_weechat_plugin *plugin,
+ char *server, char *channel)
+
+
+
+ Return list of nicks for a channel.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+ : internal server name
+
+
+ : channel name
+
+
+
+
+
+ Return value: linked list of nicks on channel.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ char *
+ nick
+ nick name
+
+
+ int
+ flags
+
+ nick flags, binary "or" between values (1 = channel
+ owner, 2 = channel admin, 4 = op, 8 = halfop,
+ 16 = voice, 32 = away)
+
+
+
+ t_plugin_nick_info *
+ prev_nick
+ pointer to previous nick info
+
+
+ t_plugin_nick_info *
+ next_nick
+ pointer to next nick info
+
+
+
+
+
+
+ Note: result has to be free by a call to "free_nick_info"
+ function after use.
+
+
+ Example:
+
+t_plugin_nick_info *nick_info, *ptr_nick_info;
+nick_info = plugin->get_nick_info (plugin, "freenode", "#weechat");
+if (nick_info)
+{
+ for (ptr_nick_info = nick_info; ptr_nick_info;
+ ptr_nick_info = ptr_nick_info->next_nick)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (flags: %d)",
+ ptr_nick_info->nick,
+ ptr_nick_info->flags);
+ }
+ plugin->free_nick_info (plugin, nick_info);
+}
+
+
+
+
+
+ free_nick_info
+
+
+ Prototype:
+
+ void free_nick_info (t_weechat_plugin *plugin,
+ t_plugin_nick_info *nick_info)
+
+
+
+ Free memory used by nick info list.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+ : pointer to nick info list
+ returned by "get_nick_info" function
+
+
+
+
+
+ Return value: none.
+
+
+ Example:
+ plugin->free_nick_info (plugin, nick_info);
+
+
get_config
- Prototype :
+ Prototype:
char *get_config (t_weechat_plugin *plugin, char *option)
@@ -3285,7 +3879,7 @@ nick = weechat.get_info ("nick", "freenode")
- Ruby prototype :
+ Ruby prototype:
Weechat.get_dcc_info ( )
diff --git a/doc/fr/weechat.fr.xml b/doc/fr/weechat.fr.xml
index 850a35784..4eac21641 100644
--- a/doc/fr/weechat.fr.xml
+++ b/doc/fr/weechat.fr.xml
@@ -796,9 +796,17 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
- %Cnn
+ %Cxx
- couleur du texte "nn"
+ couleur du texte "xx"
+ (voir le tableau des couleurs ci-dessous)
+
+
+
+ %Cxx,yy
+
+ couleur du texte "xx"
+ et du fond "yy"
(voir le tableau des couleurs ci-dessous)
@@ -2226,20 +2234,24 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ Type
Champ
Description
+ char *
server
le serveur IRC
+ char *
channel
le canal IRC
+ int
type
le type de DCC :
@@ -2250,6 +2262,7 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ int
status
le statut du DCC :
@@ -2262,52 +2275,82 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ time_t
start_time
la date et heure de création du DCC
+ time_t
start_transfer
la date et heure de démarrage du transfert
+ unsigned long
addr
adresse IP de l'utilisateur distant
+ int
port
port utilisé pour le DCC
+ char *
nick
pseudo de l'utilisateur distant
+ char *
filename
nom de fichier
+ char *
local_filename
nom de fichier local
+ int
+ filename_suffix
+ suffixe si renommage de fichier
+
+
+ unsigned long
size
taille du fichier
+ unsigned long
pos
position actuelle dans le fichier
+ unsigned long
start_resume
position de démarrage après une interruption
+ unsigned long
bytes_per_sec
nombre d'octets transmis par seconde depuis le début
du transfert
+
+ t_plugin_dcc_info *
+ prev_dcc
+
+ pointeur vers l'info DCC précédente
+
+
+
+ t_plugin_dcc_info *
+ next_dcc
+
+ pointeur vers l'info DCC suivante
+
+
@@ -2370,6 +2413,570 @@ if (dcc_info)
+
+ get_server_info
+
+
+ Prototype :
+
+ t_plugin_server_info *get_server_info (t_weechat_plugin *plugin)
+
+
+
+ Renvoie la liste des serveurs IRC (connectés ou non).
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+
+ Valeur retournée : la liste chaînée des serveurs IRC.
+
+
+
+
+ Type
+ Champ
+ Description
+
+
+
+
+ char *
+ name
+ nom interne du serveur
+
+
+ int
+ autoconnect
+ 1 si auto-connexion au démarrage, 0 sinon
+
+
+ int
+ autoreconnect
+
+ 1 si auto-reconnexion quand déconnecté,
+ 0 sinon
+
+
+
+ int
+ autoreconnect_delay
+ délai avant de tenter une reconnexion
+
+
+ int
+ command_line
+
+ 1 si le serveur vient de la ligne de commande
+ (donc temporaire), 0 sinon
+
+
+
+ char *
+ address
+ adresse du serveur (nom ou IP)
+
+
+ int
+ port
+ port
+
+
+ int
+ ipv6
+ connexion IPv6
+
+
+ int
+ ssl
+ connexion SSL
+
+
+ char *
+ password
+ mot de passe pour le serveur
+
+
+ char *
+ nick1
+ premier pseudo
+
+
+ char *
+ nick2
+ pseudo alternatif
+
+
+ char *
+ nick3
+ second pseudo alternatif
+
+
+ char *
+ username
+ nom d'utilisateur
+
+
+ char *
+ real name
+ nom réel
+
+
+ char *
+ command
+ commande exécutée une fois connecté
+
+
+ int
+ command_delay
+ délai après exécution de la commande
+
+
+ char *
+ autojoin
+ canaux joints automatiquement
+
+
+ int
+ autorejoin
+
+ 1 si les canaux sont rejoints après un "kick",
+ 0 sinon
+
+
+
+ char *
+ notify_levels
+ niveaux de notification des canaux
+
+
+ char *
+ charset_decode_iso
+
+ jeux de caractères de décodage ISO pour les canaux
+
+
+
+ char *
+ charset_decode_utf
+
+ jeux de caractères de décodage UTF pour les canaux
+
+
+
+ char *
+ charset_encode
+
+ jeux de caractères d'encodage pour les canaux
+
+
+
+ int
+ is_connected
+ 1 si connecté au serveur, 0 sinon
+
+
+ int
+ ssl_connected
+ 1 si connecté via SSL, 0 sinon
+
+
+ char *
+ nick
+ pseudo courant
+
+
+ int
+ is_away
+ 1 si absent, 0 sinon
+
+
+ time_t
+ away_time
+
+ date/heure à laquelle l'utilisateur a été marqué absent
+
+
+
+ int
+ lag
+ lag (en millisecondes)
+
+
+ t_plugin_server_info *
+ prev_server
+ pointeur vers les infos du serveur précédent
+
+
+ t_plugin_server_info *
+ next_server
+ pointeur vers les infos du serveur suivant
+
+
+
+
+
+
+ Note : le résultat doit être libéré par un appel à la fonction
+ "free_server_info" après utilisation.
+
+
+ Exemple :
+
+t_plugin_server_info *server_info, *ptr_server_info;
+server_info = plugin->get_server_info (plugin);
+if (server_info)
+{
+ for (ptr_server_info = server_info; ptr_server_info;
+ ptr_server_info = ptr_server_info->next_server)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ "serveur: %s, addresse: %s, port: %d %s",
+ ptr_server_info->name,
+ ptr_server_info->address,
+ ptr_server_info->port,
+ (ptr_server_info->is_connected) ? "(connecté)" : "");
+ }
+ plugin->free_server_info (plugin, server_info);
+}
+
+
+
+
+
+ free_server_info
+
+
+ Prototype :
+
+ void free_server_info (t_weechat_plugin *plugin,
+ t_plugin_server_info *server_info)
+
+
+
+ Libère la mémoire utilisée par une liste de serveurs.
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+ : pointeur vers la liste de
+ serveurs retournée par la fonction "get_server_info"
+
+
+
+
+
+ Valeur renvoyée : aucune.
+
+
+ Exemple :
+ plugin->free_server_info (plugin, server_info);
+
+
+
+
+ get_channel_info
+
+
+ Prototype :
+
+ t_plugin_channel_info *get_channel_info (t_weechat_plugin *plugin,
+ char *serveur)
+
+
+
+ Renvoie la liste des canaux IRC pour un serveur.
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+ : nom interne du serveur
+
+
+
+
+
+ Valeur renvoyée : la liste chaînée des canaux IRC du serveur.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ int
+ type
+ 0 pour un canal, 1 pour un privé
+
+
+ char *
+ name
+ nom du canal
+
+
+ char *
+ topic
+ titre du canal
+
+
+ char *
+ modes
+ modes du canal
+
+
+ int
+ limit
+ limite d'utilisateurs
+
+
+ char *
+ key
+ clé du canal
+
+
+ int
+ nicks_count
+ nombre de pseudos présents sur le canal
+
+
+ t_plugin_channel_info *
+ prev_channel
+ pointeur vers les infos du canal précédent
+
+
+ t_plugin_channel_info *
+ next_channel
+ pointeur vers les infos du canal suivant
+
+
+
+
+
+
+ Note : le résultat doit être libéré par un appel à la fonction
+ "free_channel_info" après utilisation.
+
+
+ Exemple :
+
+t_plugin_channel_info *channel_info, *ptr_chan_info;
+channel_info = plugin->get_channel_info (plugin, "freenode");
+if (channel_info)
+{
+ for (ptr_chan_info = channel_info; ptr_chan_info;
+ ptr_chan_info = ptr_chan_info->next_channel)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (type %d)",
+ ptr_chan_info->name,
+ ptr_chan_info->type);
+ }
+ plugin->free_channel_info (plugin, channel_info);
+}
+
+
+
+
+
+ free_channel_info
+
+
+ Prototype :
+
+ void free_channel_info (t_weechat_plugin *plugin,
+ t_plugin_channel_info *channel_info)
+
+
+
+ Libère la mémoire utilisée par une liste de canaux.
+
+
+ Arguments:
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+ : pointeur vers la liste de
+ canaux retournée par la fonction "get_channel_info"
+
+
+
+
+
+ Valeur renvoyée : aucune.
+
+
+ Exemple :
+ plugin->free_channel_info (plugin, channel_info);
+
+
+
+
+ get_nick_info
+
+
+ Prototype :
+
+ t_plugin_nick_info *get_nick_info (t_weechat_plugin *plugin,
+ char *serveur, char *canal)
+
+
+
+ Renvoie la liste des pseudos pour un canal.
+
+
+ Arguments:
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+ : nom interne du serveur
+
+
+ : nom du canal
+
+
+
+
+
+ Valeur renvoyée : la liste chaînée des pseudos présents
+ sur le canal.
+
+
+
+
+ Type
+ Champ
+ Description
+
+
+
+
+ char *
+ nick
+ pseudo
+
+
+ int
+ flags
+
+ propriétés du pseudo, "ou" binaire entre plusieurs
+ valeurs (1 =propriétaire du canal, 2 = administrateur
+ du canal, 4 = op, 8 = demi-op, 16 = voix, 32 = absent)
+
+
+
+ t_plugin_nick_info *
+ prev_nick
+ pointeur vers les infos du pseudo précédent
+
+
+ t_plugin_nick_info *
+ next_nick
+ pointeur vers les infos du pseudo précédent
+
+
+
+
+
+
+ Note : le résultat doit être libéré par un appel à la fonction
+ "free_nick_info" après utilisation.
+
+
+ Exemple :
+
+t_plugin_nick_info *nick_info, *ptr_nick_info;
+nick_info = plugin->get_nick_info (plugin, "freenode", "#weechat");
+if (nick_info)
+{
+ for (ptr_nick_info = nick_info; ptr_nick_info;
+ ptr_nick_info = ptr_nick_info->next_nick)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (flags: %d)",
+ ptr_nick_info->nick,
+ ptr_nick_info->flags);
+ }
+ plugin->free_nick_info (plugin, nick_info);
+}
+
+
+
+
+
+ free_nick_info
+
+
+ Prototype :
+
+ void free_nick_info (t_weechat_plugin *plugin,
+ t_plugin_nick_info *nick_info)
+
+
+
+ Libère la mémoire utilisée par une liste de pseudos.
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+ : pointeur vers la liste de
+ pseudos retournée par la fonction "get_nick_info"
+
+
+
+
+
+ Valeur renvoyée : aucune.
+
+
+ Exemple :
+ plugin->free_nick_info (plugin, nick_info);
+
+
+
get_config
diff --git a/weechat/doc/en/weechat.en.xml b/weechat/doc/en/weechat.en.xml
index e2a4d0abc..e47c2cea4 100644
--- a/weechat/doc/en/weechat.en.xml
+++ b/weechat/doc/en/weechat.en.xml
@@ -782,9 +782,18 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
- %Cnn
+ %Cxx
- text color "nn" (see colors table below)
+ text color "xx"
+ (see colors table below)
+
+
+
+ %Cxx,yy
+
+ text color "xx"
+ and background "yy"
+ (see colors table below)
@@ -2186,20 +2195,24 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ Type
Field
Description
+ char *
server
IRC server
+ char *
channel
IRC channel
+ int
type
DCC type:
@@ -2210,6 +2223,7 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ int*
status
DCC status:
@@ -2222,51 +2236,82 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ time_t
start_time
date/time of DCC creation
+ time_t
start_transfer
date/time of DCC transfer start
+ unsigned long
addr
IP address of remote user
+ int
port
port used for DCC
+ char *
nick
remote nick
+ char *
filename
file name
+ char *
local_filename
local file name
+ int
+ filename_suffix
+ suffix if renaming file
+
+
+ unsigned long
size
file size
+ unsigned long
pos
position in file
+ unsigned long
start_resume
start position after interruption
+ unsigned long
bytes_per_sec
number of bytes per second since transfer start
+
+ t_plugin_dcc_info *
+ prev_dcc
+
+ pointer to previous DCC info
+
+
+
+ t_plugin_dcc_info *
+ next_dcc
+
+ pointer to next DCC info
+
+
+
@@ -2294,7 +2339,7 @@ if (dcc_info)
free_dcc_info
- Prototype :
+ Prototype:
void free_dcc_info (t_weechat_plugin *plugin,
t_plugin_dcc_info *dcc_info)
@@ -2327,12 +2372,561 @@ if (dcc_info)
plugin->free_dcc_info (plugin, dcc_info);
+
+
+ get_server_info
+
+
+ Prototype:
+
+ t_plugin_server_info *get_server_info (t_weechat_plugin *plugin)
+
+
+
+ Return list of IRC servers (connected or not).
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+
+ Return value: linked list of IRC servers.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ char *
+ name
+ server internal name
+
+
+ int
+ autoconnect
+ 1 if autoconnect at start-up, 0 otherwise
+
+
+ int
+ autoreconnect
+
+ 1 if autoreconnect when disconnected,
+ 0 otherwise
+
+
+
+ int
+ autoreconnect_delay
+ delay before trying again connection
+
+
+ int
+ command_line
+
+ 1 if server was on command line (so it is temporary),
+ 0 otherwise
+
+
+
+ char *
+ address
+ server address (host or IP)
+
+
+ int
+ port
+ port
+
+
+ int
+ ipv6
+ IPv6 connection
+
+
+ int
+ ssl
+ SSL connection
+
+
+ char *
+ password
+ server password
+
+
+ char *
+ nick1
+ first nickname
+
+
+ char *
+ nick2
+ alternate nickname
+
+
+ char *
+ nick3
+ second alternate nickname
+
+
+ char *
+ username
+ user name
+
+
+ char *
+ real name
+ real name
+
+
+ char *
+ command
+ command run once connected
+
+
+ int
+ command_delay
+ delay after execution of command
+
+
+ char *
+ autojoin
+ channels joined automatically
+
+
+ int
+ autorejoin
+
+ 1 if channels are rejoined when kicked,
+ 0 otherwise
+
+
+
+ char *
+ notify_levels
+ channels notify levels
+
+
+ char *
+ charset_decode_iso
+ channels charsets for decoding ISO
+
+
+ char *
+ charset_decode_utf
+ channels charsets for decoding UTF
+
+
+ char *
+ charset_encode
+ channels charsets for encoding messages
+
+
+ int
+ is_connected
+ 1 if connected to server, 0 otherwise
+
+
+ int
+ ssl_connected
+ 1 if connected with SSL, 0 otherwise
+
+
+ char *
+ nick
+ current nickname
+
+
+ int
+ is_away
+ 1 if away, 0 otherwise
+
+
+ time_t
+ away_time
+ time when user is marking as away
+
+
+ int
+ lag
+ lag (in milliseconds)
+
+
+ t_plugin_server_info *
+ prev_server
+ pointer to previous server info
+
+
+ t_plugin_server_info *
+ next_server
+ pointer to next server info
+
+
+
+
+
+
+ Note: result has to be free by a call to "free_server_info"
+ function after use.
+
+
+ Example:
+
+t_plugin_server_info *server_info, *ptr_server_info;
+server_info = plugin->get_server_info (plugin);
+if (server_info)
+{
+ for (ptr_server_info = server_info; ptr_server_info;
+ ptr_server_info = ptr_server_info->next_server)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ "server: %s, address: %s, port: %d %s",
+ ptr_server_info->name,
+ ptr_server_info->address,
+ ptr_server_info->port,
+ (ptr_server_info->is_connected) ? "(connected)" : "");
+ }
+ plugin->free_server_info (plugin, server_info);
+}
+
+
+
+
+
+ free_server_info
+
+
+ Prototype:
+
+ void free_server_info (t_weechat_plugin *plugin,
+ t_plugin_server_info *server_info)
+
+
+
+ Free memory used by server info list.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+ : pointer to server list
+ returned by "get_server_info" function
+
+
+
+
+
+ Return value: none.
+
+
+ Example:
+ plugin->free_server_info (plugin, server_info);
+
+
+
+
+ get_channel_info
+
+
+ Prototype:
+
+ t_plugin_channel_info *get_channel_info (t_weechat_plugin *plugin,
+ char *server)
+
+
+
+ Return list of IRC channels for a server.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+ : internal server name
+
+
+
+
+
+ Return value: linked list of IRC channels for server.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ int
+ type
+ 0 for a channel, 1 for a private
+
+
+ char *
+ name
+ name of channel
+
+
+ char *
+ topic
+ topic of channel
+
+
+ char *
+ modes
+ channel modes
+
+
+ int
+ limit
+ user limit
+
+
+ char *
+ key
+ channel key
+
+
+ int
+ nicks_count
+ number of nicks on channel
+
+
+ t_plugin_channel_info *
+ prev_channel
+ pointer to previous channel info
+
+
+ t_plugin_channel_info *
+ next_channel
+ pointer to next channel info
+
+
+
+
+
+
+ Note: result has to be free by a call to "free_channel_info"
+ function after use.
+
+
+ Example:
+
+t_plugin_channel_info *channel_info, *ptr_chan_info;
+channel_info = plugin->get_channel_info (plugin, "freenode");
+if (channel_info)
+{
+ for (ptr_chan_info = channel_info; ptr_chan_info;
+ ptr_chan_info = ptr_chan_info->next_channel)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (type %d)",
+ ptr_chan_info->name,
+ ptr_chan_info->type);
+ }
+ plugin->free_channel_info (plugin, channel_info);
+}
+
+
+
+
+
+ free_channel_info
+
+
+ Prototype:
+
+ void free_channel_info (t_weechat_plugin *plugin,
+ t_plugin_channel_info *channel_info)
+
+
+
+ Free memory used by channel info list.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+ : pointer to channel info list
+ returned by "get_channel_info" function
+
+
+
+
+
+ Return value: none.
+
+
+ Example:
+ plugin->free_channel_info (plugin, channel_info);
+
+
+
+
+ get_nick_info
+
+
+ Prototype:
+
+ t_plugin_nick_info *get_nick_info (t_weechat_plugin *plugin,
+ char *server, char *channel)
+
+
+
+ Return list of nicks for a channel.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+ : internal server name
+
+
+ : channel name
+
+
+
+
+
+ Return value: linked list of nicks on channel.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ char *
+ nick
+ nick name
+
+
+ int
+ flags
+
+ nick flags, binary "or" between values (1 = channel
+ owner, 2 = channel admin, 4 = op, 8 = halfop,
+ 16 = voice, 32 = away)
+
+
+
+ t_plugin_nick_info *
+ prev_nick
+ pointer to previous nick info
+
+
+ t_plugin_nick_info *
+ next_nick
+ pointer to next nick info
+
+
+
+
+
+
+ Note: result has to be free by a call to "free_nick_info"
+ function after use.
+
+
+ Example:
+
+t_plugin_nick_info *nick_info, *ptr_nick_info;
+nick_info = plugin->get_nick_info (plugin, "freenode", "#weechat");
+if (nick_info)
+{
+ for (ptr_nick_info = nick_info; ptr_nick_info;
+ ptr_nick_info = ptr_nick_info->next_nick)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (flags: %d)",
+ ptr_nick_info->nick,
+ ptr_nick_info->flags);
+ }
+ plugin->free_nick_info (plugin, nick_info);
+}
+
+
+
+
+
+ free_nick_info
+
+
+ Prototype:
+
+ void free_nick_info (t_weechat_plugin *plugin,
+ t_plugin_nick_info *nick_info)
+
+
+
+ Free memory used by nick info list.
+
+
+ Arguments:
+
+
+
+ : pointer to plugin structure
+
+
+
+
+ : pointer to nick info list
+ returned by "get_nick_info" function
+
+
+
+
+
+ Return value: none.
+
+
+ Example:
+ plugin->free_nick_info (plugin, nick_info);
+
+
get_config
- Prototype :
+ Prototype:
char *get_config (t_weechat_plugin *plugin, char *option)
@@ -3285,7 +3879,7 @@ nick = weechat.get_info ("nick", "freenode")
- Ruby prototype :
+ Ruby prototype:
Weechat.get_dcc_info ( )
diff --git a/weechat/doc/fr/weechat.fr.xml b/weechat/doc/fr/weechat.fr.xml
index 850a35784..4eac21641 100644
--- a/weechat/doc/fr/weechat.fr.xml
+++ b/weechat/doc/fr/weechat.fr.xml
@@ -796,9 +796,17 @@ Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
- %Cnn
+ %Cxx
- couleur du texte "nn"
+ couleur du texte "xx"
+ (voir le tableau des couleurs ci-dessous)
+
+
+
+ %Cxx,yy
+
+ couleur du texte "xx"
+ et du fond "yy"
(voir le tableau des couleurs ci-dessous)
@@ -2226,20 +2234,24 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ Type
Champ
Description
+ char *
server
le serveur IRC
+ char *
channel
le canal IRC
+ int
type
le type de DCC :
@@ -2250,6 +2262,7 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ int
status
le statut du DCC :
@@ -2262,52 +2275,82 @@ char *nick = plugin->get_info (plugin, "nick", "freenode");
+ time_t
start_time
la date et heure de création du DCC
+ time_t
start_transfer
la date et heure de démarrage du transfert
+ unsigned long
addr
adresse IP de l'utilisateur distant
+ int
port
port utilisé pour le DCC
+ char *
nick
pseudo de l'utilisateur distant
+ char *
filename
nom de fichier
+ char *
local_filename
nom de fichier local
+ int
+ filename_suffix
+ suffixe si renommage de fichier
+
+
+ unsigned long
size
taille du fichier
+ unsigned long
pos
position actuelle dans le fichier
+ unsigned long
start_resume
position de démarrage après une interruption
+ unsigned long
bytes_per_sec
nombre d'octets transmis par seconde depuis le début
du transfert
+
+ t_plugin_dcc_info *
+ prev_dcc
+
+ pointeur vers l'info DCC précédente
+
+
+
+ t_plugin_dcc_info *
+ next_dcc
+
+ pointeur vers l'info DCC suivante
+
+
@@ -2370,6 +2413,570 @@ if (dcc_info)
+
+ get_server_info
+
+
+ Prototype :
+
+ t_plugin_server_info *get_server_info (t_weechat_plugin *plugin)
+
+
+
+ Renvoie la liste des serveurs IRC (connectés ou non).
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+
+ Valeur retournée : la liste chaînée des serveurs IRC.
+
+
+
+
+ Type
+ Champ
+ Description
+
+
+
+
+ char *
+ name
+ nom interne du serveur
+
+
+ int
+ autoconnect
+ 1 si auto-connexion au démarrage, 0 sinon
+
+
+ int
+ autoreconnect
+
+ 1 si auto-reconnexion quand déconnecté,
+ 0 sinon
+
+
+
+ int
+ autoreconnect_delay
+ délai avant de tenter une reconnexion
+
+
+ int
+ command_line
+
+ 1 si le serveur vient de la ligne de commande
+ (donc temporaire), 0 sinon
+
+
+
+ char *
+ address
+ adresse du serveur (nom ou IP)
+
+
+ int
+ port
+ port
+
+
+ int
+ ipv6
+ connexion IPv6
+
+
+ int
+ ssl
+ connexion SSL
+
+
+ char *
+ password
+ mot de passe pour le serveur
+
+
+ char *
+ nick1
+ premier pseudo
+
+
+ char *
+ nick2
+ pseudo alternatif
+
+
+ char *
+ nick3
+ second pseudo alternatif
+
+
+ char *
+ username
+ nom d'utilisateur
+
+
+ char *
+ real name
+ nom réel
+
+
+ char *
+ command
+ commande exécutée une fois connecté
+
+
+ int
+ command_delay
+ délai après exécution de la commande
+
+
+ char *
+ autojoin
+ canaux joints automatiquement
+
+
+ int
+ autorejoin
+
+ 1 si les canaux sont rejoints après un "kick",
+ 0 sinon
+
+
+
+ char *
+ notify_levels
+ niveaux de notification des canaux
+
+
+ char *
+ charset_decode_iso
+
+ jeux de caractères de décodage ISO pour les canaux
+
+
+
+ char *
+ charset_decode_utf
+
+ jeux de caractères de décodage UTF pour les canaux
+
+
+
+ char *
+ charset_encode
+
+ jeux de caractères d'encodage pour les canaux
+
+
+
+ int
+ is_connected
+ 1 si connecté au serveur, 0 sinon
+
+
+ int
+ ssl_connected
+ 1 si connecté via SSL, 0 sinon
+
+
+ char *
+ nick
+ pseudo courant
+
+
+ int
+ is_away
+ 1 si absent, 0 sinon
+
+
+ time_t
+ away_time
+
+ date/heure à laquelle l'utilisateur a été marqué absent
+
+
+
+ int
+ lag
+ lag (en millisecondes)
+
+
+ t_plugin_server_info *
+ prev_server
+ pointeur vers les infos du serveur précédent
+
+
+ t_plugin_server_info *
+ next_server
+ pointeur vers les infos du serveur suivant
+
+
+
+
+
+
+ Note : le résultat doit être libéré par un appel à la fonction
+ "free_server_info" après utilisation.
+
+
+ Exemple :
+
+t_plugin_server_info *server_info, *ptr_server_info;
+server_info = plugin->get_server_info (plugin);
+if (server_info)
+{
+ for (ptr_server_info = server_info; ptr_server_info;
+ ptr_server_info = ptr_server_info->next_server)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ "serveur: %s, addresse: %s, port: %d %s",
+ ptr_server_info->name,
+ ptr_server_info->address,
+ ptr_server_info->port,
+ (ptr_server_info->is_connected) ? "(connecté)" : "");
+ }
+ plugin->free_server_info (plugin, server_info);
+}
+
+
+
+
+
+ free_server_info
+
+
+ Prototype :
+
+ void free_server_info (t_weechat_plugin *plugin,
+ t_plugin_server_info *server_info)
+
+
+
+ Libère la mémoire utilisée par une liste de serveurs.
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+ : pointeur vers la liste de
+ serveurs retournée par la fonction "get_server_info"
+
+
+
+
+
+ Valeur renvoyée : aucune.
+
+
+ Exemple :
+ plugin->free_server_info (plugin, server_info);
+
+
+
+
+ get_channel_info
+
+
+ Prototype :
+
+ t_plugin_channel_info *get_channel_info (t_weechat_plugin *plugin,
+ char *serveur)
+
+
+
+ Renvoie la liste des canaux IRC pour un serveur.
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+ : nom interne du serveur
+
+
+
+
+
+ Valeur renvoyée : la liste chaînée des canaux IRC du serveur.
+
+
+
+
+ Type
+ Field
+ Description
+
+
+
+
+ int
+ type
+ 0 pour un canal, 1 pour un privé
+
+
+ char *
+ name
+ nom du canal
+
+
+ char *
+ topic
+ titre du canal
+
+
+ char *
+ modes
+ modes du canal
+
+
+ int
+ limit
+ limite d'utilisateurs
+
+
+ char *
+ key
+ clé du canal
+
+
+ int
+ nicks_count
+ nombre de pseudos présents sur le canal
+
+
+ t_plugin_channel_info *
+ prev_channel
+ pointeur vers les infos du canal précédent
+
+
+ t_plugin_channel_info *
+ next_channel
+ pointeur vers les infos du canal suivant
+
+
+
+
+
+
+ Note : le résultat doit être libéré par un appel à la fonction
+ "free_channel_info" après utilisation.
+
+
+ Exemple :
+
+t_plugin_channel_info *channel_info, *ptr_chan_info;
+channel_info = plugin->get_channel_info (plugin, "freenode");
+if (channel_info)
+{
+ for (ptr_chan_info = channel_info; ptr_chan_info;
+ ptr_chan_info = ptr_chan_info->next_channel)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (type %d)",
+ ptr_chan_info->name,
+ ptr_chan_info->type);
+ }
+ plugin->free_channel_info (plugin, channel_info);
+}
+
+
+
+
+
+ free_channel_info
+
+
+ Prototype :
+
+ void free_channel_info (t_weechat_plugin *plugin,
+ t_plugin_channel_info *channel_info)
+
+
+
+ Libère la mémoire utilisée par une liste de canaux.
+
+
+ Arguments:
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+ : pointeur vers la liste de
+ canaux retournée par la fonction "get_channel_info"
+
+
+
+
+
+ Valeur renvoyée : aucune.
+
+
+ Exemple :
+ plugin->free_channel_info (plugin, channel_info);
+
+
+
+
+ get_nick_info
+
+
+ Prototype :
+
+ t_plugin_nick_info *get_nick_info (t_weechat_plugin *plugin,
+ char *serveur, char *canal)
+
+
+
+ Renvoie la liste des pseudos pour un canal.
+
+
+ Arguments:
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+ : nom interne du serveur
+
+
+ : nom du canal
+
+
+
+
+
+ Valeur renvoyée : la liste chaînée des pseudos présents
+ sur le canal.
+
+
+
+
+ Type
+ Champ
+ Description
+
+
+
+
+ char *
+ nick
+ pseudo
+
+
+ int
+ flags
+
+ propriétés du pseudo, "ou" binaire entre plusieurs
+ valeurs (1 =propriétaire du canal, 2 = administrateur
+ du canal, 4 = op, 8 = demi-op, 16 = voix, 32 = absent)
+
+
+
+ t_plugin_nick_info *
+ prev_nick
+ pointeur vers les infos du pseudo précédent
+
+
+ t_plugin_nick_info *
+ next_nick
+ pointeur vers les infos du pseudo précédent
+
+
+
+
+
+
+ Note : le résultat doit être libéré par un appel à la fonction
+ "free_nick_info" après utilisation.
+
+
+ Exemple :
+
+t_plugin_nick_info *nick_info, *ptr_nick_info;
+nick_info = plugin->get_nick_info (plugin, "freenode", "#weechat");
+if (nick_info)
+{
+ for (ptr_nick_info = nick_info; ptr_nick_info;
+ ptr_nick_info = ptr_nick_info->next_nick)
+ {
+ plugin->printf (plugin, NULL, NULL,
+ " %s (flags: %d)",
+ ptr_nick_info->nick,
+ ptr_nick_info->flags);
+ }
+ plugin->free_nick_info (plugin, nick_info);
+}
+
+
+
+
+
+ free_nick_info
+
+
+ Prototype :
+
+ void free_nick_info (t_weechat_plugin *plugin,
+ t_plugin_nick_info *nick_info)
+
+
+
+ Libère la mémoire utilisée par une liste de pseudos.
+
+
+ Paramètres :
+
+
+
+ : pointeur vers la structure
+ de l'extension
+
+
+
+
+ : pointeur vers la liste de
+ pseudos retournée par la fonction "get_nick_info"
+
+
+
+
+
+ Valeur renvoyée : aucune.
+
+
+ Exemple :
+ plugin->free_nick_info (plugin, nick_info);
+
+
+