contrib/clients: Add information about emacs irc clients v1 APPLIED

Theodor Thornhill: 1
 contrib/clients: Add information about emacs irc clients

 1 files changed, 35 insertions(+), 0 deletions(-)

[PATCH] contrib/clients: Add information about emacs irc clients Export this patch

---
 contrib/clients.md | 35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

diff --git a/contrib/clients.md b/contrib/clients.md
index 3ffbbc6..b297008 100644
--- a/contrib/clients.md
+++ b/contrib/clients.md
@@ -39,9 +39,44 @@ On WeeChat 3.2-, no IRCv3 capabilities are enabled by default. To enable them:
 
 See `/help cap` for more information.
 
+# [Emacs]
+
+There are two clients provided with Emacs.  They require some setup to work
+properly.
+
+## Erc
+You need to explicitly set the username, which is the defcustom `erc-email-userid`.
+
+```elisp
+(setq erc-email-userid "username/irc.libera.chat") ;; Example with Libera.Chat
+(defun run-erc ()
+  (interactive)
+  (erc-tls :server "<server>"
+           :port "<port>"
+           :nick "<nick>"
+           :password "<password>"))
+```
+Now `M-x run-erc`
+
+
+## Rcirc
+The only thing needed here is the general config:
+
+```elisp
+(setq rcirc-server-alist
+      '(("<server>"
+         :port 6697
+         :encryption tls
+         :nick "<nick>"
+         :user-name "username/irc.libera.chat" ;; Example with Libera.Chat
+         :password "<password>")))
+```
+Now `M-x irc`
+
 [IRCv3 support tables]: https://ircv3.net/software/clients
 [gamja]: https://sr.ht/~emersion/gamja/
 [senpai]: https://sr.ht/~taiite/senpai/
 [Weechat]: https://weechat.org/
 [Weechat script]: https://github.com/weechat/scripts/blob/master/python/soju.py
 [Hexchat]: https://hexchat.github.io/
+[Emacs]: https://www.gnu.org/software/emacs/
-- 
2.30.2

Simon Ser <contact@emersion.fr>

6 months ago

Pushed with some minor edits, thanks!