From: F. Jason Park <jp@neverwas.me>
Date: Sat, 6 Jan 2024 21:32:42 +0000 (-0800)
Subject: ; doc/misc/erc.texi: Improve SASL intro.
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=94f760163e221587fbba08a31e81c19527f037fe;p=emacs.git

; doc/misc/erc.texi: Improve SASL intro.
---

diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi
index 7fbe6f9766e..52c7477c9dd 100644
--- a/doc/misc/erc.texi
+++ b/doc/misc/erc.texi
@@ -1048,13 +1048,19 @@ acceptable.
 @section Authenticating via SASL
 @cindex SASL
 
-Regardless of the mechanism or the network, you'll likely have to be
-registered before first use.  Please refer to the network's own
+If you've used @acronym{SASL} elsewhere, you can probably skip to the
+examples below.  Otherwise, if you haven't already registered with
+your network, please do so now, referring to the network's own
 instructions for details.  If you're new to IRC and using a bouncer,
-know that you probably won't be needing SASL for the client-to-bouncer
-connection.  To get started, just add @code{sasl} to
-@code{erc-modules} like any other module.  But before that, please
-explore all custom options pertaining to your chosen mechanism.
+know that you probably won't be needing this for the client-to-bouncer
+connection.
+
+When you're ready to get started, add @code{sasl} to
+@code{erc-modules}, like you would any other module.  If unsure which
+@dfn{mechanism} to choose, stick with the default of @samp{PLAIN}.
+Then try @kbd{C-u M-x erc-tls @key{RET}}, and give your account name
+for the @samp{user} parameter and your account password for the
+@samp{server password}.
 
 @defopt erc-sasl-mechanism
 The name of an SASL subprotocol type as a @emph{lowercase} symbol.