Docs - Apply custom templates to included IDL files (#1066)

* Refs #23150: Apply custom templates to included IDL files

Signed-off-by: cferreiragonz <carlosferreira@eprosima.com>

* Refs #23150: Apply suggestion

Signed-off-by: cferreiragonz <carlosferreira@eprosima.com>

---------

Signed-off-by: cferreiragonz <carlosferreira@eprosima.com>
(cherry picked from commit bf0dfe6)

# Conflicts:
#	code/FastDDSGenCodeTester.cpp
#	docs/fastddsgen/dataTypes/dataTypes.rst

Author: cferreiragonz

code/FastDDSGenCodeTester.cpp

@@ -133,8 +133,17 @@ enum MyBitMask : uint8_t
 //!
 
 /*
+<<<<<<< HEAD
 // INCLUDE_MORE_IDL_FILES
 #include "OtherFile.idl"
 #include <AnotherFile.idl>
 //!
 /**/
+=======
+   // INCLUDE_MORE_IDL_FILES
+ #include "OtherFile.idl"
+ #include <AnotherFile.idl>
+ #include <IncludedIDL.idl>
+   //!
+   /**/
+>>>>>>> bf0dfe6 (Docs - Apply custom templates to included IDL files (#1066))

docs/fastddsgen/dataTypes/dataTypes.rst

@@ -373,6 +373,25 @@ If *Fast DDS-Gen* does not find a C/C++ preprocessor in default system paths, th
 using parameter ``-ppPath``.
 The parameter ``-ppDisable`` can be used to disable the usage of the C/C++ preprocessor.
 
+<<<<<<< HEAD
+=======
+The parameter ``-extrastg`` can also be used to apply custom templates to included IDL files.
+To enable this feature, the output file name passed to ``-extrastg`` must include the character ``@``, which will be
+replaced by the name of the included file to generate the output file.
+
+The following command will generate two custom templates, one for the main IDL file and another for the included one:
+
+- ``MainIDL_Custom.cpp``
+- ``IncludedIDL_Custom.cpp``
+
+Where ``IncludedIDL.idl`` is included in ``MainIDL.idl`` file.
+
+.. code-block:: bash
+
+    <path/to/Fast DDS-Gen>/scripts/fastddsgen MainIDL.idl -I <path/to/idls> -extrastg <path/to/template>/Custom.stg @_Custom.cpp
+
+Check :ref:`fastddsgen_supported_options` for more information about the ``-extrastg`` option.
+>>>>>>> bf0dfe6 (Docs - Apply custom templates to included IDL files (#1066))
 
 Annotations
 --------------