From 67208fb87ea523c205f33b0a52fcfc66df6f32a6 Mon Sep 17 00:00:00 2001 From: Goffi Date: Tue, 3 Dec 2024 00:53:18 +0100 Subject: [PATCH] doc (components): Update Email Gateway documentation: A section has been added to explain how attachments are handled. fix 453 --- doc/components.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/components.rst b/doc/components.rst index f33b20fa..36d3b5fe 100644 --- a/doc/components.rst +++ b/doc/components.rst @@ -956,8 +956,23 @@ Some headers are converted between XMPP and email, such as the ``Keywords`` or t used. +Attachment Management +~~~~~~~~~~~~~~~~~~~~~ + +Email attachments are downloaded and stored by the gateway. Attachments can be managed +individually, independent of the email message itself. They can be retrieved and deleted +from the gateway (using `XEP-0498 (PubSub File Sharing)`_). + +.. note:: + + **Current Limitation:** Attachments are partially handled; while they can be retrieved + and deleted, they are not yet sent with the message. This functionality will be added + as development progresses. + + .. _XEP-0033 (Extended Stanza Addressing): https://xmpp.org/extensions/xep-0033.html .. _XEP-0100 (Gateway Interaction): https://xmpp.org/extensions/xep-0100.html .. _XEP-0106 (JID Escaping): https://xmpp.org/extensions/xep-0106.html .. _XEP-0131 (Stanza Headers and Internet Metadata): https://xmpp.org/extensions/xep-0131.html +.. _XEP-0498 (Pubsub File Sharing): https://xmpp.org/extensions/xep-0498.html