]> git.eshelyaron.com Git - emacs.git/commitdiff
; * doc/misc/erc.texi: Fix reconnecting in SOCKS example.
authorF. Jason Park <jp@neverwas.me>
Thu, 8 Jun 2023 07:40:02 +0000 (00:40 -0700)
committerF. Jason Park <jp@neverwas.me>
Mon, 12 Jun 2023 02:18:14 +0000 (19:18 -0700)
doc/misc/erc.texi

index 14c6a457654faa055fd577be0a326c5b16e9106e..e848ed21a50fb4a361fdfcd7286d273ce44de649 100644 (file)
@@ -1281,20 +1281,23 @@ something appropriate, like @code{("tor" "127.0.0.1" 9050 5)}.  For
 some networks, setting @code{erc-server-connect-function} to
 @code{socks-open-network-stream} might be enough.  Others, like
 @samp{Libera.Chat}, involve additional setup.  At the time of writing,
-connecting to @samp{Libera.Chat} requires both @acronym{TLS} and a
-non-@samp{PLAIN} @acronym{SASL} mechanism (@pxref{SASL}).  One way to
-achieve that is by using the @samp{EXTERNAL} mechanism, as shown in
-the following example:
+connecting to that network requires both @acronym{TLS} and a permitted
+@acronym{SASL} mechanism, like @samp{EXTERNAL} (@pxref{SASL}), as
+shown in the following example:
 
 @lisp
 (require 'erc)
 (require 'socks)
 
-(let* ((socks-password "")
-       (socks-server '("tor" "localhost" 9050 5))
-       (erc-modules (cons 'sasl erc-modules))
+(defun my-erc-open-socks-tls-stream (&rest args)
+  (let ((socks-username "")
+        (socks-password "")
+        (socks-server '("tor" "localhost" 9050 5)))
+    (apply #'erc-open-socks-tls-stream args)))
+
+(let* ((erc-modules (cons 'sasl erc-modules))
        (erc-sasl-mechanism 'external)
-       (erc-server-connect-function #'erc-open-socks-tls-stream))
+       (erc-server-connect-function #'my-erc-open-socks-tls-stream))
   (erc-tls
    :server "libera75jm6of4wxpxt4aynol3xjmbtxgfyjpu34ss4d7r7q2v5zrpyd.onion"
    :port 6697
@@ -1304,6 +1307,14 @@ the following example:
    :client-certificate (list "/home/jrh/key.pem" "/home/jrh/cert.pem")))
 @end lisp
 
+@noindent
+Here, the user-provided @code{my-erc-open-socks-tls-stream} ensures
+that the preferred values for @code{socks-server} and friends will be
+available when reconnecting.  If you plan on using @acronym{SOCKS}
+with ERC exclusively, you can just set those options and variables
+globally and bind @code{erc-server-connect-function} to
+@code{erc-open-socks-tls-stream} instead.
+
 @node auth-source
 @subsection auth-source
 @cindex auth-source