diff options
| -rw-r--r-- | doc/biboumi.1.rst | 23 |
1 files changed, 19 insertions, 4 deletions
diff --git a/doc/biboumi.1.rst b/doc/biboumi.1.rst index 8463ed1..cf54ac0 100644 --- a/doc/biboumi.1.rst +++ b/doc/biboumi.1.rst @@ -297,10 +297,25 @@ IRC users’. History ------- -Public channel messages are saved into the database, unless the -`record_history` option is set to false for that user -`Ad-hoc commands`). When a channel is joined, biboumi sends the -`max_history_length` messages found in the database, as the MUC history. +Public channel messages are saved into archives, inside the database, unless +the `record_history` option is set to false for that user `Ad-hoc commands`. +Private messages (messages that are sent directly to a nickname, not a +channel) are never stored in the database. When a channel is joined, biboumi +sends the `max_history_length` messages found in the database as the MUC +history. + +A channel history can be retrieved by using `Message archive management (MAM) +<https://xmpp.org/extensions/xep-0313.htm>`_ on the channel JID. The results +can be filtered by start and end dates. + +For a given channel, each user has her or his own archive. The content of +the archives are never shared, and thus a user can not use someone else’s +archive to get the messages that they didn’t receive when they were offline. +Although this feature would be very convenient, this would introduce a very +important privacy issue: for example if a biboumi gateway is used by two +users, by querying the archive one user would be able to know whether or not +the other user was in a room at a given time. + List channels ------------- |