]> git.eshelyaron.com Git - emacs.git/commitdiff
; doc/misc/erc.texi: Improve SASL intro.
authorF. Jason Park <jp@neverwas.me>
Sat, 6 Jan 2024 21:32:42 +0000 (13:32 -0800)
committerF. Jason Park <jp@neverwas.me>
Sun, 7 Jan 2024 23:11:26 +0000 (15:11 -0800)
doc/misc/erc.texi

index 7fbe6f9766e0a6371e1158896fa0e6d2705a7293..52c7477c9dd8136c6e1a207db1ae6d1835f4a121 100644 (file)
@@ -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.