From e1259b6581513a221cf1cdb15ccce2a1e888d40e Mon Sep 17 00:00:00 2001
From: trinity-1686a <trinity@deuxfleurs.fr>
Date: Tue, 7 May 2024 23:24:23 +0200
Subject: [PATCH] complete matrix documentation

---
 howto/irc.md | 29 +++++++++++++++++++----------
 1 file changed, 19 insertions(+), 10 deletions(-)

diff --git a/howto/irc.md b/howto/irc.md
index 532508b2..3d7a7a32 100644
--- a/howto/irc.md
+++ b/howto/irc.md
@@ -107,20 +107,29 @@ You can list group members with:
 Since mid-April 2021, many `#tor-*` channels are bridged (or
 "[plumbed](https://matrix.org/bridges/)") between the [OFTC IRC network](https://oftc.net) and the
 [Matrix.org](https://matrix.org/) home server. This is still somewhat of an experimental
-status, but so far it seems to be working well.
-
-By default, you will appear on IRC as a user like "YourMatrixName \[m\]".
-You can override this by sending `!nick <yournick>` to "OFTC IRC Bridge
-status". If your nick is registered, you will get a PM from NickServ stating
+status, but so far it seems to be working well. These channel are listed in
+[#tor-space](https://matrix.to/#/#tor-space:matrix.org).
+
+By default, you will appear on IRC as a user like "YourMatrixName\[m\]".
+You can override this by sending `!nick <yournick>` to
+[@oftc-irc:matrix.org](https://matrix.to/#/@oftc-irc:matrix.org).
+If your nick is registered, you will get a PM from
+[NickServ](https://matrix.to/#/@_oftc_NickServ:matrix.org) stating
 that you need to authenticate. Do so by responding with `identify
-\<yourpassword\>`.
+\<yourpassword\>`. If your nick isn't registed, you should consider doing so.
+You can do it by sending `register <password> <e-mail>` to
+[NickServ](https://matrix.to/#/@_oftc_NickServ:matrix.org), and following
+the instructions.
 
 Also note that you can join *any* channel on bridged IRC networks (Freenode and
 OFTC) through the [Portal rooms](https://matrix.org/bridges/) functionality.
-For example, `#freenode_#channelname:matrix.org` corresponds to `#channelname`
-on Freenode. This is the only supported way to access Tor's internal channels
-through Matrix (you will need to set your nick first; see above). To join a portal room, send
-`!join #channel \<channel password\>` to "OFTC IRC Bridge status".
+For example, `#_oftc_#channelname:matrix.org` corresponds to `#channelname`
+on OFTC. This is the only supported way to access Tor's internal channels
+through Matrix (you will need to register and identify your nick first; see
+above). To join a portal room, send `!join #channel \<channel password\>` to
+@oftc-irc:matrix.org. You may get kicked of internal channels seemingly at
+random when the bridge restart. You'll then have to re-authenticate to NickServ,
+and send a `!join` command again.
 
 For more information see the general [Matrix bridge
 documentation](https://matrix.org/bridges/) and the [IRC bridge
-- 
GitLab