From 5511bb8d26eb6404a0820b5fc920f0f890368ced Mon Sep 17 00:00:00 2001
From: Eduardo Ponz Segrelles <eduardoponz@eprosima.com>
Date: Tue, 30 Apr 2024 07:53:18 +0200
Subject: [PATCH] Document how to annotate member as key in XMl types (#746)

Signed-off-by: eduponz <eduardoponz@eprosima.com>
(cherry picked from commit f95e5c960f5ac57e53b7f2bafb85292f2ba25333)
---
 code/XMLTester.xml                               | 3 +++
 docs/fastdds/xml_configuration/dynamic_types.rst | 6 ++++++
 2 files changed, 9 insertions(+)

diff --git a/code/XMLTester.xml b/code/XMLTester.xml
index 3c2295d9b..d61808a7c 100644
--- a/code/XMLTester.xml
+++ b/code/XMLTester.xml
@@ -4250,6 +4250,9 @@
 </struct>
 <!--><-->
 <struct name="MembersExample">
+<!-->XML-MEMBER_WITH_KEY<-->
+<member name="my_long" type="int32" key="true"/>
+<!--><-->
 <!-->XML-BOUNDEDSTRINGS<-->
 <member name="my_large_string" type="string" stringMaxLength="41925"/>
 <member name="my_large_wstring" type="wstring" stringMaxLength="20925"/>
diff --git a/docs/fastdds/xml_configuration/dynamic_types.rst b/docs/fastdds/xml_configuration/dynamic_types.rst
index 2732f0752..df1cc6f4e 100644
--- a/docs/fastdds/xml_configuration/dynamic_types.rst
+++ b/docs/fastdds/xml_configuration/dynamic_types.rst
@@ -60,6 +60,12 @@ Member types
 Member types are defined as any type that can belong to a `Struct`_ or a `Union`_, or be aliased by a
 `Typedef`_.
 These can be defined by the ``<member>`` XML tag.
+A member can be annotated as ``key`` (equivalent of the IDL's ``@key``) by setting the ``key`` attribute to ``"true"``.
+
+.. literalinclude:: /../code/XMLTester.xml
+  :language: xml
+  :start-after: <!-->XML-MEMBER_WITH_KEY<-->
+  :end-before: <!--><-->
 
 Primitive types
 ***************