summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorlouiz’ <louiz@louiz.org>2016-09-08 02:39:59 +0200
committerlouiz’ <louiz@louiz.org>2016-09-07 20:52:06 +0200
commit44bc04952c18df6971d06b3c1d9f020c97156fb4 (patch)
treed7272ca4637380c4ade4fae262fed338c2d7156c /doc
parent2c6132f3ee8d29cd733019b34b0e6b8740a1e3f9 (diff)
downloadbiboumi-44bc04952c18df6971d06b3c1d9f020c97156fb4.tar.gz
biboumi-44bc04952c18df6971d06b3c1d9f020c97156fb4.tar.bz2
biboumi-44bc04952c18df6971d06b3c1d9f020c97156fb4.tar.xz
biboumi-44bc04952c18df6971d06b3c1d9f020c97156fb4.zip
Improve the documentation for the archives
Diffstat (limited to 'doc')
-rw-r--r--doc/biboumi.1.rst23
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
-------------