Document how to annotate members as key in XML types (#757)

* Document how to annotate member as key in XMl types (#746) Signed-off-by: eduponz <eduardoponz@eprosima.com> (cherry picked from commit f95e5c9) # Conflicts: # code/XMLTester.xml * Refs #21244: Solve conflicts Signed-off-by: Mario Dominguez <mariodominguez@eprosima.com> --------- Signed-off-by: Mario Dominguez <mariodominguez@eprosima.com> Co-authored-by: Eduardo Ponz Segrelles <eduardoponz@eprosima.com> Co-authored-by: Mario Dominguez <mariodominguez@eprosima.com>
eProsima · Jun 27, 2024 · ac8f365 · ac8f365
1 parent 40f4548
commit ac8f365
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 0 deletions.
diff --git a/code/XMLTester.xml b/code/XMLTester.xml
@@ -1441,6 +1441,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"/>
 

diff --git a/docs/fastdds/xml_configuration/dynamic_types.rst b/docs/fastdds/xml_configuration/dynamic_types.rst
@@ -161,6 +161,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
 ***************