path: root/doc/fr/autogen/user/weechat_commands.adoc

//
// This file is auto-generated by script docgen.py.
// DO NOT EDIT BY HAND!
//
[[command_weechat_away]]
* `+away+`: définir ou supprimer le statut d'absence

----
/away  [-all] [<message>]

   -all : définir ou supprimer le statut d'absence sur tous les serveurs connectés
message : message pour l'absence (si pas de message donné, le statut d'absence est supprimé)
----

[[command_weechat_bar]]
* `+bar+`: gestion des barres

----
/bar  list|listfull|listitems
      add <nom> <type>[,<conditions>] <position> <taille> <séparateur> <objet1>[,<objet2>...]
      default [input|title|status|nicklist]
      del <nom>|-all
      set <nom> <option> <valeur>
      hide|show|toggle <nom>
      scroll <nom> <fenêtre> <valeur_scroll>

         list : lister toutes les barres
     listfull : lister toutes les barres (verbeux)
    listitems : lister tous les objets de barre
          add : ajouter une nouvelle barre
          nom : nom de la barre (doit être unique)
         type :   root : en dehors des fenêtres
                window : dans les fenêtres, avec condition(s) optionnelle(s) (voir ci-dessous)
   conditions : les conditions pour afficher la barre :
                  active : sur la fenêtre active
                inactive : sur les fenêtres inactives
                nicklist : sur les fenêtres avec liste de pseudos
                autre condition : voir /help weechat.bar.xxx.conditions et /help eval
                sans condition, la barre est toujours affichée
     position : bottom (bas), top (haut), left (gauche) ou right (droite)
       taille : taille de la barre (en caractères)
   séparateur : 1 pour utiliser un séparateur (ligne), 0 ou rien signifie sans séparateur
   objet1,... : objets pour cette barre (les objets peuvent être séparés par une virgule (espace entre les objets) ou "+" (objets collés))
      default : créer une barre par défaut (toutes les barres par défaut si aucun nom de barre n'est donné)
          del : supprimer une barre (ou toutes les barres avec -all)
          set : changer la valeur d'une propriété de la barre
       option : option à modifier (pour la liste des options, voir /set weechat.bar.<nombarre>.*)
       valeur : nouvelle valeur pour l'option
         hide : cacher la barre
         show : montrer une barre cachée
       toggle : cacher/montrer une barre
       scroll : faire défiler la barre
      fenêtre : numéro de fenêtre (utilisez '*' pour la fenêtre courante ou une barre de type root)
valeur_scroll : valeur pour le défilement : 'x' ou 'y' (optionnel), suivi par '+', '-', 'b' (début) ou 'e' (fin), valeur (pour +/-), et un % optionnel (pour faire défiler par % de la largeur/hauteur, sinon la valeur est un nombre de caractères)

Exemples :
  créer une barre avec l'heure, numéro + nom de tampon, et la complétion :
    /bar add mabarre root bottom 1 0 [time],buffer_number+:+buffer_name,completion
  cacher une barre :
    /bar hide mabarre
  faire défiler la liste des pseudos de 10 lignes vers le bas sur le tampon courant :
    /bar scroll nicklist * y+10
  faire défiler la liste des pseudos à la fin sur le tampon courant :
    /bar scroll nicklist * ye
----

[[command_weechat_buffer]]
* `+buffer+`: gestion des tampons

----
/buffer  list
         clear [<nombre>|<nom>|-merged|-all [<nombre>|<nom>...]]
         move <nombre>|-|+
         swap <nombre1>|<nom1> [<nombre2>|<nom2>]
         cycle <nombre>|<nom> [<nombre>|<nom>...]
         merge <nombre>
         unmerge [<nombre>|-all]
         hide [<nombre>|<nom>|-all [<nombre>|<nom>...]]
         unhide [<nombre>|<nom>|-all [<nombre>|<nom>...]]
         renumber <nombre1> [<nombre2> [<départ>]]
         close [<n1>[-<n2>]|<nom>]
         notify <niveau>
         localvar
         set <propriété> <valeur>
         get <propriété>
         <nombre>|<nom>

    list : lister les tampons ouverts (sans paramètre, cette liste est affichée)
   clear : effacer le contenu du tampon (un numéro pour un tampon, -merged pour les tampons mélangés, -all pour tous les tampons, ou rien pour le tampon courant)
    move : déplacer le tampon dans la liste (peut être relatif, par exemple -1) ; "-" = déplacer vers le premier numéro de tampon, "+" = déplacer vers le dernier numéro de tampon + 1
    swap : échanger deux tampons (échanger avec le tampon courant si un seul numéro/nom donné)
   cycle : sauter en boucle entre une liste de plusieurs tampons
   merge : mélanger le tampon courant avec un autre tampon (la zone de discussion sera un mélange des deux tampons)
           (par défaut ctrl-x bascule entre les tampons mélangés)
 unmerge : détacher le tampon courant des autres tampons portant le même numéro
    hide : masquer le tampon
  unhide : démasquer le tampon
renumber : renuméroter des tampons (fonctionne seulement si l'option weechat.look.buffer_auto_renumber est désactivée)
   close : fermer le tampon (nombre/intervalle ou nom optionnel)
  notify : définir le niveau de notification pour le tampon courant : ce niveau détermine si le tampon doit être ajouté à la hotlist ou pas :
                none : jamais
           highlight : pour les highlights seulement
             message : pour les messages d'utilisateurs + highlights
                 all : pour tous les messages
               reset : réinitialise à valeur par défaut (all)
localvar : afficher la liste des variables locales pour le tampon courant
     set : modifier une propriété du tampon courant
     get : afficher une propriété du tampon courant
  nombre : sauter au tampon qui a ce numéro, préfixe possible :
           '+' : saut relatif, ajoute le numéro au courant,
           '-' : saut relatif, soustrait le numéro au courant,
           '*' : saut au numéro en utilisant l'option "jump_current_to_previous_buffer"
       - : sauter au premier numéro de tampon
       + : sauter au dernier numéro de tampon
     nom : sauter au tampon par nom (partiel)

Exemples :
  effacer le tampon courant :
    /buffer clear
  déplacer le tampon vers le numéro 5 :
    /buffer move 5
  échanger le tampon 1 avec le 3 :
    /buffer swap 1 3
  échanger le tampon #weechat avec le tampon courant :
    /buffer swap #weechat
  sauter sur #canal1, #canal2, #canal3 en boucle :
    /buffer cycle #canal1 #canal2 #canal3
  mélanger avec le tampon core :
    /buffer merge 1
  détacher le tampon :
    /buffer unmerge
  fermer le tampon courant :
    /buffer close
  fermer les tampons 5 à 7 :
    /buffer close 5-7
  aller sur #weechat :
    /buffer #weechat
  aller au tampon suivant :
    /buffer +1
  aller au dernier numéro de tampon :
    /buffer +
----

[[command_weechat_color]]
* `+color+`: définir des alias de couleurs et afficher la palette des couleurs

----
/color  alias <couleur> <nom>
        unalias <couleur>
        reset
        term2rgb <color>
        rgb2term <rgb> [<limit>]
        -o

   alias : ajouter un alias pour une couleur
 unalias : supprimer un alias pour une couleur
 couleur : numéro de couleur (supérieur ou égal à 0, le max dépend du terminal, généralement 63 ou 255)
     nom : nom d'alias pour la couleur (par exemple : "orange")
   reset : réinitialiser toutes les paires de couleurs (requis quand il n'y a plus de paires de couleurs disponibles si la réinitialisation automatique est désactivée, voir l'option "weechat.look.color_pairs_auto_reset")
term2rgb : convertir une couleur du terminal (0-255) en couleur RGB
rgb2term : convertir une couleur RGB en couleur du terminal (0-255)
  limite : nombre de couleurs à utiliser dans la table du terminal (en démarrant de 0) ; par défaut 256
      -o : envoyer les infos terminal/couleurs sur le tampon courant comme entrée

Sans paramètre, cette commande affiche les couleurs dans un nouveau tampon.

Exemples :
  ajouter l'alias "orange" pour la couleur 214 :
    /color alias 214 orange
  supprimer la couleur 214 :
    /color unalias 214
----

[[command_weechat_command]]
* `+command+`: lancer explicitement une commande WeeChat ou d'une extension

----
/command  [-buffer <nom>] <extension> <commande>

  -buffer : exécuter la commande sur ce tampon
extension : exécuter la commande de cette extension ; 'core' pour une commande WeeChat, '*' pour une extension automatique (cela dépend sur quel tampon est exécutée la commande)
 commande : commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)
----

[[command_weechat_cursor]]
* `+cursor+`: mouvement libre du curseur sur l'écran pour exécuter des actions sur des zones spécifiques de l'écran

----
/cursor  go chat|<barre>|<x>,<y>
         move up|down|left|right|area_up|area_down|area_left|area_right
         stop

  go : déplacer le curseur vers la zone de discussion ("chat"), une barre (en utilisant son nom) ou les coordonnées "x,y"
move : déplacer le curseur dans une direction
stop : arrêter le mode curseur

Sans paramètre, cette commande active/désactive le mode curseur.

Lorsque la souris est activée (voir /help mouse), par défaut un clic du milieu démarre le mode curseur à ce point.

Touches par défaut dans le mode curseur sur les messages de la zone de discussion :
  m  citer le message
  q  citer le préfixe + le message
  Q  citer l'heure + le préfixe + le message

Touches par défaut dans le mode curseur sur la liste de pseudos :
  b  bannir le pseudo (/ban)
  k  éjecter le pseudo (/kick)
  K  éjecter et bannir le pseudo (/kickban)
  q  ouvrir une discussion privée avec le pseudo (/query)
  w  demander les informations sur l'utilisateur (/whois)

Exemples :
  aller dans la liste des pseudos :
    /cursor go nicklist
  aller aux coordonnées x=10, y=5 :
    /cursor go 10,5
----

[[command_weechat_debug]]
* `+debug+`: fonctions de debug

----
/debug  list
        set <extension> <niveau>
        dump [<extension>]
        buffer|color|infolists|memory|tags|term|windows
        cursor|mouse [verbose]
        hdata [free]
        time <commande>

     list : lister les extensions avec leur niveau de debug
      set : définir le niveau de debug pour l'extension
extension : nom de l'extension ("core" pour le cœur de WeeChat)
   niveau : niveau de debug pour l'extension
     dump : afficher les variables mémoire WeeChat dans le fichier log (les mêmes messages sont affichés lorsque WeeChat plante)
   buffer : afficher le contenu du tampon en valeurs hexadécimales dans le fichier log
    color : afficher des infos sur les paires de couleur courantes
   cursor : activer/désactiver le debug pour le mode curseur
     dirs : afficher les répertoires
    hdata : afficher des infos sur les hdata (avec free : supprimer tous les hdata en mémoire)
    hooks : afficher des infos sur les hooks
infolists : afficher des infos sur les infolists
     libs : afficher des infos sur les bibliothèques externes utilisées
   memory : afficher des infos sur l'utilisation de la mémoire
    mouse : activer/désactiver le debug pour la souris
     tags : afficher les étiquettes pour les lignes
     term : afficher des infos sur le terminal
  windows : afficher l'arbre des fenêtres
     time : mesurer le temps pour exécuter une commande ou pour envoyer du texte au tampon courant
----

[[command_weechat_eval]]
* `+eval+`: évaluer une expression

----
/eval  [-n|-s] <expression>
       [-n] -c <expression1> <opérateur> <expression2>

        -n : afficher le résultat sans envoyer au tampon (mode debug)
        -s : découper l'expression avant de l'évaluer (plusieurs commandes peuvent être séparées par des points-virgules)
        -c : évaluer comme une condition : utiliser les opérateurs et les parenthèses, retourner une valeur booléenne ("0" ou "1")
expression : expression à évaluer, les variables avec le format ${variable} sont remplacées (voir ci-dessous) ; plusieurs commandes peuvent être séparées par des points-virgules
 opérateur : un opérateur logique ou de comparaison :
             - opérateurs logiques :
                 &&  "et" booléen
                 ||  "ou" booléen
             - opérateurs de comparaison :
                 ==  égal
                 !=  non égal
                 <=  inférieur ou égal
                 <   inférieur
                 >=  supérieur ou égal
                 >   supérieur
                 =~  correspond à l'expression régulière POSIX étendue
                 !~  ne correspond PAS à l'expression régulière POSIX étendue
                 =*  correspond au masque (le caractère joker "*" est autorisé)
                 !=  ne correspond PAS au masque (le caractère joker "*" est autorisé)

Une expression est considérée comme "vraie" si elle est non NULL, non vide, et différente de "0".
La comparaison est faite en utilisant des entiers si les deux expressions sont des entiers valides.
Pour forcer une comparaison de chaînes, ajoutez des guillemets autour de chaque expression, par exemple :
  50 > 100      ==> 0
  "50" > "100"  ==> 1

Des variables sont remplacées dans l'expression, en utilisant le format ${variable}, la variable pouvant être, par ordre de priorité :
  1. une sous-chaîne évaluée (format : "eval:xxx")
  2. une chaîne avec les caractères échappés (format : "esc:xxx" ou "\xxx")
  3. une chaîne avec des caractères à cacher (format : "hide:caractère,chaîne")
  4. une chaîne avec un maximum de caractères (format : "cut:max,suffixe,chaîne" ou "cut:+max,suffixe,chaîne")
     ou un maximum de caractères affichés à l'écran (format : "cutscr:max,suffixe,chaîne" ou "cutscr:+max,suffixe,chaîne")
  5. une couleur (format : "color:xxx", voir la "Référence API extension", fonction "color")
  6. une info (format : "info:nom,paramètres", les paramètres sont optionnels)
  7. la date/heure courante (format : "date" ou "date:format")
  8. une variable d'environnement (format : "env:XXX")
  9. un opérateur ternaire (format : "if:condition?valeur_si_vrai:valeur_si_faux")
  10. une option (format : "fichier.section.option")
  11. une variable locale du tampon
  12. un hdata/variable (la valeur est automatiquement convertie en chaîne), par défaut "window" et "buffer" pointent vers la fenêtre et le tampon courants.
Le format du hdata peut être le suivant :
  hdata.var1.var2... : démarrer avec un hdata (le pointeur doit être connu), et demander les variables l'une après l'autre (d'autres hdata peuvent être suivis)
  hdata[liste].var1.var2... : démarrer avec un hdata en utilisant une liste, par exemple :
    ${buffer[gui_buffers].full_name} : nom complet du premier tampon dans la liste chaînée des tampons
    ${plugin[weechat_plugins].name} : nom de la première extension dans la liste chaînée des extensions
  hdata[pointeur].var1.var2... : démarrer avec un hdata en utilisant un pointeur, par exemple :
    ${buffer[0x1234abcd].full_name} : nom complet du tampon avec ce pointeur (peut être utilisé dans les triggers)
Pour le nom du hdata et des variables, voir la "Référence API extension", fonction "weechat_hdata_get".

Exemples (chaînes simples) :
  /eval -n ${info:version}                       ==> 0.4.3
  /eval -n ${env:HOME}                           ==> /home/user
  /eval -n ${weechat.look.scroll_amount}         ==> 3
  /eval -n ${window}                             ==> 0x2549aa0
  /eval -n ${window.buffer}                      ==> 0x2549320
  /eval -n ${window.buffer.full_name}            ==> core.weechat
  /eval -n ${window.buffer.number}               ==> 1
  /eval -n ${\t}                                 ==> <tab>
  /eval -n ${hide:-,${relay.network.password}}   ==> --------
  /eval -n ${cut:3,+,test}                       ==> tes+
  /eval -n ${cut:+3,+,test}                      ==> te+
  /eval -n ${date:%H:%M:%S}                      ==> 07:46:40
  /eval -n ${if:${info:term_width}>80?big:small} ==> big

Exemples (conditions) :
  /eval -n -c ${window.buffer.number} > 2 ==> 0
  /eval -n -c ${window.win_width} > 100   ==> 1
  /eval -n -c (8 > 12) || (5 > 2)         ==> 1
  /eval -n -c (8 > 12) && (5 > 2)         ==> 0
  /eval -n -c abcd =~ ^ABC                ==> 1
  /eval -n -c abcd =~ (?-i)^ABC           ==> 0
  /eval -n -c abcd =~ (?-i)^abc           ==> 1
  /eval -n -c abcd !~ abc                 ==> 0
  /eval -n -c abcd =* a*d                 ==> 1
----

[[command_weechat_filter]]
* `+filter+`: filtrer les messages dans les tampons, pour les cacher/afficher selon des étiquettes ou expressions régulières

----
/filter  list
         enable|disable|toggle [<nom>|@]
         add <nom> <tampon>[,<tampon>...] <étiquettes> <regex>
         rename <nom> <nouveau_nom>
         del <nom>|-all

      list : lister tous les filtres
    enable : activer les filtres (par défaut les filtres sont activés)
   disable : désactiver les filtres
    toggle : activer/désactiver les filtres
       nom : nom de filtre ("@" = activer/désactiver tous les filtres dans le tampon courant)
       add : ajouter un filtre
    rename : renommer un filtre
       del : supprimer un filtre
      -all : supprimer tous les filtres
    tampon : liste des tampons, séparés par des virgules, où le filtre est actif :
             - il s'agit du nom complet incluant l'extension (exemple : "irc.freenode.#weechat" ou "irc.server.freenode")
             - "*" signifie tous les tampons
             - un nom commençant par '!' est exclu
             - le caractère joker "*" est autorisé
étiquettes : liste d'étiquettes, séparées par des virgules, par exemple : "irc_join,irc_part,irc_quit"
             - "et" logique : utilisez "+" entre les étiquettes (par exemple : "nick_toto+irc_action")
             - le caractère joker "*" est autorisé
             - si l'étiquette commence par '!', alors elle est exclue et ne doit PAS être dans le message
     regex : expression régulière POSIX étendue à rechercher dans la ligne
             - utiliser '\t' pour séparer le préfixe du message, les caractères spéciaux comme '|' doivent être échappés : '\|'
             - si l'expression régulière commence par '!' alors le résultat est inversé (utiliser '\!' pour démarrer par '!')
             - deux expressions régulières sont créées : une pour le préfixe et une pour le message
             - les expressions régulières sont insensibles à la casse, elles peuvent commencer par "(?-i)" pour devenir sensibles à la casse

La touche par défaut alt+'=' active/désactive le filtrage.

Les étiquettes les plus couramment utilisées :
  no_filter, no_highlight, no_log, log0..log9 (niveau de log),
  notify_none, notify_message, notify_private, notify_highlight,
  self_msg, nick_xxx (xxx est le pseudo dans le message), prefix_nick_ccc (ccc est la couleur du pseudo),
  host_xxx (xxx est le nom d'utilisateur + hôte dans le message),
  irc_xxx (xxx est un nom de commande ou nombre, voir /server raw ou /debug tags),
  irc_numeric, irc_error, irc_action, irc_ctcp, irc_ctcp_reply, irc_smart_filter, away_info.
Pour voir les étiquettes des lignes affichées : /debug tags

Exemples :
  utiliser le filtre intelligent IRC sur tous les tampons :
    /filter add irc_smart * irc_smart_filter *
  utiliser le filtre intelligent IRC sur tous les tampons sauf ceux avec "#weechat" dans le nom :
    /filter add irc_smart *,!*#weechat* irc_smart_filter *
  filtrer tous les messages IRC join/part/quit :
    /filter add joinquit * irc_join,irc_part,irc_quit *
  filtrer les pseudos afficher en rejoignant les canaux ou avec /names :
    /filter add nicks * irc_366 *
  filtrer le pseudo "toto" sur le canal IRC #weechat :
    /filter add toto irc.freenode.#weechat nick_toto *
  filtrer les messages IRC join/action du pseudo "toto" :
    /filter add toto * nick_toto+irc_join,nick_toto+irc_action *
  filtrer les lignes contenant "weechat sucks" sur le canal IRC #weechat :
    /filter add sucks irc.freenode.#weechat * weechat sucks
  filtrer les lignes qui sont strictement égales à "WeeChat sucks" sur tous les tampons :
    /filter add sucks2 * * (?-i)^WeeChat sucks$
----

[[command_weechat_help]]
* `+help+`: afficher l'aide sur les commandes et les options

----
/help  -list|-listfull [<extension> [<extension>...]]
       <commande>
       <option>

    -list : lister les commandes, par extension (sans paramètre, cette liste est affichée)
-listfull : lister les commandes avec description, par extension
extension : lister les commandes de cette extension
 commande : un nom de commande
   option : un nom d'option (utilisez /set pour voir la liste)
----

[[command_weechat_history]]
* `+history+`: afficher l'historique des commandes du tampon

----
/history  clear
          <valeur>

 clear : effacer l'historique
valeur : nombre d'entrées dans l'historique à afficher
----

[[command_weechat_input]]
* `+input+`: fonctions pour la ligne de commande

----
/input  <action> [<paramètres>]

liste des actions :
  return : simuler la touche "entrée"
  complete_next : compléter le mot avec la complétion suivante
  complete_previous : compléter le mot avec la complétion précédente
  search_text_here : chercher du texte dans le tampon à la position courante
  search_text : chercher du texte dans le tampon
  search_switch_case : basculer la casse exacte pour la recherche
  search_switch_regex : basculer le type de recherche : chaîne/expression régulière
  search_switch_where : basculer la recherche dans les messages/préfixes
  search_previous : chercher la ligne précédente
  search_next : chercher la ligne suivante
  search_stop_here : arrêter la recherche à la position courante
  search_stop : arrêter la recherche
  delete_previous_char : effacer le caractère précédent
  delete_next_char : effacer le caractère suivant
  delete_previous_word : effacer le mot précédent
  delete_next_word : effacer le mot suivant
  delete_beginning_of_line : effacer du début de la ligne jusqu'au curseur
  delete_end_of_line : effacer du curseur jusqu'à la fin de la ligne
  delete_line : effacer la ligne entière
  clipboard_paste : coller depuis le presse-papiers interne
  transpose_chars : inverser deux caractères
  undo : défaire la dernière action de la ligne de commande
  redo : refaire la dernière action de la ligne de commande
  move_beginning_of_line : déplacer le curseur au début de la ligne
  move_end_of_line : déplacer le curseur à la fin de la ligne
  move_previous_char : déplacer le curseur sur le caractère précédent
  move_next_char : déplacer le curseur sur le caractère suivant
  move_previous_word : déplacer le curseur sur le mot précédent
  move_next_word : déplacer le curseur sur le mot suivant
  history_previous : rappeler la commande précédente dans l'historique du tampon courant
  history_next : rappeler la commande suivante dans l'historique du tampon courant
  history_global_previous : rappeler la commande précédente dans l'historique global
  history_global_next : rappeler la commande suivante dans l'historique global
  jump_smart : sauter au prochain tampon avec de l'activité
  jump_last_buffer_displayed : sauter au dernier tampon affiché (avant le dernier saut vers un tampon)
  jump_previously_visited_buffer : sauter au tampon visité précédemment
  jump_next_visited_buffer : sauter au tampon visité après
  hotlist_clear : effacer la hotlist (paramètre facultatif : "lowest" pour effacer seulement le plus petit niveau dans la hotlist, "highest" pour effacer seulement le niveau le plus haut dans la hotlist, ou un masque de niveaux : entier qui est une combinaison de 1=join/part, 2=message, 4=privé, 8=highlight)
  grab_key : capturer une touche (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes)
  grab_key_command : capturer une touche avec sa commande associée (paramètre facultatif : délai pour la fin de la capture, par défaut 500 millisecondes)
  grab_mouse : capturer un évènement de la souris
  grab_mouse_area : capturer un évènement de la souris avec la zone
  set_unread : définir le marqueur de données non lues pour tous les tampons
  set_unread_current_buffer : définir le marqueur de données non lues pour le tampon courant
  switch_active_buffer : basculer vers le tampon mélangé suivant
  switch_active_buffer_previous : basculer vers le tampon mélangé précédent
  zoom_merged_buffer : zoom sur le tampon mélangé
  insert : insérer du texte dans la ligne de commande (les caractères échappés sont autorisés, voir /help print)
  send : envoyer du texte au tampon
  paste_start : début de collage (mode "bracketed paste")
  paste_stop : fin de collage (mode "bracketed paste")

Cette commande est utilisé par les associations de touches ou les extensions.
----

[[command_weechat_key]]
* `+key+`: associer/libérer des touches

----
/key  list|listdefault|listdiff [<contexte>]
      bind <touche> [<commande> [<args>]]
      bindctxt <contexte> <touche> [<commande> [<args>]]
      unbind <touche>
      unbindctxt <contexte> <touche>
      reset <touche>
      resetctxt <contexte> <touche>
      resetall -yes [<contexte>]
      missing [<contexte>]

       list : afficher toutes les touches courantes (sans paramètre, cette liste est affichée)
listdefault : afficher les touches par défaut
   listdiff : afficher les différences entre les touches courantes et celles par défaut (touches ajoutées, redéfinies ou supprimées)
   contexte : nom du contexte ("default" ou "search")
       bind : associer une commande à une touche ou affiche la commande associée à la touche
   bindctxt : associer une commande à une touche ou affiche la commande associée à la touche pour le contexte donné
   commande : commande (plusieurs commandes peuvent êtres séparées par des points-virgules)
     unbind : supprimer l'association à une touche
 unbindctxt : supprimer l'association à une touche pour le contexte donné
      reset : réinitialiser une touche à son association par défaut
  resetctxt : réinitialiser une touche à son association par défaut pour le contexte donné
   resetall : restaurer les touches aux valeurs par défaut et supprimer TOUTES les touches personnelles (utiliser avec précaution !)
    missing : ajouter les touches manquantes (en utilisant les touches par défaut), pratique après installation d'une nouvelle version de WeeChat

Lors de l'association d'une commande à une touche, il est recommandé d'utiliser la touche alt+k (ou Échap puis k), et puis de presser la touche à associer : cela insère le code de la touche dans la ligne de commande.

Pour le contexte "mouse" (possible aussi pour le contexte "cursor"), la touche a le format : "@zone:touche" ou "@zone1>zone2:touche" où la zone peut être :
          * : n'importe quelle zone à l'écran
       chat : la zone de discussion (n'importe quel tampon)
  chat(xxx) : la zone de discussion pour le tampon avec le nom "xxx" (nom complet incluant l'extension)
     bar(*) : n'importe quelle barre
   bar(xxx) : la barre "xxx"
    item(*) : n'importe quel objet de barre
  item(xxx) : l'objet de barre "xxx"
La caractère joker "*" est autorisé pour plusieurs évènements de la souris.
Une valeur spéciale pour la commande avec le format "hsignal:nom" peut être utilisée dans le contexte "mouse", cela enverra le signal "nom" avec la table de hachage du focus comme paramètre.
Une autre valeur spéciale "-" peut être utilisée pour désactiver la touche (elle sera ignorée lors de la recherche de touches).

Exemples :
  touche alt-t pour activer/désactiver la liste des pseudos :
    /key bind meta-t /bar toggle nicklist
  touche alt-r pour aller sur le canal IRC #weechat :
    /key bind meta-r /buffer #weechat
  restaure l'association par défaut pour la touche alt-r :
    /key reset meta-r
  touche "tab" pour arrêter la recherche dans le tampon :
    /key bindctxt search ctrl-I /input search_stop
  bouton du milieu de la souris sur un pseudo pour récupérer les infos sur le pseudo :
    /key bindctxt mouse @item(buffer_nicklist):button3 /msg nickserv info ${nick}
----

[[command_weechat_layout]]
* `+layout+`: gestion des dispositions de tampons/fenêtres

----
/layout  store [<nom>] [buffers|windows]
         apply [<nom>] [buffers|windows]
         leave
         del [<nom>] [buffers|windows]
         rename <nom> <nouveau_nom>

  store : stocker les tampons/fenêtres courants dans une disposition
  apply : appliquer une disposition stockée
  leave : quitter la disposition courante (ne met à jour aucune disposition)
    del : supprimer les tampons et/ou fenêtres dans une disposition stockée
          (si ni "buffers" ni "windows" n'est donné après le nom, la disposition est supprimée)
 rename : renommer une disposition
    nom : nom pour la disposition stockée (par défaut "default")
buffers : stocker/appliquer seulement pour les tampons (ordre des tampons)
windows : stocker/appliquer seulement pour les fenêtres (le tampon affiché par chaque fenêtre)

Sans paramètre, cette commande affiche les dispositions stockées.

La disposition courante peut être sauvegardée sur la commande /quit avec l'option "weechat.look.save_layout_on_exit".
----

[[command_weechat_mouse]]
* `+mouse+`: contrôle de la souris

----
/mouse  enable|disable|toggle [<délai>]

 enable : activer la souris
disable : désactiver la souris
 toggle : activer/désactiver la souris
  délai : délai (en secondes) après lequel l'état initial de la souris est restauré (pratique pour désactiver temporairement la souris)

L'état de la souris est sauvé dans l'option "weechat.look.mouse".

Exemples :
  activer la souris :
    /mouse enable
  activer/désactiver la souris pendant 5 secondes :
    /mouse toggle 5
----

[[command_weechat_mute]]
* `+mute+`: exécuter une commande silencieusement

----
/mute  [-core | -current | -buffer <nom>] <commande>

   -core : pas d'affichage sur le tampon core WeeChat
-current : pas d'affichage sur le tampon courant
 -buffer : pas d'affichage sur le tampon spécifié
     nom : nom complet du tampon (exemples : "irc.server.freenode", "irc.freenode.#weechat")
commande : commande à exécuter silencieusement (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)

Si aucune cible n'est spécifiée (-core, -current ou -buffer), alors par défaut tous les tampons seront silencieux.

Exemples :
  sauvegarde configuration :
    /mute save
  message au canal IRC courant :
    /mute -current msg * bonjour !
  message au canal #weechat :
    /mute -buffer irc.freenode.#weechat msg #weechat bonjour !
----

[[command_weechat_plugin]]
* `+plugin+`: lister/charger/décharger des extensions

----
/plugin  list|listfull [<nom>]
         load <fichier> [<paramètres>]
         autoload [<paramètres>]
         reload [<nom>|* [<paramètres]]
         unload [<nom>]

      list : lister les extensions chargées
  listfull : lister les extensions chargées (verbeux)
      load : charger une extension
  autoload : charger automatiquement les extensions dans un répertoire système ou utilisateur
    reload : recharger une extension (si pas de nom donné, décharger toutes les extensions, puis recharger automatiquement les extensions)
    unload : décharger une extension (si pas de nom donné, décharger toutes les extensions)
   fichier : extension (fichier) à charger
       nom : nom d'extension
paramètres : paramètres donnés à l'extension lors de son chargement

Sans paramètre, cette commande liste les extensions chargées.
----

[[command_weechat_print]]
* `+print+`: afficher du texte dans un tampon

----
/print  [-buffer <numéro>|<nom>] [-core] [-escape] [-date <date>] [-tags <étiquettes>] [-action|-error|-join|-network|-quit] [<texte>]
        -stdout|-stderr [<texte>]
        -beep

 -buffer : afficher le texte dans ce tampon (par défaut : tampon où est exécutée la commande)
   -core : alias de "-buffer core.weechat"
-current : afficher le texte dans le tampon courant
 -escape : interpréter les caractères échappés (par exemple \a, \07, \x07)
   -date : date du message, le format peut être :
             -n : 'n' secondes avant maintenant
             +n : 'n' secondes dans le futur
              n : 'n' secondes depuis l'époque (voir man time)
             date/heure (ISO 8601) : yyyy-mm-ddThh:mm:ss, exemple : 2014-01-19T04:32:55
             heure : hh:mm:ss (exemple : 04:32:55)
   -tags : liste d'étiquettes séparées par des virgules (voir /help filter pour une liste des étiquettes couramment utilisées)
   texte : texte à afficher (le préfixe et le message doivent être séparés par "\t", si le texte commence par "-", ajoutez "\" avant)
 -stdout : afficher le texte sur stdout (les caractères échappés sont interprétés)
 -stderr : afficher le texte sur stderr (les caractères échappés sont interprétés)
   -beep : alias de "-stderr \a"

Les options -action ... -quit utilisent le préfixe défini dans les options "weechat.look.prefix_*".

Les caractères échappés suivants sont supportés :
  \" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh

Exemples :
  afficher un pense-bête sur le tampon core avec un highlight :
    /print -core -tags notify_highlight Pense-bête : acheter du lait
  afficher une erreur sur le tampon core :
    /print -core -error Une erreur ici
  afficher un message sur le tampon core avec le préfixe "abc" :
    /print -core abc\tLe message
  afficher un message sur le canal #weechat :
    /print -buffer irc.freenode.#weechat Message sur #weechat
  afficher un bonhomme de neige (U+2603) :
    /print -escape \u2603
  envoyer une alerte (BEL) :
    /print -beep
----

[[command_weechat_proxy]]
* `+proxy+`: gestion des proxies

----
/proxy  list
        add <nom> <type> <adresse> <port> [<utilisateur> [<mot_de_passe>]]
        del <nom>|-all
        set <nom> <option> <valeur>

        list : lister tous les proxies
         add : ajouter un nouveau proxy
         nom : nom du proxy (doit être unique)
        type : http, socks4 ou socks5
     adresse : IP ou nom de machine
        port : port
 utilisateur : nom d'utilisateur (optionnel)
mot_de_passe : mot de passe (optionnel)
         del : supprimer un proxy (ou tous les proxies avec -all)
         set : changer la valeur d'une propriété d'un proxy
      option : option à modifier (pour la liste des options, voir /set weechat.proxy.<proxyname>.*)
      valeur : nouvelle valeur pour l'option

Exemples :
  ajouter un proxy http, tournant en local, port 8888 :
    /proxy add local http 127.0.0.1 8888
  ajouter un proxy http en utilisant le protocole IPv6 :
    /proxy add local http ::1 8888
    /proxy set local ipv6 on
  ajouter un proxy socks5 avec un utilisateur/mot de passe :
    /proxy add myproxy socks5 sample.host.org 3128 myuser mypass
  supprimer un proxy :
    /proxy del myproxy
----

[[command_weechat_quit]]
* `+quit+`: quitter WeeChat

----
/quit  [-yes] [<paramètres>]

      -yes : requis si l'option "weechat.look.confirm_quit" est activée
paramètres : texte envoyé avec le signal "quit"
             (par exemple l'extension irc utilise ce texte pour envoyer le message de quit au serveur)

Par défaut en quittant les fichiers de configuration sont sauvegardés (voir l'option "weechat.look.save_config_on_exit") et la disposition courante peut être sauvegardée (voir l'option "weechat.look.save_layout_on_exit").
----

[[command_weechat_reload]]
* `+reload+`: recharger les fichiers de configuration depuis le disque

----
/reload  [<fichier> [<fichier>...]]

fichier : fichier de configuration à recharger (sans l'extension ".conf")

Sans paramètre, tous les fichiers (WeeChat et extensions) sont rechargés.
----

[[command_weechat_repeat]]
* `+repeat+`: exécuter une commande plusieurs fois

----
/repeat  [-interval <délai>] <nombre> <commande>

   délai : délai entre l'exécution des commandes (en millisecondes)
  nombre : nombre de fois que la commande sera exécutée
commande : commande à exécuter (un '/' est automatiquement ajouté s'il n'est pas trouvé au début de la commande)

Toutes les commandes sont exécutées sur le tampon où la commande a été lancée.

Exemple :
  faire défiler de 2 pages vers le haut :
    /repeat 2 /window page_up
----

[[command_weechat_save]]
* `+save+`: sauvegarder les fichiers de configuration sur disque

----
/save  [<fichier> [<fichier>...]]

fichier : fichier de configuration à sauvegarder (sans l'extension ".conf")

Sans paramètre, tous les fichiers (WeeChat et extensions) sont sauvegardés.

Par défaut tous les fichiers de configuration sont sauvegardés sur disque sur la commande /quit (voir l'option "weechat.look.save_config_on_exit").
----

[[command_weechat_secure]]
* `+secure+`: gestion des données sécurisées (mots de passe ou données privées chiffrés dans le fichier sec.conf)

----
/secure  passphrase <phrase de chiffrement>|-delete
         decrypt <phrase de chiffrement>|-discard
         set <nom> <valeur>
         del <nom>

passphrase : modifier la phrase de chiffrement (sans phrase de chiffrement, les données sont stockées en texte brut dans le fichier sec.conf)
   -delete : supprimer la phrase de chiffrement
   decrypt : déchiffrer les données toujours chiffrées
  -discard : jeter toutes les données encore chiffrées
       set : ajouter ou modifier une donnée sécurisée
       del : supprimer une donnée sécurisée

Sans paramètre, cette commande affiche les données sécurisées dans un nouveau tampon.

Les touches sur le tampon des données sécurisées :
  alt+v  afficher/cacher les valeurs

Lorsqu'une phrase de chiffrement est utilisée (données chiffrées), elle est demandée au démarrage de WeeChat.
Il est possible de définir la variable d'environnement WEECHAT_PASSPHRASE pour éviter la demande (cette même variable est utilisée par WeeChat sur le /upgrade).

Les données sécurisées avec le format ${sec.data.xxx} peuvent être utilisées dans :
  - la commande /eval
  - le paramètre de ligne de commande "--run-command"
  - les options weechat.startup.command_{before|after}_plugins
  - d'autres options qui peuvent contenir un mot de passe ou des données sensibles (par exemple proxy, serveur irc et relay) ; voir /help sur les options pour vérifier si elles sont évaluées.

Exemples :
  définir une phrase de chiffrement :
    /secure passphrase ceci est ma phrase de chiffrement
  chiffrer le mot de passe freenode SASL :
    /secure set freenode motdepasse
    /set irc.server.freenode.sasl_password "${sec.data.freenode}"
  chiffrer le mot de passe oftc pour nickserv :
    /secure set oftc motdepasse
    /set irc.server.oftc.command "/msg nickserv identify ${sec.data.oftc}"
  alias pour ghost du pseudo "pseudo" :
    /alias add ghost /eval /msg -server freenode nickserv ghost pseudo ${sec.data.freenode}
----

[[command_weechat_set]]
* `+set+`: définir des options de configuration et des variables d'environnement

----
/set  [<option> [<valeur>]]
      diff [<option> [<option>...]]
      env [<variable> [<valeur>]]

option : nom d'une option (le caractère joker "*" est autorisé pour lister les options, si aucune valeur n'est spécifiée)
valeur : nouvelle valeur pour l'option, selon le type :
           booléen : on, off ou toggle
            entier : nombre, ++nombre ou --nombre
            chaîne : toute chaîne ("" pour une chaîne vide)
           couleur : nom de couleur, ++nombre ou --nombre
         Note : pour tous les types, vous pouvez utiliser null pour supprimer la valeur de l'option (valeur non définie). Cela ne fonctionne qu'avec certaines options spéciales des extensions.
  diff : afficher seulement les options modifiées
   env : afficher ou définir une variable d'environnement (utilisez la valeur "" pour supprimer une variable)

Exemples :
  afficher les options à propos du highlight :
    /set *highlight*
  ajouter un mot pour le highlight :
    /set weechat.look.highlight "mot"
  afficher les options modifiées :
    /set diff
  afficher les options modifiées dans l'extension irc :
    /set diff irc.*
  afficher la valeur de la variable d'environnement LANG :
    /set env LANG
  modifier la variable d'environnement LANG et l'utiliser :
    /set env LANG fr_FR.UTF-8
    /upgrade
  réinitialiser la variable d'environnement ABC :
    /set env ABC ""
----

[[command_weechat_unset]]
* `+unset+`: supprimer/réinitialiser des options de configuration

----
/unset  <option>
        -mask <option>

option : nom d'une option
 -mask : utiliser un masque pour l'option (le caractère joker "*" est autorisé pour réinitialiser plusieurs options, à utiliser avec prudence !)

Selon l'option, elle est réinitialisée (pour les options standards) ou supprimée (pour les options facultatives, comme les valeurs pour les serveurs).

Exemples :
  réinitialiser une option :
    /unset weechat.look.item_time_format
  réinitialiser toutes les options de couleur :
    /unset -mask weechat.color.*
----

[[command_weechat_upgrade]]
* `+upgrade+`: mettre à jour WeeChat sans se déconnecter des serveurs

----
/upgrade  [-yes] [<chemin_vers_binaire>|-quit]

               -yes : requis si l'option "weechat.look.confirm_upgrade" est activée
chemin_vers_binaire : chemin vers le binaire WeeChat (par défaut le binaire courant)
             -dummy : ne rien faire (option utilisée pour éviter une complétion accidentelle avec "-quit")
              -quit : fermer *TOUTES* les connexions, sauver la session et quitter, ce qui rend possible une restauration différée (voir ci-dessous)

Cette commande met à jour et recharge une session de WeeChat qui tourne. Le nouveau binaire WeeChat doit avoir été compilé ou installé via un gestionnaire de paquet avant de lancer cette commande.

Note : les connexions SSL sont perdues durant la mise à jour, car le rechargement de session SSL n'est pas possible actuellement avec GnuTLS. Il y a une reconnexion automatique après la mise à jour.

Le processus de mise à jour comporte 4 étapes :
  1. sauvegarder la session pour le cœur et les extensions (tampons, historique, ...)
  2. décharger toutes les extensions (les fichiers de configuration (*.conf) sont écrits sur disque)
  3. sauvegarder la configuration WeeChat (weechat.conf)
  4. exécuter le nouveau binaire WeeChat et recharger la session.

Avec l'option "-quit", le processus est légèrement différent :
  1. fermer *TOUTES* les connexions
  2. sauvegarder la session (fichiers *.upgrade)
  3. décharger les extensions
  4. sauvegarder la configuration WeeChat
  5. quitter WeeChat
Et plus tard vous pouvez restaurer la session avec la commande : weechat --upgrade
IMPORTANT : vous devez restaurer la session avec exactement la même configuration (fichiers *.conf).
Il est également possible de restaurer la session WeeChat sur une autre machine si vous y copiez le contenu du répertoire "~/.weechat".
----

[[command_weechat_uptime]]
* `+uptime+`: montrer l'uptime de WeeChat

----
/uptime  [-o | -ol]

 -o : envoyer l'uptime sur le tampon courant comme entrée (chaîne en anglais)
-ol : envoyer l'uptime sur le tampon courant comme entrée (chaîne traduite)
----

[[command_weechat_version]]
* `+version+`: afficher la version de WeeChat et la date de compilation

----
/version  [-o | -ol]

 -o : envoyer la version sur le tampon courant comme entrée (chaîne en anglais)
-ol : envoyer la version sur le tampon courant comme entrée (chaîne traduite)

L'alias par défaut /v peut être utilisé pour exécuter cette commande sur tous les tampons (sinon la commande irc /version est utilisée sur les tampons irc).
----

[[command_weechat_wait]]
* `+wait+`: planifier l'exécution d'une commande dans le futur

----
/wait  <nombre>[<unité>] <commande>

  nombre : temps à attendre (nombre entier)
   unité : optionnelle, valeurs possibles :
             ms : millisecondes
              s : secondes (par défaut)
              m : minutes
              h : heures
commande : commande à exécuter (ou texte à envoyer au tampon si la commande ne commence pas par '/')

Note : la commande est exécutée sur le tampon où /wait a été exécuté (si le tampon n'est pas trouvé, alors la commande est exécutée sur le tampon WeeChat principal).

Exemples :
  rejoindre le canal dans 10 secondes :
    /wait 10 /join #test
  passer absent dans 15 minutes :
    /wait 15m /away -all I'm away
  dire 'bonjour' dans 2 minutes :
    /wait 2m bonjour
----

[[command_weechat_window]]
* `+window+`: gestion des fenêtres

----
/window  list
         -1|+1|b#|up|down|left|right [-window <numéro>]
         <numéro>
         splith|splitv [-window <numéro>] [<pct>]
         resize [-window <numéro>] [h|v][+|-]<pct>
         balance
         merge [-window <numéro>] [all]
         page_up|page_down [-window <numéro>]
         refresh
         scroll [-window <numéro>] [+|-]<valeur>[s|m|h|d|M|y]
         scroll_horiz [-window <numéro>] [+|-]<valeur>[%]
         scroll_up|scroll_down|scroll_top|scroll_bottom|scroll_beyond_end|scroll_previous_highlight|scroll_next_highlight|scroll_unread [-window <numéro>]
         swap [-window <numéro>] [up|down|left|right]
         zoom [-window <numéro>]
         bare [<délai>]

         list : lister les fenêtres ouvertes (sans paramètre, cette liste est affichée)
           -1 : sauter à la fenêtre précédente
           +1 : sauter à la fenêtre suivante
           b# : sauter à la fenêtre affichant le tampon #
           up : sauter à la fenêtre au dessus
         down : sauter à la fenêtre au dessous
         left : sauter à la fenêtre à gauche
        right : sauter à la fenêtre à droite
       numéro : numéro de fenêtre (voir /window list)
       splith : éclater la fenêtre en deux horizontalement (pour défaire : /window merge)
       splitv : éclater la fenêtre en deux verticalement (pour défaire : /window merge)
       resize : redimensionner une fenêtre, la nouvelle taille est <pct> pourcentage de la fenêtre parente
                si "h" ou "v" est spécifié, le redimensionnement affecte la fenêtre parente la plus proche avec un découpage de ce type (horizontal/vertical)
      balance : équilibrer la taille de toutes les fenêtres
        merge : fusionner la fenêtre avec une autre
      page_up : faire défiler d'une page vers le haut
    page_down : faire défiler d'une page vers le bas
      refresh : redessiner l'écran
       scroll : faire défiler d'un nombre de lignes (+/-N) ou avec du temps : s=secondes, m=minutes, h=heures, d=jours, M=mois, y=année
 scroll_horiz : faire défiler horizontalement d'un nombre de colonnes (+/-N) ou un pourcentage de la taille de fenêtre (ce défilement est possible seulement sur les tampons avec contenu libre)
    scroll_up : faire défiler de quelques lignes vers le haut
  scroll_down : faire défiler de quelques lignes vers le bas
   scroll_top : faire défiler jusqu'au début du tampon
scroll_bottom : faire défiler jusqu'en bas du tampon
scroll_beyond_end : faire défiler au-delà de la fin du tampon
scroll_previous_highlight : faire défiler jusqu'au highlight précédent
scroll_next_highlight : faire défiler jusqu'au highlight suivant
scroll_unread : faire défiler jusqu'au marqueur de données non lues
         swap : échanger les tampons de deux fenêtres (avec une direction facultative pour la fenêtre cible)
         zoom : zoomer sur la fenêtre
         bare : activer/désactiver le mode d'affichage dépouillé (avec un délai facultatif en secondes pour un retour automatique au mode d'affichage standard)

Pour splith et splitv, pct est un pourcentage qui représente la taille de la nouvelle fenêtre, calculée par rapport à la taille de la fenêtre courante. Par exemple 25 signifie créer une fenêtre qui a pour taille : taille_courante / 4

Exemples :
  sauter à la fenêtre affichant le tampon 1 :
    /window b1
  défilement de 2 lignes vers le haut :
    /window scroll -2
  défilement de 2 jours vers le haut :
    /window scroll -2d
  défilement jusqu'au début du jour courant :
    /window scroll -d
  zoom sur la fenêtre numéro 2 :
    /window zoom -window 2
  éclater la fenêtre horizontalement en utilisant 30% de l'espace pour la fenêtre du haut :
    /window splith 30
  redimensionner la fenêtre à 75% de la taille de la fenêtre parente :
    /window resize 75
  redimensionner le découpage vertical, ajouter 10% dans la taille :
    /window resize v+10
  supprimer l'éclatement :
    /window merge
  activer le mode d'affichage dépouillé pendant 2 secondes :
    /window bare 2
----