Add support for a fixed_irc_server configuration

This option lets the administrator choose a specific IRC server, and only
that server can be used with this biboumi instance.

In this mode, JIDs to use are changed like this:

- #chan%irc.example.com@biboumi.example.com      -> #chan@biboumi.example.com
- user!irc.example.com@biboumi.example.com       -> user!@biboumi.example.com
- #chan%irc.example.com@biboumi.example.com/Nick -> #chan@biboumi.example.com/Nick
- %irc.example.com@biboumi.example.com           -> no equivalent
- irc.example.com@biboumi.example.com            -> no equivalent

1 files changed, 14 insertions, 0 deletions

diff --git a/doc/biboumi.1.md b/doc/biboumi.1.md
index 18df220..9e95139 100644
--- a/doc/biboumi.1.md
+++ b/doc/biboumi.1.md
@@ -59,6 +59,20 @@ The configuration file uses a simple format of the form
   privileges), for example some administration ad-hoc commands will only be
   available to that JID.
 
+`fixed_irc_server`
+
+  If this option contains the hostname of an IRC server (for example
+  irc.example.org), then biboumi will enforce the connexion to that IRC
+  server only.  This means that a JID like "#chan@irc.biboumi.org" must be
+  used instead of "#chan%irc.example.org@irc.biboumi.org".  In that mode,
+  the virtual channel (see *Connect to an IRC server*) is not available and
+  you still need to use the ! separator to send message to an IRC user (for
+  example "foo!@biboumi.example.com" to send a message to foo), although the
+  in-room JID still work as expected ("#channel@biboumi.example.com/Nick").
+  This option can for example be used by an administrator that just wants to
+  let their users join their own IRC server using an XMPP client, but
+  without letting them join any other IRC servers on the internet.
+
 `log_file`
 
   A filename into which logs are written.  If none is provided, the logs are