doc: add description of sections in configuration files (user's guide)

1 files changed, 165 insertions, 12 deletions

diff --git a/doc/fr/weechat_user.fr.txt b/doc/fr/weechat_user.fr.txt
index 414479c4f..d8bf72f84 100644
--- a/doc/fr/weechat_user.fr.txt
+++ b/doc/fr/weechat_user.fr.txt
@@ -1508,21 +1508,66 @@ Exemple de gras avec la couleur de texte du terminal :
 /set weechat.color.status_time *99999
 ----------------------------------------
 
+[[options_and_commands]]
+Options et commandes
+~~~~~~~~~~~~~~~~~~~~
+
 [[sec_options]]
 Options des données sécurisées (sec.conf)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section | Commande de contrôle               | Description
+| crypt   | /set sec.crypt.*                   | Options pour le chiffrement
+| data    | <<command_weechat_secure,/secure>> | Données sécurisées
+|========================================
+
+Options :
 
 include::autogen/user/sec_options.txt[]
 
 [[weechat_options]]
 Options WeeChat (weechat.conf)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section    | Commande de contrôle                      | Description
+| debug      | <<command_weechat_debug,/debug set>>      +
+               /set weechat.debug.*                      | Niveau de debug, pour le Debug level, pour le coeur et les extensions (les options peuvent être ajoutées/supprimées dans la section)
+| startup    | /set weechat.startup.*                    | Options de démarrage
+| look       | /set weechat.look.*                       | Look and feel
+| palette    | <<command_weechat_color,/color alias>>    +
+               /set weechat.palette.*                    | Alias de couleurs (les options peuvent être ajoutées/supprimées dans la section)
+| color      | /set weechat.color.*                      | Couleurs
+| completion | /set weechat.completion.*                 | Options de complétion
+| history    | /set weechat.history.*                    | Options d'historique (commandes et tampons)
+| proxy      | <<command_weechat_proxy,/proxy>>          +
+               /set weechat.proxy.*                      | Options des proxies
+| network    | /set weechat.network.*                    | Options réseau/SSL
+| bar        | <<command_weechat_bar,/bar>>              +
+               /set weechat.bar.*                        | Options des barres
+| layout     | <<command_weechat_layout,/layout>>        | Layouts
+| notify     | <<command_weechat_buffer,/buffer notify>> | Niveaux de notification des tampons (les options peuvent être ajoutées/supprimées dans la section)
+| filter     | <<command_weechat_filter,/filter>>        | Filtres
+| key        | <<command_weechat_key,/key>>              | Touches pour le contexte "default"
+| key_search | <<command_weechat_key,/key>>              | Touches pour le contexte "search"
+| key_cursor | <<command_weechat_key,/key>>              | Touches pour le contexte "cursor"
+| key_mouse  | <<command_weechat_key,/key>>              | Touches pour le contexte "mouse"
+|========================================
+
+Options :
 
 include::autogen/user/weechat_options.txt[]
 
 [[weechat_commands]]
 Commandes WeeChat
-~~~~~~~~~~~~~~~~~
+^^^^^^^^^^^^^^^^^
 
 include::autogen/user/weechat_commands.txt[]
 
@@ -1530,14 +1575,6 @@ include::autogen/user/weechat_commands.txt[]
 Extensions
 ----------
 
-Pour en apprendre plus sur le développement d'extension ou de script (via
-l'API), merci de consulter la 'Référence API Extension WeeChat' ou le 'Guide
-pour Scripts WeeChat'.
-
-[[plugins_in_weechat]]
-Extensions dans WeeChat
-~~~~~~~~~~~~~~~~~~~~~~~
-
 Une extension est une bibliothèque dynamique, écrite en C et compilée, qui est
 chargée par WeeChat.
 Sous GNU/Linux, ce fichier a une extension ".so", et ".dll" sous Windows.
@@ -1575,7 +1612,7 @@ Les extensions par défaut sont :
 | fifo      | Tube FIFO pour envoyer des commandes à distance vers WeeChat
 | irc       | Discussion avec le protocole IRC
 | logger    | Enregistrement des tampons dans des fichiers
-| relay     | Relai de données via le réseau (proxy IRC)
+| relay     | Relai de données via le réseau
 | rmodifier | Modification des chaînes de "modifier" avec des expressions régulières
 | python    | Interface (API) pour scripts Python
 | perl      | Interface (API) pour scripts Perl
@@ -1586,6 +1623,10 @@ Les extensions par défaut sont :
 | xfer      | Transfert de fichier et discussion directe
 |========================================
 
+Pour en apprendre plus sur le développement d'extension ou de script (via
+l'API), merci de consulter la 'Référence API Extension WeeChat' ou le 'Guide
+pour Scripts WeeChat'.
+
 [[alias_plugin]]
 Extension Alias
 ~~~~~~~~~~~~~~~
@@ -1610,6 +1651,20 @@ Il est possible d'utiliser plusieurs langages par tampon.
 Options (aspell.conf)
 ^^^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section    | Commande de contrôle                      | Description
+| color      | /set aspell.color.*                       | Couleurs
+| check      | /set aspell.check.*                       | Options pour contrôler la vérification orthographique
+| dict       | <<command_aspell_aspell,/aspell setdict>> +
+               /set aspell.dict.*                        | Dictionnaires utilisés par tampon (les options peuvent être ajoutées/supprimées dans la section)
+| option     | /set aspell.option.*                      | <<aspell_speller_options,Options du vérificateur d'orthographe>> (les options peuvent être ajoutées/supprimées dans la section)
+|========================================
+
+Options :
+
 include::autogen/user/aspell_options.txt[]
 
 [[aspell_commands]]
@@ -1709,6 +1764,20 @@ charset: terminal: ISO-8859-15, interne: UTF-8
 Options (charset.conf)
 ^^^^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section | Commande de contrôle                        | Description
+| default | /set charset.default.*                      | Jeu de caractère d'encodage/décodage par défaut
+| decode  | <<command_charset_charset,/charset decode>> +
+            /set charset.decode.*                       | Jeu de caractère d'encodage par tampon (les options peuvent être ajoutées/supprimées dans la section)
+| encode  | <<command_charset_charset,/charset encode>> +
+            /set charset.encode.*                       | Jeu de caractère de décodage par tampon (les options peuvent être ajoutées/supprimées dans la section)
+|========================================
+
+Options :
+
 include::autogen/user/charset_options.txt[]
 
 [[charset_commands]]
@@ -1873,6 +1942,24 @@ $ weechat irc://nono@irc.freenode.net/#weechat,#toto
 Options (irc.conf)
 ^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section        | Commande de contrôle           | Description
+| look           | /set irc.look.*                | Look and feel
+| color          | /set irc.color.*               | Couleurs
+| network        | /set irc.network.*             | Options réseau
+| msgbuffer      | /set irc.msgbuffer.*           | <<irc_target_buffer,Tampon cible pour les messages IRC>> (les options peuvent être ajoutées/supprimées dans la section)
+| ctcp           | /set irc.ctcp.*                | <<irc_ctcp_replies,Réponses CTCP>> (les options peuvent être ajoutées/supprimées dans la section)
+| ignore         | <<command_irc_ignore,/ignore>> | Personnes ignorées
+| server_default | /set irc.server_default.*      | Valeurs par défaut pour serveurs (les options peuvent être ajoutées/supprimées dans la section)
+| server         | <<command_irc_server,/server>> +
+                   /set irc.server.*              | Serveurs
+|========================================
+
+Options :
+
 include::autogen/user/irc_options.txt[]
 
 [[irc_commands]]
@@ -2295,6 +2382,20 @@ fichiers, avec des options sur comment et quoi sauvegarder.
 Options (logger.conf)
 ^^^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section | Commande de contrôle | Description
+| look    | /set logger.look.*   | Look and feel
+| color   | /set logger.color.*  | Couleurs
+| file    | /set logger.file.*   | Options pour les fichiers de log
+| level   | /set logger.level.*  | Niveau de log par tampon (les options peuvent être ajoutées/supprimées dans la section)
+| mask    | /set logger.mask.*   | Masque de nom de fichier par tampon (les options peuvent être ajoutées/supprimées dans la section)
+|========================================
+
+Options :
+
 include::autogen/user/logger_options.txt[]
 
 [[logger_commands]]
@@ -2445,6 +2546,21 @@ utilisant divers protocoles :
 Options (relay.conf)
 ^^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section | Commande de contrôle               | Description
+| look    | /set relay.look.*                  | Look and feel
+| color   | /set relay.color.*                 | Couleurs
+| network | /set relay.network.*               | Options réseau
+| irc     | /set relay.irc.*                   | Options spécifiques au protocole irc (proxy irc)
+| port    | <<command_relay_relay,/relay add>> +
+            /set relay.port.*                  | Ports utilisés pour le relai (protocoles irc et weechat) (les options peuvent être ajoutées/supprimées dans la section)
+|========================================
+
+Options :
+
 include::autogen/user/relay_options.txt[]
 
 [[relay_commands]]
@@ -2580,6 +2696,18 @@ possible par exemple de remplacer chaque lettre de ces mots de passe par `*`.
 Options (rmodifier.conf)
 ^^^^^^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section  | Commande de contrôle                           | Description
+| look     | /set rmodifier.look.*                          | Look and feel
+| modifier | <<command_rmodifier_rmodifier,/rmodifier add>> +
+             /set rmodifier.modifier.*                      | Rmodifiers
+|========================================
+
+Options :
+
 include::autogen/user/rmodifier_options.txt[]
 
 [[rmodifier_commands]]
@@ -2651,6 +2779,18 @@ WeeChat pour les scripts, merci de lire le 'Le Guide pour Scripts WeeChat'.
 Options Script (script.conf)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section | Commande de contrôle  | Description
+| look    | /set script.look.*    | Look and feel
+| color   | /set script.color.*   | Couleurs
+| scripts | /set script.scripts.* | Options pour le téléchargement des scripts
+|========================================
+
+Options :
+
 include::autogen/user/script_options.txt[]
 
 [[script_commands]]
@@ -2709,6 +2849,19 @@ L'extension Xfer permet :
 Options (xfer.conf)
 ^^^^^^^^^^^^^^^^^^^
 
+Sections :
+
+[width="100%",cols="3m,6m,16",options="header"]
+|========================================
+| Section | Commande de contrôle | Description
+| look    | /set xfer.look.*     | Look and feel
+| color   | /set xfer.color.*    | Couleurs
+| network | /set xfer.network.*  | Options réseau
+| file    | /set xfer.file.*     | Options pour les fichiers envoyés/reçus
+|========================================
+
+Options :
+
 include::autogen/user/xfer_options.txt[]
 
 [[xfer_commands]]