[16315] Improve XML documentation section

code/XMLTester.xml

@@ -1272,9 +1272,23 @@
 <!-->XML-GENERIC<-->
 <struct name="primitive_types_example">
     <!-- Primitive type definitions inside a struct -->
-    <member name="my_long" type="int64"/>
     <member name="my_bool" type="boolean"/>
+    <member name="my_char" type="char8"/>
+    <member name="my_wchar" type="char16"/>
+    <member name="my_byte" type="byte"/>
+    <member name="my_octet" type="octet"/>
+    <member name="my_uint8" type="uint8"/>
+    <member name="my_short" type="int16"/>
+    <member name="my_long" type="int32"/>
+    <member name="my_unsignedshort" type="uint16"/>
+    <member name="my_unsignedlong" type="uint32"/>
+    <member name="my_longlong" type="int64"/>
+    <member name="my_unsignedlonglong" type="uint64"/>
+    <member name="my_float" type="float32"/>
+    <member name="my_double" type="float64"/>
+    <member name="my_longdouble" type="float128"/>
     <member name="my_string" type="string"/>
+    <member name="my_wstring" type="wstring"/>
 </struct>
 <!--><-->
 <struct name="MembersExample">

code/XMLTesterExample.xml

@@ -756,6 +756,42 @@
             </enum>
         </type>
         <type>
+            <!-- All possible members struct type -->
+            <struct name="MyFullStruct">
+                <!-- Primitives & basic -->
+                <member name="my_bool" type="boolean"/>
+                <member name="my_char" type="char8"/>
+                <member name="my_wchar" type="char16"/>
+                <member name="my_byte" type="byte"/>
+                <member name="my_octet" type="octet"/>
+                <member name="my_uint8" type="uint8"/>
+                <member name="my_short" type="int16"/>
+                <member name="my_long" type="int32"/>
+                <member name="my_unsignedshort" type="uint16"/>
+                <member name="my_unsignedlong" type="uint32"/>
+                <member name="my_longlong" type="int64"/>
+                <member name="my_unsignedlonglong" type="uint64"/>
+                <member name="my_float" type="float32"/>
+                <member name="my_double" type="float64"/>
+                <member name="my_longdouble" type="float128"/>
+                <member name="my_string" type="string"/>
+                <member name="my_wstring" type="wstring"/>
+
+                <!-- string my_boundedString[41925] -->
+                <member name="my_boundedString" type="string" stringMaxLength="41925"/>
+                <!-- wstring my_boundedWString[41925] -->
+                <member name="my_boundedWString" type="wstring" stringMaxLength="41925"/>
+
+                <!-- long long_array[2][3][4]; -->
+                <member name="long_array" arrayDimensions="2,3,4" type="int32"/>
+
+                <!-- map<long,map<long,long,2>,2> my_map_map; -->
+                <member name="my_map_map" type="nonBasic" nonBasicTypeName="my_map_inner" key_type="int32" mapMaxLength="2"/>
+
+                <!-- Complex types -->
+                <member name="my_other_struct" type="nonBasic" nonBasicTypeName="OtherStruct"/>
+            </struct>
+
             <enum name="MyEnum">
                 <enumerator name="A" value="0"/>
                 <enumerator name="B" value="1"/>
@@ -806,36 +842,6 @@
                 </case>
             </union>
 
-            <!-- All possible members struct type -->
-            <struct name="MyFullStruct">
-                <!-- Primitives & basic -->
-                <member name="my_bool" type="boolean"/>
-                <member name="my_byte" type="byte"/>
-                <member name="my_char" type="char8"/>
-                <member name="my_wchar" type="char16"/>
-                <member name="my_short" type="int16"/>
-                <member name="my_long" type="int32"/>
-                <member name="my_longlong" type="int64"/>
-                <member name="my_unsignedshort" type="uint16"/>
-                <member name="my_unsignedlong" type="uint32"/>
-                <member name="my_unsignedlonglong" type="uint64"/>
-                <member name="my_float" type="float32"/>
-                <member name="my_double" type="float64"/>
-                <member name="my_longdouble" type="float128"/>
-                <member name="my_string" type="string"/>
-                <member name="my_wstring" type="wstring"/>
-                <member name="my_boundedString" type="string" stringMaxLength="41925"/>
-                <member name="my_boundedWString" type="wstring" stringMaxLength="41925"/>
-
-                <!-- long long_array[2][3][4]; -->
-                <member name="long_array" arrayDimensions="2,3,4" type="int32"/>
-
-                <!-- map<long,map<long,long,2>,2> my_map_map; -->
-                <member name="my_map_map" type="nonBasic" nonBasicTypeName="my_map_inner" key_type="int32" mapMaxLength="2"/>
-
-                <!-- Complex types -->
-                <member name="my_other_struct" type="nonBasic" nonBasicTypeName="OtherStruct"/>
-            </struct>
         </type>
     </types>
 </dds>

docs/fastdds/xml_configuration/dynamic_types.rst

@@ -38,21 +38,102 @@ Below, the types supported by *Fast DDS* are presented .
 For further information about the supported |DynamicTypes|, please, refer to :ref:`dynamictypes_supportedtypes`.
 For each of the types detailed below, an example of how to build the type's XML profile is provided.
 
-*   `Enum`_
-*   `Typedef`_
-*   `Struct`_
-*   `Union`_
-*   `Bitset`_
-*   `Bitmask`_
 *   `Member types`_
 
     -  `Primitive types`_
     -  `Arrays`_
     -  `Sequences`_
     -  `Maps`_
 
+*   `Enum`_
+*   `Typedef`_
+*   `Struct`_
+*   `Union`_
+*   `Bitset`_
+*   `Bitmask`_
 *   `Complex types`_
 
+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.
+
+Primitive types
+***************
+
+The identifiers of the available basic types are listed in the table below.
+Please, refer to :ref:`dynamictypes_supportedtypes_primitive` for more information on the primitive types.
+
+.. list-table::
+
+  * - ``boolean``
+    - ``char8``
+    - ``char16``
+  * - ``byte``
+    - ``octet``
+    - ``uint8``
+  * - ``int8``
+    - ``int16``
+    - ``int32``
+  * - ``uint16``
+    - ``uint32``
+    - ``int64``
+  * - ``uint64``
+    - ``float32``
+    - ``float64``
+  * - ``float128``
+    - ``string``
+    - ``wstring``
+
+All of them are defined as follows:
+
+.. literalinclude:: /../code/XMLTester.xml
+  :language: xml
+  :start-after: <!-->XML-GENERIC<-->
+  :end-before: <!--><-->
+
+Arrays
+******
+
+Arrays are defined in the same way as any other member type but they add the attribute ``arrayDimensions``.
+The format of the ``arrayDimensions`` attribute value is the size of each dimension separated by commas.
+Please, refer to :ref:`dynamictypes_supportedtypes_array` explanation for more information on array type.
+
+.. literalinclude:: /../code/XMLTester.xml
+  :language: xml
+  :start-after: <!-->XML-ARRAYS<-->
+  :end-before: <!--><-->
+
+Sequences
+*********
+
+The sequence type is implemented by setting three attributes: ``name``, the ``type``, and the
+``sequenceMaxLength``.
+The type of its content should be defined by the ``type`` attribute.
+The following example shows the implementation of a sequence of maximum length equal to 3.
+In turn, this is a sequence of sequences of maximum length of 2 and contents of type ``int32``.
+Please, refer to :ref:`dynamictypes_supportedtypes_sequence` section for more information on sequence type.
+
+.. literalinclude:: /../code/XMLTester.xml
+  :language: xml
+  :start-after: <!-->XML-SEQUENCES<-->
+  :end-before: <!--><-->
+
+Maps
+****
+
+Maps are similar to sequences, but they need to define two content types.
+The ``key_type`` defines the type of the map key, while the ``type`` defines the map value type.
+Again, both types can be defined as attributes of a ``<typedef>`` element, or as a ``<member>`` child element of a
+``<struct>`` or ``<union>`` elements.
+See section :ref:`dynamictypes_supportedtypes_map` for more information on map type.
+
+.. literalinclude:: /../code/XMLTester.xml
+  :language: xml
+  :start-after: <!-->XML-MAPS<-->
+  :end-before: <!--><-->
 
 Enum
 """"
@@ -155,79 +236,6 @@ Please, refer to :ref:`dynamictypes_supportedtypes_bitmask` for more information
   :start-after: <!-->XML-BITMASK<-->
   :end-before: <!--><-->
 
-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.
-
-Primitive types
-***************
-
-The identifiers of the available basic types are listed in the table below.
-Please, refer to :ref:`dynamictypes_supportedtypes_primitive` for more information on the primitive types.
-
-+--------------------------------------+---------------------------------------+---------------------------------------+
-| ``bool``                             | ``int32_t``                           | ``float32``                           |
-+--------------------------------------+---------------------------------------+---------------------------------------+
-| ``byte``                             | ``int64_t``                           | ``float64``                           |
-+--------------------------------------+---------------------------------------+---------------------------------------+
-| ``char``                             | ``uint16_t``                          | ``float128``                          |
-+--------------------------------------+---------------------------------------+---------------------------------------+
-| ``wchar``                            | ``uint32_t``                          | ``string``                            |
-+--------------------------------------+---------------------------------------+---------------------------------------+
-| ``int16_t``                          | ``uint64_t``                          | ``wstring``                           |
-+--------------------------------------+---------------------------------------+---------------------------------------+
-
-All of them are defined as follows:
-
-.. literalinclude:: /../code/XMLTester.xml
-  :language: xml
-  :start-after: <!-->XML-GENERIC<-->
-  :end-before: <!--><-->
-
-Arrays
-******
-
-Arrays are defined in the same way as any other member type but they add the attribute ``arrayDimensions``.
-The format of the ``arrayDimensions`` attribute value is the size of each dimension separated by commas.
-Please, refer to :ref:`dynamictypes_supportedtypes_array` explanation for more information on array type.
-
-.. literalinclude:: /../code/XMLTester.xml
-  :language: xml
-  :start-after: <!-->XML-ARRAYS<-->
-  :end-before: <!--><-->
-
-Sequences
-*********
-
-The sequence type is implemented by setting three attributes: ``name``, the ``type``, and the
-``sequenceMaxLength``.
-The type of its content should be defined by the ``type`` attribute.
-The following example shows the implementation of a sequence of maximum length equal to 3.
-In turn, this is a sequence of sequences of maximum length of 2 and contents of type ``int32``.
-Please, refer to :ref:`dynamictypes_supportedtypes_sequence` section for more information on sequence type.
-
-.. literalinclude:: /../code/XMLTester.xml
-  :language: xml
-  :start-after: <!-->XML-SEQUENCES<-->
-  :end-before: <!--><-->
-
-Maps
-****
-
-Maps are similar to sequences, but they need to define two content types.
-The ``key_type`` defines the type of the map key, while the ``type`` defines the map value type.
-Again, both types can be defined as attributes of a ``<typedef>`` element, or as a ``<member>`` child element of a
-``<struct>`` or ``<union>`` elements.
-See section :ref:`dynamictypes_supportedtypes_map` for more information on map type.
-
-.. literalinclude:: /../code/XMLTester.xml
-  :language: xml
-  :start-after: <!-->XML-MAPS<-->
-  :end-before: <!--><-->
-
 Complex types
 """""""""""""
 
@@ -260,14 +268,15 @@ these attributes are then defined in the following table.
         - Name of the complex type. Only applies if the ``type`` attribute is set to ``nonBasic``.
     *   - ``arrayDimensions``
         - Dimensions of an array.
+    *   - ``stringMaxLength``
+        - Maximum length of a string.
     *   - ``sequenceMaxLength``
         - Maximum length of a `Sequences`_.
     *   - ``mapMaxLength``
         - Maximum length of a `Maps`_.
     *   - ``key_type``
         - Data type of a map key.
 
-
 .. _Usage:
 
 Loading dynamic types in a *Fast DDS* application