Introduction
************

Description
===========

WeeChat (Wee Enhanced Environment for Chat) est un client IRC libre, rapide et léger, concu pour différents systèmes d'exploitation.

Ses principales caractéristiques sont les suivantes :

  - connexion multi-serveurs

  - plusieurs interfaces : Curses, Gtk et Qt

  - petit, rapide et léger

  - paramétrable et extensible avec des scripts

  - conforme aux RFCs 1459, 2810, 2811, 2812, et 2813

  - multi-plateformes (Gnu/Linux, *BSD, Windows et d'autres systèmes)

  - 100% GPL, logiciel libre

La page d'accueil de WeeChat est ici :

http://weechat.flashtux.org

Pré-requis
==========

Pour installer WeeChat, vous devez avoir :

  * Un système Gnu/Linux (avec le compilateur et les outils associés pour le paquet des sources)

  * Droits "root" (pour installer WeeChat)

  * Selon l'interface, une des bibliothèques suivantes :

       - Curses: la librairie ncurses,

       - Gtk: *** interface non développée ***,

       - Qt: *** interface non développée ***,

Installation
************

Paquet binaire
==============

Les paquets binaires sont disponibles pour les distributions suivantes :

  * Debian (ou toute distribution compatible Debian)

     Pour installer : dpkg -i /chemin/weechat_x.y.z-1_i386.deb

  * Mandrake/Redhat (ou toute distribution compatible avec les RPM)

     Pour installer : rpm -i /chemin/weechat-x.y.z-1.i386.rpm

  * Gentoo

     Pour installer : emerge weechat

  * *BSD (non disponible !)

  * Slackware (non disponible !)

  * Windows (non disponible !)

où x.y.z est la version (par exemple 0.0.1)

Paquet source
=============

Tapez simplement dans une console ou un terminal :

./configure

make

Note: pour ne construire que certaines interfaces, vous pouvez passer des paramètres à ./configure, tapez ./configure --help pour de l'aide sur ces options.

Obtenez les droits root et installez WeeChat :

su

(entrez le mot de passe de root)

make install

Sources CVS
===========

Attention: les sources CVS sont réservés aux utilisateurs avancés : il se peut que WeeChat ne compile pas et qu'il soit trs̀ instable. Vous êtes prévenus !

Pour récupérer les sources CVS, tapez ces commandes :

cvs -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/weechat login

cvs -z3 -d:pserver:anoncvs@subversions.gnu.org:/cvsroot/weechat co weechat

(lorsqu'un mot de passe est demandé, tapez simplement sur Entrée)

Exécutez ce script :

./autogen.sh

Suivez alors les instructions du paquet sources - see Paquet source.

Utilisation
***********

Lancer WeeChat
==============

Paramètres de ligne de commande
-------------------------------

-c, --config
     Afficher l'aide sur le fichier de config (liste des options)

-h, --help
     Afficher l'aide

-l, --license
     Afficher la licence de WeeChat

-v, --version
     Afficher la version de WeeChat

Lancer WeeChat
--------------

Tapez simplement cette commande pour lancer WeeChat :

weechat-curses (pour l'interface Curses)

ou weechat-gtk (pour l'interface Gtk)

ou weechat-qt (pour l'interface Qt)

Lorsque vous lancez WeeChat pour la première fois, un fichier de configuration par défaut est créé, avec les options par défaut.

Le fichier de configuration par défaut est : ~/.weechat/weechat.rc

Vous pouvez éditer ce fichier pour configurer WeeChat à votre convenance, ou vous pouvez modifier les paramètres dans WeeChat avec la commande /set - see Commandes WeeChat.

Fichier de configuration
========================

Liste des options du fichier de configuration :

look_set_title
     Définit le titre de la fenêtre (terminal pour l'interface Curses) avec le nom et la version

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_startup_logo
     Afficher le logo WeeChat au démarrage

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_startup_version
     Afficher la version de WeeChat au démarrage

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_weechat_slogan
     Slogan WeeChat (si vide, le slogan ne sera pas utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: 'the geekest IRC client!'

look_charset_decode
     Jeu de caractères pour décoder les messages du serveur, exemples: UTF-8, ISO-8859-1 (si non renseigné, les messages ne sont pas convertis)

     Type: chaîne (toute chaîne), valeur par défaut: ''

look_charset_encode
     Jeu de caractères pour encoder les messages envoyés au serveur, exemples: UFT-8, ISO-8859-1 (si non renseigné, le jeu de caractères local est utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: ''

look_color_nicks
     Afficher les utilisateurs avec différentes couleurs

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_color_actions
     Afficher les actions avec différentes couleurs

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_remove_colors_from_msgs
     Supprimer les couleurs dans les messages entrants

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_nicklist
     Afficher la fenêtre des utilisateurs (pour les fenêtres de canaux)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_nicklist_position
     Position de la fenêtre d'utilisateurs (haut (top), gauche (left), droite (right, par défaut), bas (bottom))

     Type: chaîne (valeurs: 'left', 'right', 'top', 'bottom'), valeur par défaut: 'right'

look_nicklist_min_size
     Taille minimum pour la fenêtre d'utilisateurs (largeur ou hauteur, selon look_nicklist_position (0 = pas de taille minimum))

     Type: entier (valeurs: entre 0 et 100), valeur par défaut: 0

look_nicklist_max_size
     Taille maximum pour la fenêtre d'utilisateurs (largeur ou hauteur, selon look_nicklist_position (0 = pas de taille maximum; si min == max et > 0, alors la taille est fixe))

     Type: entier (valeurs: entre 0 et 100), valeur par défaut: 0

look_no_nickname
     Texte à afficher en lieu et place du nom d'utilisateur lorsque la connexion n'est pas active

     Type: chaîne (toute chaîne), valeur par défaut: '-cmd-'

look_nickmode
     Afficher le mode de l'utilisateur ((half)op/voice) devant chaque utilisateur

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_nickmode_empty
     Afficher un espace si le mode utilisateur n'est pas (half)op/voice

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

look_nick_completor
     La chaîne affichée après la complétion des utilisateurs

     Type: chaîne (toute chaîne), valeur par défaut: ':'

look_infobar
     Active la barre d'infos

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

look_infobar_timestamp
     Horodatage pour les conversations sauvegardées

     Type: chaîne (toute chaîne), valeur par défaut: '%B, %A %d %Y - %H:%M'

look_infobar_delay_highlight
     Délai (en secondes) pour la notification des messages dans la barre d'infos (0 = désactiver les notifications dans la barre d'infos)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 7

col_title
     Couleur pour la barre de titre

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_title_bg
     Couleur de fond pour la barre de titre

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_chat
     Couleur pour le texte de discussion

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_chat_time
     Couleur pour l'heure dans la fenêtre de discussion

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_chat_time_sep
     Couleur pour la séparation de l'heure (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'brown'

col_chat_prefix1
     Couleur pour le 1er et le 3ème caractère du préfixe

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightcyan'

col_chat_prefix2
     Couleur pour le caractère du milieu du préfixe

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_chat_nick
     Couleur pour les noms d'utilisateurs dans les actions (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightcyan'

col_chat_host
     Couleur pour les noms de machines (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_chat_channel
     Couleur pour les canaux dans les actions (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_chat_dark
     Couleur pour les séparateurs sombres (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'green'

col_chat_highlight
     Couleur pour le pseudo surligné (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_chat_bg
     Couleur de fond pour la fenêtre de discussion

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_status
     Couleur pour la barre de statut

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_status_delimiters
     Couleur pour les délimiteurs de la barre de statut

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_status_data_msg
     Couleur pour une fenêtre avec de nouvelles infos (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_status_highlight
     Couleur pour une fenêtre avec un highlight (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightmagenta'

col_status_data_other
     Couleur pour une fenêtre avec des nouvelles données (pas des infos) (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_status_more
     Couleur pour une fenêtre avec des nouvelles données (barre de statut)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_status_bg
     Couleur de fond pour la fenêtre de statut

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_infobar
     Couleur pour la barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'black'

col_infobar_highlight
     Couleur pour la notification dans la barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_infobar_bg
     Couleur de fond pour la fenêtre de barre d'infos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_input
     Couleur pour le texte saisi

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_input_channel
     Couleur pour le texte saisi (nom du canal)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_input_nick
     Couleur pour le texte saisi (pseudo)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_input_bg
     Couleur de fond pour la fenêtre de saisie

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_nick
     Couleur pour les pseudos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_nick_away
     Couleur pour les pseudos absents

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'cyan'

col_nick_op
     Couleur pour le symbole opérateur

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_nick_halfop
     Couleur pour le symbole demi-opérateur

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightmagenta'

col_nick_voice
     Couleur pour le symbole voix

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_nick_sep
     Couleur pour le séparateur de pseudo

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'blue'

col_nick_self
     Couleur pour le pseudo local

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_nick_private
     Couleur pour l'autre pseudo dans la fenêtre privée

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_nick_bg
     Couleur de fond pour les pseudos

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'default'

col_chat_dcc_selected
     Couleur pour le DCC sélectionné (fenêtre de discussion)

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_dcc_waiting
     Couleur pour le statut dcc "attente"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'white'

col_dcc_connecting
     Couleur pour le statut dcc "connexion"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'yellow'

col_dcc_active
     Couleur pour le statut dcc "actif"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightblue'

col_dcc_done
     Couleur pour le statut dcc "terminé"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightgreen'

col_dcc_failed
     Couleur pour le statut dcc "échoué"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightred'

col_dcc_aborted
     Couleur pour le statut dcc "interrompu"

     Type: couleur (couleur Curses ou Gtk), valeur par défaut: 'lightred'

history_max_lines
     Nombre maximum de lignes dans l'historique pour un serveur/fenêtre/fenêtre privée (0 = sans limite)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 4096

history_max_commands
     Nombre maximum de commandes utilisateur dans l'historique (0 = sans limite)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 100

log_auto_server
     Enregistrer automatiquement les messages du serveur

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_auto_channel
     Enregistrer automatiquement les conversations des canaux

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_auto_private
     Enregistrer automatiquement les conversations privées

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

log_path
     Chemin pour les conversations sauvegardées par WeeChat

     Type: chaîne (toute chaîne), valeur par défaut: '~/.weechat/logs/'

log_timestamp
     Horodatage pour les conversations sauvegardées (voir man strftime pour le format de date/heure)

     Type: chaîne (toute chaîne), valeur par défaut: '%Y %b %d %H:%M:%S'

log_hide_nickserv_pwd
     Masquer le mot de passe affiché par nickserv

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

irc_display_away
     Affiche un message sur tous les canaux pour l'absence/le retour

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

irc_default_msg_away
     Message par défaut pour l'absence

     Type: chaîne (toute chaîne), valeur par défaut: 'away'

irc_default_msg_part
     Message par défaut pour le part (quitte un canal)

     Type: chaîne (toute chaîne), valeur par défaut: ''

irc_default_msg_quit
     Message de fin par défaut ('%v' sera remplacé par la version de WeeChat dans la chaîne)

     Type: chaîne (toute chaîne), valeur par défaut: 'WeeChat %v'

irc_away_check
     Intervalle entre deux vérifications des absences (en minutes, 0 = ne jemais vérifier)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 1

irc_lag_check
     Intervalle entre deux mesures de lag (en secondes)

     Type: entier (valeurs: entre 30 et 2147483647), valeur par défaut: 60

irc_lag_min_show
     Lag minimum à afficher (en secondes)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 1

irc_lag_disconnect
     Déconnexion après un lag important (en minutes, 0 = ne jamais se déconnecter)

     Type: entier (valeurs: entre 0 et 2147483647), valeur par défaut: 5

dcc_auto_accept_files
     Accepte automatiquement les fichiers dcc entrants

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

dcc_auto_accept_chats
     Accepte automatiquement les demandes de discussion dcc (à utiliser avec précaution !)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

dcc_timeout
     Délai d'attente pour les requêtes dcc (en secondes)

     Type: entier (valeurs: entre 1 et 2147483647), valeur par défaut: 300

dcc_blocksize
     Taille de bloc pour les paquets dcc en octets (défaut: 1024)

     Type: entier (valeurs: entre 1024 et 102400), valeur par défaut: 1024

dcc_download_path
     Chemin pour écrire les fichiers reçus par dcc (par défaut: répertoire de l'utilisateur)

     Type: chaîne (toute chaîne), valeur par défaut: '~'

dcc_upload_path
     Chemin pour lire les fichiers lorsqu'ils sont envoyés par dcc (quand aucun chemin n'est spécifié)

     Type: chaîne (toute chaîne), valeur par défaut: '~'

dcc_auto_rename
     Renommer les fichiers reçus s'ils existent déjà (ajoute '.1', '.2', ...)

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

dcc_auto_resume
     Continuer automatiquement les transferts dcc si la connexion avec la machine distante a été perdue

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

proxy_use
     Utiliser un proxy pour se connecter au serveur irc

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'off'

proxy_address
     Adresse du serveur proxy (IP ou nom)

     Type: chaîne (toute chaîne), valeur par défaut: ''

proxy_port
     Port pour se connecter au serveur proxy

     Type: entier (valeurs: entre 0 et 65535), valeur par défaut: 1080

proxy_password
     Mot de passe pour le serveur proxy

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_name
     Nom associé au serveur IRC (pour affichage seulement)

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_autoconnect
     Connexion automatique au serveur quand WeeChat démarre

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

server_autoreconnect
     Reconnexion automatique au serveur après une déconnexion

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

server_autoreconnect_delay
     Délai (en secondes) avant de tenter une reconnexion au serveur

     Type: entier (valeurs: entre 0 et 65535), valeur par défaut: 30

server_address
     Adresse IP ou nom du serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_port
     Port pour se connecter au serveur

     Type: entier (valeurs: entre 0 et 65535), valeur par défaut: 6667

server_password
     Mot de passe pour le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_nick1
     Pseudo à utiliser sur le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_nick2
     Pseudo alternatif pour le serveur IRC (si le pseudo est déjà utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_nick3
     2nd pseudo alternatif pour le serveur IRC (si le pseudo alternatif est déjà utilisé)

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_username
     Nom d'utilisateur pour le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_realname
     Nom réel pour le serveur IRC

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_command
     Commande à exécuter en premier lorsque connecté au serveur

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_command_delay
     Délai (en secondes) après exécution de la commande (exemple: donner du temps pour l'authentification)

     Type: entier (valeurs: entre 0 et 5), valeur par défaut: 0

server_autojoin
     Liste des canaux (séparés par des virgules) à rejoindre lorsque connecté au serveur

     Type: chaîne (toute chaîne), valeur par défaut: ''

server_autorejoin
     Rejoindre automatiquement les canaux quand mis dehors

     Type: booléen (valeurs: 'on' ou 'off'), valeur par défaut: 'on'

Les couleurs pour l'interface Curses sont :

  - default: couleur par défaut (transparent pour le fond)

  - black: noir

  - red: rouge foncé

  - lightred: rouge clair

  - green: vert foncé

  - lightgreen: vert clair

  - brown: marron

  - yellow: jaune

  - blue: bleu foncé

  - lightblue: bleu clair

  - magenta: violet foncé

  - lightmagenta: violet clair

  - cyan: cyan foncé

  - lightcyan: cyan clair

  - white: blanc

Raccourcis clavier
==================

Flèche gauche / Flèche droite
     Aller au caractère précédent / suivant sur la ligne de commande

Ctrl + flèche gauche / Ctrl + flèche droite
     Aller au mot précédent / suivant sur la ligne de commande

Home / Ctrl + A
     Aller au début de la ligne de commande

End / Ctrl + E
     Aller à la fin de la ligne de commande

Backspace / Delete
     Effacer le mot précédent / suivant sur la ligne de commande

Ctrl + Backspace / Ctrl + W
     Effacer le mot précédent sur la ligne de commande

Tab
     Compléter la commande ou le pseudo (Tab à nouveau : trouver la complétion suivante)

Tout caractère
     Insérer le caractère à la position du curseur sur la ligne de commande

Entrée
     Exécuter la commande ou envoyer le message

Flèche haut / Flèche bas
     Rappeler les dernières commandes/messages

PageUp / PageDown
     Afficher l'historique du tampon

F5 / F6
     Aller au tampon précédent / suivant

F7 / F8
     Aller à la fenêtre précédente / suivante

F10
     Effacer le dernier message de la barre d'infos

Ctrl + L
     Réaffiche toute la fenêtre

Alt + flèche gauche / Alt + flèche droite
     Identique à F5 / F6

Alt + A
     Sauter au tampon avec activité (avec priorité: highlight, message, autre)

Alt + D
     Afficher les DCC en cours

Alt + R
     Vide la hotlist (notification d'activité sur les autres tampons)

Alt + S
     Sauter au tampon du serveur

Alt + X
     Sauter au premier canal du serveur suivant (ou tampon du serveur si aucun canal ouvert)

Alt + chiffre (1-9)
     Sauter au tampon avec ce numéro

Commandes WeeChat
=================

NON ECRIT !

Extensions
**********

Scripts Perl
============

Charger/décharger des scripts Perl
----------------------------------

Les scripts Perl sont chargés et déchargés avec la commande /perl (tapez /help perl dans WeeChat pour obtenir de l'aide sur la commande).

Exemples :

  * Charger un script Perl : /perl load /tmp/essai.pl

  * Décharger tous les scripts Perl : /perl unload

  * Lister les scripts Perl chargés : /perl

Interface WeeChat / Perl
------------------------

  * IRC::register ( nom, version, fonction_de_fin, description );

     C'est la première fonction à appeler dans le script Perl.

     Tout script Perl pour WeeChat doit appeler cette fonction.

     Paramètres :

       - nom: nom unique pour identifier le script (chaque script doit avoir un nom différent)

       - version: version du script

       - fonction_de_fin: fonction Perl appelée quand le script est déchargé (paramètre facultatif, une chaîne vide signifiant qu'il n'y a pas de fonction à appeler)

       - description: description brève du script.

     Exemple :

     IRC::register ("essai", "1.0", "fin_essai", "Script d'essai !");

  * IRC::print ( message );

     Affiche un message dans la fenêtre courante (canal ou serveur).

     Paramètres :

       - message: message à afficher

     Exemple :

     IRC::print ("message");

  * IRC::print_with_channel ( canal, [serveur,] message );

     Affiche un message dans un canal.

     Paramètres :

       - canal: nom du canal

       - serveur: nom interne du serveur

       - message: message à afficher

     Exemples :

     IRC::print_with_channel ("#weechat", "freenode", "message");

     IRC::print_with_channel ("#weechat", "message");

  * IRC::print_infobar ( délai, message );

     Affiche un message dans la barre d'infos.

     Paramètres :

       - délai: délai (en secondes) pendant lequel le message est affiché (si 0, le message ne sera pas effacé).

       - message: message à afficher

     Exemple :

     IRC::print_infobar (5, "message");

  * IRC::add_message_handler ( nom, fonction );

     Attache une fonction Perl à un message IRC particulier.

     La fonction sera appelée à chaque fois que le message IRC sera reçu.

     Paramètres :

       - nom: nom du message IRC pour lequel la fonction est appelée
          Pour connaître la liste des messages IRC disponibles, merci de consulter les RFC 1459 et/ou 2812 :

          RFC 1459 : ftp://ftp.rfc-editor.org/in-notes/rfc1459.txt

          RFC 2812 : ftp://ftp.rfc-editor.org/in-notes/rfc2812.txt

       - fonction: fonction Perl appelée lorsque le message est reçu

     Exemple :

     IRC::add_message_handler ("privmsg", ma_fonction);

     sub ma_fonction

     {

         IRC::print ("serveur=$_[0]\n");

         ($null, $canal, $message) = split ":",$_[1],3;

         ($masque, $null, $canal) = split " ", $canal;

         IRC::print ("masque=$masque, canal=$canal, message=$message\n");

     }

  * IRC::add_command_handler ( nom, fonction );

     Créé une nouvelle commande WeeChat, associée à une fonction Perl.

     La fonction sera appelée lorsque l'utilisateur lancera la commande par /nom.

     Paramètres :

       - nom: nom de la nouvelle commande
          Il peut s'agir d'une commande existante, auquel cas celle-ci est écrasée par la fonction Perl. Soyez prudent en écrasant les commandes WeeChat, car elles ne seront plus accessibles tant que le script Perl sera chargé.

       - fonction: fonction Perl associée à la commande

     Exemple :

     IRC::add_command_handler ("commande", ma_commande);

     sub ma_commande

     {

         IRC::print("Serveur: $_[0], paramètres: $_[1]\n");

         return 0;

     }

  * IRC::get_info ( [serveur,] nom );

     Obtenir des informations variées sur WeeChat, le serveur ou l'utilisateur.

     Paramètres :

       - serveur: nom interne du serveur

       - nom: nom de l'info à obtenir :

            - 0 ou version: obtenir la version de WeeChat

            - 1 ou nick: obtenir le pseudo

            - 2 ou channel: obtenir le nom du canal

            - 3 ou server: obtenir le nom du serveur

            - 4 ou weechatdir: obtenir le répertoire maison de WeeChat

            - 5 ou away: obtenir le drapeau "away" du serveur

     Exemples :

     $version = get_info("version");

     $nick = get_info("freenode", "nick");

Scripts Python
==============

Non développé !

Scripts Ruby
============

Non développé !

Auteurs / Support
*****************

Auteurs
=======

WeeChat est développé par :

  * FlashCode <flashcode AT flashtux.org>

  * Bounga <bounga AT altern.org>

  * Xahlexx <xahlexx AT tuxfamily.org>

Obtenir du support
==================

Avant de faire appel au support, merci de lire la documentation et la FAQ de WeeChat.

(la documentation est le document que vous êtes en train de lire, si vous n'avez pas tout lu jusqu'ici, il est encore temps de recommencer !)

  * Support par IRC:

     - serveur : irc.freenode.net

     - canal : #weechat

  * Forum WeeChat : http://forums.flashtux.org

  * Support par la liste de diffusion :

     - pour souscrire/désinscrire :
     http://mail.nongnu.org/mailman/listinfo/weechat-support.

     - pour envoyer un mail à la liste de diffusion, envoyer à :
     weechat-support@nongnu.org.

     Les archives de la liste de diffusion sont ici :

     http://mail.nongnu.org/archive/html/weechat-support

  * Voir la page support WeeChat pour plus de détails :

     http://weechat.flashtux.org/support.php