diff doc/components.rst @ 4340:ea72364131d5 default tip @

doc (components): Update Email Gateway documentation: A section has been added to explain how attachments are handled. fix 453
author Goffi <goffi@goffi.org>
date Tue, 03 Dec 2024 00:53:18 +0100
parents ef29fa1d9d69
children
line wrap: on
line diff
--- a/doc/components.rst	Tue Dec 03 00:52:06 2024 +0100
+++ b/doc/components.rst	Tue Dec 03 00:53:18 2024 +0100
@@ -956,8 +956,23 @@
 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