doc: add SASL authentication in quickstart guide

8 files changed, 118 insertions, 41 deletions

diff --git a/doc/de/weechat_quickstart.de.txt b/doc/de/weechat_quickstart.de.txt
index 75c3fd951..d770b29c6 100644
--- a/doc/de/weechat_quickstart.de.txt
+++ b/doc/de/weechat_quickstart.de.txt
@@ -99,7 +99,7 @@ Als Beispiel erwähnt ist die Vorgabe (default) nicks, die auf dem Un*x Login
 basiert. Diese Vorgabe kann nun für den oftc-Server mittels folgendem Befehl
 überschrieben werden:
 
-  /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
+  /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
 
 Um einen User- und realen Namen zu setzen:
 
@@ -111,12 +111,22 @@ herzustellen:
 
   /set irc.server.oftc.autoconnect on
 
-Um einen Befehl nach der Verbindung zum Server auszuführen, z.B. identifizieren
-beim nickserv:
+// TRANSLATION MISSING
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "mynick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-Hinweis: Mehrere Befehle können mittels ';' (Semikolon) getrennt werden.
+// TRANSLATION MISSING
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
+
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+Mehrere Befehle können mittels ';' (Semikolon) getrennt werden.
 
 Um ein auto-join (automatisches 'betreten') von Channels (Räumen) nach der
 Verbindung zum Server zu erreichen:
diff --git a/doc/en/weechat_quickstart.en.txt b/doc/en/weechat_quickstart.en.txt
index 5b4fc0931..94f7d2783 100644
--- a/doc/en/weechat_quickstart.en.txt
+++ b/doc/en/weechat_quickstart.en.txt
@@ -90,7 +90,7 @@ For each server option, WeeChat uses its value if it is defined (not
 For example there's default nicks (based on your un*x login), and you can
 override them for oftc server with following command:
 
-  /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
+  /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
 
 To set username and realname:
 
@@ -101,12 +101,20 @@ To enable auto-connect to server at startup:
 
   /set irc.server.oftc.autoconnect on
 
-To run a command after connection to server, for example to identify
-with nickserv:
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "mynick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-Note: many commands can be separated by ';' (semi-colon)
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
+
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+Many commands can be separated by ';' (semi-colon).
 
 To auto-join some channels when connecting to server:
 
diff --git a/doc/es/weechat_quickstart.es.txt b/doc/es/weechat_quickstart.es.txt
index ee2c7a634..a6f098386 100644
--- a/doc/es/weechat_quickstart.es.txt
+++ b/doc/es/weechat_quickstart.es.txt
@@ -99,7 +99,7 @@ Por ejemplo, tenemos el nick por defecto (que se basa en su login) pero
 usted puedes sobreescribirlo para el servidor identificado como oftc
 de la siguiente manera:
 
-  /set irc.server.oftc.nicks "nick1,nick2,nick3,nick4,nick5"
+  /set irc.server.oftc.nicks "nick,nick2,nick3,nick4,nick5"
 
 También para configurar el nombre de usuario y el nombre real:
 
@@ -110,12 +110,22 @@ Para que el servidor se conecte cuando WeeChat inicie:
 
   /set irc.server.oftc.autoconnect on
 
-Para correr un comando después de establecer la conexión, por
-ejemplo, una identificación con el nickserv:
+// TRANSLATION MISSING
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
+
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "nick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+// TRANSLATION MISSING
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
 
-Nota: varios comandos pueden ser escritos separados por ';' (punto y coma)
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+Varios comandos pueden ser escritos separados por ';' (punto y coma).
 
 Para unirse automáticamente a canales cuando el servidor se conecte:
 
diff --git a/doc/fr/weechat_quickstart.fr.txt b/doc/fr/weechat_quickstart.fr.txt
index 1a2fa5902..2357478f2 100644
--- a/doc/fr/weechat_quickstart.fr.txt
+++ b/doc/fr/weechat_quickstart.fr.txt
@@ -96,7 +96,7 @@ définie (non "null"). Sinon WeeChat utilise la valeur par défaut
 Par exemple il y a des pseudos par défaut (basés sur votre login un*x), et
 vous pouvez les écraser pour le serveur oftc avec la commande suivante :
 
-  /set irc.server.oftc.nicks "pseudo1,pseudo2,pseudo3,pseudo4,pseudo5"
+  /set irc.server.oftc.nicks "pseudo,pseudo2,pseudo3,pseudo4,pseudo5"
 
 Pour modifier le nom d'utilisateur et nom réel :
 
@@ -107,12 +107,21 @@ Pour activer la connexion automatique au serveur lors du démarrage :
 
   /set irc.server.oftc.autoconnect on
 
+Si SASL est disponible sur le serveur, vous pouvez l'utiliser pour
+l'authentification (vous serez identifié avant de rejoindre les canaux) :
+
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "pseudo"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
+
 Pour lancer une commande après connexion au serveur, par exemple pour
-s'identifier auprès de nickserv :
+s'authentifier auprès de nickserv (seulement si vous n'utilisez pas SASL pour
+l'authentification) :
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
 
-NB: plusieurs commandes peuvent être séparées par ';' (point-virgule)
+[NOTE]
+Plusieurs commandes peuvent être séparées par ';' (point-virgule).
 
 Pour rejoindre automatiquement des canaux lors de la connexion au serveur :
 
@@ -152,11 +161,11 @@ tampon distinct par serveur :
 
 
 [[join_part_irc_channels]]
-Joindre/quitter les canaux IRC
+Rejoindre/quitter les canaux IRC
 ------------------------------
 
 `/join #channel`:
-    joindre un canal
+    rejoindre un canal
 
 `/part [message de fin]`::
     quitter un canal (en laissant le tampon ouvert)
diff --git a/doc/it/weechat_quickstart.it.txt b/doc/it/weechat_quickstart.it.txt
index 82c3cc851..bcc70db7b 100644
--- a/doc/it/weechat_quickstart.it.txt
+++ b/doc/it/weechat_quickstart.it.txt
@@ -94,7 +94,7 @@ Per ogni opzione del server, WeeChat usa il proprio valore se definito
 Per esempio ci sono dei nick predefiniti (basati sul proprio login un*x), ed
 è possibile sovrascriverli per il server oftc con il seguente comando:
 
-  /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
+  /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
 
 Per impostare il nome utente ed il nome reale:
 
@@ -105,12 +105,22 @@ Per impostare la connessione automatica al server all'avvio:
 
   /set irc.server.oftc.autoconnect on
 
-Per eseguire un comando dopo la connessione al server, ad esempio
-per identificarsi con nickserv:
+// TRANSLATION MISSING
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
+
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "mynick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+// TRANSLATION MISSING
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
 
-Nota: più comandi possono essere separati da ';' (punto e virgola)
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+Più comandi possono essere separati da ';' (punto e virgola).
 
 Per entrare automaticamente in alcuni canali quando ci si connette
 al server:
diff --git a/doc/ja/weechat_quickstart.ja.txt b/doc/ja/weechat_quickstart.ja.txt
index b7bca916d..4921831d3 100644
--- a/doc/ja/weechat_quickstart.ja.txt
+++ b/doc/ja/weechat_quickstart.ja.txt
@@ -84,7 +84,7 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ�
 例えばデフォルトでは (un*x ログイン名をベースにした)
 ニックネームが設定されますが、以下のコマンドで oftc サーバ用の設定として上書きすることが可能です:
 
-  /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
+  /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
 
 ユーザ名と実名を設定する場合:
 
@@ -95,12 +95,22 @@ IRC 等全てのネットワークプロトコルはそれぞれ異なるプラ�
 
   /set irc.server.oftc.autoconnect on
 
-サーバに接続後にコマンドを送信したい場合、例えば
-nickserv の認証を行う場合:
+// TRANSLATION MISSING
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "mynick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-備考: ';' (セミコロン) で繋ぐことで複数のコマンドを設定することができます
+// TRANSLATION MISSING
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
+
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+';' (セミコロン) で繋ぐことで複数のコマンドを設定することができます
 
 チャンネルへの自動参加を設定する場合:
 
diff --git a/doc/pl/weechat_quickstart.pl.txt b/doc/pl/weechat_quickstart.pl.txt
index 46106e4dc..b5729b008 100644
--- a/doc/pl/weechat_quickstart.pl.txt
+++ b/doc/pl/weechat_quickstart.pl.txt
@@ -90,7 +90,7 @@ Dla każdej opcji serwera WeeChat używa jej wartości jeśli jest zdefiniowana
 Na przykład znajdują się tam domyślne nicki (bazujące na Twoim loginie un*x),
 możesz je zmienić dla serwera oftc następującą komendą:
 
-  /set irc.server.oftc.nicks "mójnick1,mójnick2,mójnick3,mójnick4,mójnick5"
+  /set irc.server.oftc.nicks "mójnick,mójnick2,mójnick3,mójnick4,mójnick5"
 
 Ustawienie nazwy użytkownika i imienia:
 
@@ -101,12 +101,22 @@ Aby włączyć automatyczne łączenie się z serwerem przy starcie:
 
   /set irc.server.oftc.autoconnect on
 
-Aby wykonać komendę po połączeniu z serwerem, na przykład zidentyfikować się
-w nickserv:
+// TRANSLATION MISSING
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
+
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "mójnick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+// TRANSLATION MISSING
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
 
-Przypis: wiele komend może być oddzielonych ';' (średnik)
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+Wiele komend może być oddzielonych ';' (średnik).
 
 Aby automatycznie wejść na kanały po połączeniu z serwerem:
 
diff --git a/doc/ru/weechat_quickstart.ru.txt b/doc/ru/weechat_quickstart.ru.txt
index 071dd3ed6..a1449271d 100644
--- a/doc/ru/weechat_quickstart.ru.txt
+++ b/doc/ru/weechat_quickstart.ru.txt
@@ -89,7 +89,7 @@ WeeChat использует стандартные значения для вс
 На пример: есть ники по умолчанию (базируются на логине un*x системы), и
 вы можете переназначить их для сервера oftc используя команду:
 
-  /set irc.server.oftc.nicks "mynick1,mynick2,mynick3,mynick4,mynick5"
+  /set irc.server.oftc.nicks "mynick,mynick2,mynick3,mynick4,mynick5"
 
 Что бы установить имя, и реальное Имя:
 
@@ -100,12 +100,22 @@ WeeChat использует стандартные значения для вс
 
   /set irc.server.oftc.autoconnect on
 
-Для выполнения команды после подключения, на пример для идентификации
-с помошью NickServ:
+// TRANSLATION MISSING
+If SASL is available on server, you can use it for authentication (you will be
+identified before you join channels):
+
+  /set irc.server_default.sasl_mechanism dh-blowfish
+  /set irc.server.oftc.sasl_username "mynick"
+  /set irc.server.oftc.sasl_password "xxxxxxx"
 
-  /set irc.server.oftc.command "/msg nickserv identify xxxxxx"
+// TRANSLATION MISSING
+To run a command after connection to server, for example to authenticate
+with nickserv (only if you don't use SASL for authentication):
 
-На заметку: команды могут быть разделены используя ';' (двоеточия)
+  /set irc.server.oftc.command "/msg nickserv identify xxxxxxx"
+
+[NOTE]
+команды могут быть разделены используя ';' (двоеточия).
 
 Для автовхода на каналы при подключении используйте: