doc: add doc about connection to Freenode with TOR/SASL

4 files changed, 216 insertions, 0 deletions

diff --git a/doc/de/weechat_user.de.txt b/doc/de/weechat_user.de.txt
index 90c10d052..a3e73d73e 100644
--- a/doc/de/weechat_user.de.txt
+++ b/doc/de/weechat_user.de.txt
@@ -1188,6 +1188,60 @@ $ cat nick.cer nick.key > ~/.weechat/ssl/nick.pem
 
 Für weiterreichende Informationen lesen Sie bitte: http://www.oftc.net/oftc/NickServ/CertFP
 
+// TRANSLATION MISSING
+[[irc_tor_freenode]]
+Connect to Freenode with TOR/SASL
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In addition to SSL, Freenode servers support connections with TOR
+(https://www.torproject.org/), a network of virtual tunnels that allows people
+and groups to improve their privacy and security on the Internet.
+
+First, make sure to have WeeChat compiled with <<dependencies,libgcrypt11-dev>>
+(if built from sources); it's not mandatory, but DH-BLOWFISH ensures stronger
+security compared to PLAIN autenthication system with SASL.
+
+In first place, install TOR. For Debian (and derivated):
+
+----------------------------------------
+$ sudo apt-get install tor
+----------------------------------------
+
+In WeeChat you need to create a socks5 proxy for TOR service (hostname/IP and
+port depend on your TOR configuration):
+
+----------------------------------------
+/proxy add tor socks5 127.0.0.1 9050
+----------------------------------------
+
+Now, create a new server, for example:
+
+----------------------------------------
+/server add freenode-tor p4fsi4ockecnea7l.onion
+----------------------------------------
+
+Set proxy for TOR:
+
+----------------------------------------
+/set irc.server.freenode-tor.proxy "tor"
+----------------------------------------
+
+Set SASL authtentication:
+
+----------------------------------------
+/set irc.server.freenode-tor.sasl_mechanism dh-blowfish
+/set irc.server.freenode-tor.sasl_username "your_nickname"
+/set irc.server.freenode-tor.sasl_password "your_password"
+----------------------------------------
+
+And finally, connection to server:
+
+----------------------------------------
+/connect freenode-tor
+----------------------------------------
+
+For more info about Freenode and TOR: http://freenode.net/irc_servers.shtml#tor
+
 [[irc_smart_filter_join_part_quit]]
 einfacher Filter für join/part/quit Nachrichten
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/doc/en/weechat_user.en.txt b/doc/en/weechat_user.en.txt
index 3b3fc6eef..caf6fc3d4 100644
--- a/doc/en/weechat_user.en.txt
+++ b/doc/en/weechat_user.en.txt
@@ -1171,6 +1171,59 @@ $ cat nick.cer nick.key > ~/.weechat/ssl/nick.pem
 
 For more information, look at http://www.oftc.net/oftc/NickServ/CertFP
 
+[[irc_tor_freenode]]
+Connect to Freenode with TOR/SASL
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In addition to SSL, Freenode servers support connections with TOR
+(https://www.torproject.org/), a network of virtual tunnels that allows people
+and groups to improve their privacy and security on the Internet.
+
+First, make sure to have WeeChat compiled with <<dependencies,libgcrypt11-dev>>
+(if built from sources); it's not mandatory, but DH-BLOWFISH ensures stronger
+security compared to PLAIN autenthication system with SASL.
+
+In first place, install TOR. For Debian (and derivated):
+
+----------------------------------------
+$ sudo apt-get install tor
+----------------------------------------
+
+In WeeChat you need to create a socks5 proxy for TOR service (hostname/IP and
+port depend on your TOR configuration):
+
+----------------------------------------
+/proxy add tor socks5 127.0.0.1 9050
+----------------------------------------
+
+Now, create a new server, for example:
+
+----------------------------------------
+/server add freenode-tor p4fsi4ockecnea7l.onion
+----------------------------------------
+
+Set proxy for TOR:
+
+----------------------------------------
+/set irc.server.freenode-tor.proxy "tor"
+----------------------------------------
+
+Set SASL authtentication:
+
+----------------------------------------
+/set irc.server.freenode-tor.sasl_mechanism dh-blowfish
+/set irc.server.freenode-tor.sasl_username "your_nickname"
+/set irc.server.freenode-tor.sasl_password "your_password"
+----------------------------------------
+
+And finally, connection to server:
+
+----------------------------------------
+/connect freenode-tor
+----------------------------------------
+
+For more info about Freenode and TOR: http://freenode.net/irc_servers.shtml#tor
+
 [[irc_smart_filter_join_part_quit]]
 Smart filter for join/part/quit messages
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/doc/fr/weechat_user.fr.txt b/doc/fr/weechat_user.fr.txt
index f0643a6d8..eab67790b 100644
--- a/doc/fr/weechat_user.fr.txt
+++ b/doc/fr/weechat_user.fr.txt
@@ -1206,6 +1206,61 @@ $ cat nick.cer nick.key > ~/.weechat/ssl/nick.pem
 
 Pour plus d'informations, consulter http://www.oftc.net/oftc/NickServ/CertFP
 
+[[irc_tor_freenode]]
+Connexion à Freenode avec TOR/SASL
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+En plus du SSL, les serveurs Freenode supportent les connexions avec TOR
+(https://www.torproject.org/), un réseau de tunnels virtuels qui permet aux
+personnes et groupes d'améliorer leur vie privée et sécurité sur Internet.
+
+Premièrement, assurez-vous d'avoir compilé WeeChat avec
+<<dependencies,libgcrypt11-dev>> (si construit depuis les sources); ce n'est
+pas obligatoire, mais DH-BLOWFISH assure une meilleure sécurité comparé à
+l'authentification PLAIN avec SASL.
+
+En premier lieu, installez TOR. Pour Debian (et dérivés) :
+
+----------------------------------------
+$ sudo apt-get install tor
+----------------------------------------
+
+Sous WeeChat vous devez créer un proxy socks5 pour le service TOR (le nom/IP
+et port dépend de votre configuration de TOR) :
+
+----------------------------------------
+/proxy add tor socks5 127.0.0.1 9050
+----------------------------------------
+
+Maintenant, créez un nouveau serveur, par exemple :
+
+----------------------------------------
+/server add freenode-tor p4fsi4ockecnea7l.onion
+----------------------------------------
+
+Définissez le proxy pour TOR :
+
+----------------------------------------
+/set irc.server.freenode-tor.proxy "tor"
+----------------------------------------
+
+Définissez l'authentification SASL :
+
+----------------------------------------
+/set irc.server.freenode-tor.sasl_mechanism dh-blowfish
+/set irc.server.freenode-tor.sasl_username "your_nickname"
+/set irc.server.freenode-tor.sasl_password "your_password"
+----------------------------------------
+
+Et enfin, la connexion au serveur :
+
+----------------------------------------
+/connect freenode-tor
+----------------------------------------
+
+Pour plus d'informations à propos de Freenode et TOR :
+http://freenode.net/irc_servers.shtml#tor
+
 [[irc_smart_filter_join_part_quit]]
 Filtre intelligent pour les messages join/part/quit
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
diff --git a/doc/it/weechat_user.it.txt b/doc/it/weechat_user.it.txt
index 5e622d29a..870baa8d7 100644
--- a/doc/it/weechat_user.it.txt
+++ b/doc/it/weechat_user.it.txt
@@ -1195,6 +1195,60 @@ $ cat nick.cer nick.key > ~/.weechat/ssl/nick.pem
 
 Per maggiori informazioni consultare http://www.oftc.net/oftc/NickServ/CertFP
 
+// TRANSLATION MISSING
+[[irc_tor_freenode]]
+Connect to Freenode with TOR/SASL
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+In addition to SSL, Freenode servers support connections with TOR
+(https://www.torproject.org/), a network of virtual tunnels that allows people
+and groups to improve their privacy and security on the Internet.
+
+First, make sure to have WeeChat compiled with <<dependencies,libgcrypt11-dev>>
+(if built from sources); it's not mandatory, but DH-BLOWFISH ensures stronger
+security compared to PLAIN autenthication system with SASL.
+
+In first place, install TOR. For Debian (and derivated):
+
+----------------------------------------
+$ sudo apt-get install tor
+----------------------------------------
+
+In WeeChat you need to create a socks5 proxy for TOR service (hostname/IP and
+port depend on your TOR configuration):
+
+----------------------------------------
+/proxy add tor socks5 127.0.0.1 9050
+----------------------------------------
+
+Now, create a new server, for example:
+
+----------------------------------------
+/server add freenode-tor p4fsi4ockecnea7l.onion
+----------------------------------------
+
+Set proxy for TOR:
+
+----------------------------------------
+/set irc.server.freenode-tor.proxy "tor"
+----------------------------------------
+
+Set SASL authtentication:
+
+----------------------------------------
+/set irc.server.freenode-tor.sasl_mechanism dh-blowfish
+/set irc.server.freenode-tor.sasl_username "your_nickname"
+/set irc.server.freenode-tor.sasl_password "your_password"
+----------------------------------------
+
+And finally, connection to server:
+
+----------------------------------------
+/connect freenode-tor
+----------------------------------------
+
+For more info about Freenode and TOR: http://freenode.net/irc_servers.shtml#tor
+
 [[irc_smart_filter_join_part_quit]]
 Filtro smart per i messaggi di entrata/uscita/disconnessione
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^