Document the new affiliation/role stuff, and update changelog

2 files changed, 25 insertions, 0 deletions

diff --git a/CHANGELOG b/CHANGELOG
index a4fbf35..9e907b0 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -4,6 +4,9 @@ Version 2.0
    which users we previously sent a private message.  This improves the
    user experience when talking to NickServ.
  - Support joining key-protected channels
+ - Setting a participant's role/affiliation now results in a change of IRC
+   mode, instead of being ignored.  Setting Toto's affiliation to admin is
+   now equivalent to “/mode +o Toto”
 
 Version 1.1                                             2014-16-07
 
diff --git a/doc/biboumi.1.md b/doc/biboumi.1.md
index a35d4fc..18df220 100644
--- a/doc/biboumi.1.md
+++ b/doc/biboumi.1.md
@@ -294,6 +294,28 @@ between IRC modes and XMPP features is as follow:
 
   Sets the participant’s role to `participant` and its affiliation to `member`.
 
+Similarly, when a biboumi user changes some participant's affiliation or role, biboumi translates that in an IRC mode change.
+
+Affiliation set to `none`
+
+  Sets mode to -vhoaq
+
+Affiliation set to `member`
+
+  Sets mode to +v-hoaq
+
+Role set to `moderator`
+
+  Sets mode to +h-oaq
+
+Affiliation set to `admin`
+
+  Sets mode to +o-aq
+
+Affiliation set to `owner`
+
+  Sets mode to +a-q
+
 ### Ad-hoc commands
 
 Biboumi supports a few ad-hoc commands, as described in the XEP 0050.