# HG changeset patch
# User Goffi <goffi@goffi.org>
# Date 1751645490 -7200
# Node ID 691f6c8afb312cb012190727c6843e8e029b1508
# Parent  332822ceae85ccb594372dd3e9db149f139d4b16
doc (user/chat): Add `Forwarding Messages`, `Rich Editing Mode` and `Adding Extra Recipients` sections:

Document the new features.

rel 461

diff -r 332822ceae85 -r 691f6c8afb31 doc/user/chat.rst
--- a/doc/user/chat.rst	Fri Jul 04 17:47:37 2025 +0200
+++ b/doc/user/chat.rst	Fri Jul 04 18:11:30 2025 +0200
@@ -57,6 +57,17 @@
 thread. Clicking it opens a submessage panel containing all messages from that thread.
 Messages written in this panel will be posted as replies to the thread.
 
+Forwarding Messages
+-------------------
+To forward a message, use the context menu (3-dots icon) associated with any message
+
+1. Tap or click the **3-dots icon** next to the message you want to forward.
+2. Select **Forward** from the menu.
+3. A prompt will appear where you can enter the recipient's identifier (JID).
+4. Confirm the action to send the message to the specified entity.
+
+This feature allows you to share messages with users outside the current conversation.
+
 Keywords
 --------
 
@@ -75,3 +86,35 @@
 ActivityPub), a label will indicate its origin. Clicking this label displays a submessage
 panel showing only messages from this source. If a message was generated by a bot (i.e.,
 an automated program), a corresponding label will appear.
+
+Rich Editing Mode
+-----------------
+Libervia supports rich text formatting for messages, enabling you to apply text styles:
+
+1. Locate the **extra menu** (vertical 3-dots icon) next to the message input bar.
+2. Select **Switch to Rich Editing** from the menu.
+3. Use the formatting tools to apply styles like bold, italic, underline, etc.
+
+.. note::
+
+   While rich formatting enhances message presentation, not all XMPP clients support
+   styled messages. Recipients using incompatible clients will receive a plain text
+   version of your message. The core content remains intact regardless of formatting
+   compatibility.
+
+Adding Extra Recipients
+-----------------------
+You can specify additional recipients for a message using the "extra recipients" feature:
+
+1. Open the **extra menu** (vertical 3-dots icon) next to the message input bar.
+2. Select **Add Recipients** to display a dynamic field.
+3. Enter a recipient's JID and choose their delivery type from the dropdown:
+
+   - **To**: Primary recipient (visible to all recipients)
+   - **Cc**: Carbon Copy, secondary recipient (visible to all recipients)
+   - **Bcc**: Blind Carbon Copy (hidden from other recipients)
+
+ Pressing **Enter** after adding a recipient automatically creates a new field with the
+ same delivery type, allowing you to quickly add multiple recipients of the same category.
+
+