---
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