Fixed various typos and unified some formats in documentation (#996)

* Fix links in docu

Signed-off-by: Juanjo Garcia <juanjosegarciaesteban@gmail.com>

* Fix Typo

Signed-off-by: Juanjo Garcia <juanjosegarcia@eprosima.com>

* Unified the QOS_DEFAULT format in text

Signed-off-by: Juanjo Garcia <juanjosegarcia@eprosima.com>

* Fix Typo

Signed-off-by: Juanjo Garcia <juanjosegarcia@eprosima.com>

* Fixed a typo

Signed-off-by: Juanjo Garcia <juanjosegarcia@eprosima.com>

* Modified length of a line

Signed-off-by: Juanjo Garcia <juanjosegarcia@eprosima.com>

---------

Signed-off-by: Juanjo Garcia <juanjosegarciaesteban@gmail.com>
Signed-off-by: Juanjo Garcia <juanjosegarcia@eprosima.com>

Author: juanjo4936

docs/fastdds/dds_layer/core/status/status.rst

@@ -230,7 +230,7 @@ List of status data members:
 * |LivelinessChangedStatus::last_publication_handle-api|:
   Handle to the last DataWriter
   whose liveliness status was changed.
-  If no liveliness has ever changed, it will have value ``c_InstanceHandle_Unknown``.
+  If no liveliness has ever changed, it will have value |c_InstanceHandle_Unknown-api|.
 
 
 .. _dds_layer_core_status_requestedDeadlineMissedStatus:
@@ -268,7 +268,7 @@ List of status data members:
 
 * |DeadlineMissedStatus::last_instance_handle-api|:
   Handle to the last instance that missed the deadline.
-  If no deadline was ever missed, it will have value ``c_InstanceHandle_Unknown``.
+  If no deadline was ever missed, it will have value |c_InstanceHandle_Unknown-api|.
 
 .. _dds_layer_core_status_requestedIncompatibleQosStatus:
 
@@ -428,7 +428,7 @@ List of status data members:
 
 * |SampleRejectedStatus::last_instance_handle-api|:
   Handle to the last instance whose sample was rejected.
-  If no sample was ever rejected, it will have value ``c_InstanceHandle_Unknown``.
+  If no sample was ever rejected, it will have value |c_InstanceHandle_Unknown-api|.
 
 .. _dds_layer_core_status_sampleRejectedStatusKind:
 

docs/fastdds/dds_layer/domain/domainParticipant/createDomainParticipant.rst

@@ -18,7 +18,7 @@ Mandatory arguments are:
  * The |DomainId-api| that identifies the domain where the DomainParticipant will be created.
 
  * The :ref:`dds_layer_domainParticipantQos` describing the behavior of the DomainParticipant.
-   If the provided value is :class:`TOPIC_QOS_DEFAULT`, the value of the DomainParticipantQos is used.
+   If the provided value is :class:`PARTICIPANT_QOS_DEFAULT`, the value of the DomainParticipantQos is used.
 
 Alternatively, instead of the two mandatory arguments above, you can use:
 

docs/fastdds/dds_layer/domain/domainParticipant/domainParticipant.rst

@@ -117,7 +117,7 @@ Default DomainParticipantQos
 The default DomainParticipantQos refers to the value returned by the
 |DomainParticipantFactory::get_default_participant_qos-api| member function on the
 :ref:`dds_layer_domainParticipantFactory` singleton.
-The special value ``PARTICIPANT_QOS_DEFAULT`` can be used as QoS argument on
+The special value :code:`PARTICIPANT_QOS_DEFAULT` can be used as QoS argument on
 |DomainParticipantFactory::create_participant-api|
 or |DomainParticipant::set_qos-api| member functions to indicate that the current default
 DomainParticipantQos should be used.
@@ -137,7 +137,7 @@ DomainParticipant instances.
    :dedent: 8
 
 |DomainParticipantFactory::set_default_participant_qos-api|
-member function also accepts the value ``PARTICIPANT_QOS_DEFAULT``
+member function also accepts the value :code:`PARTICIPANT_QOS_DEFAULT`
 as input argument.
 This will reset the current default DomainParticipantQos to the default constructed value
 |DomainParticipantQos::DomainParticipantQos-api|.
@@ -149,7 +149,7 @@ This will reset the current default DomainParticipantQos to the default construc
    :dedent: 8
 
 .. note::
-   The value ``PARTICIPANT_QOS_DEFAULT`` has different meaning depending on where it is used:
+   The value :code:`PARTICIPANT_QOS_DEFAULT` has different meaning depending on where it is used:
 
    * On |DomainParticipantFactory::create_participant-api| and |DomainParticipant::set_qos-api| it refers to the
      default DomainParticipantQos as returned by |DomainParticipantFactory::get_default_participant_qos-api|.

docs/fastdds/dds_layer/publisher/dataWriter/createDataWriter.rst

@@ -15,9 +15,9 @@ Mandatory arguments are:
  * A :ref:`dds_layer_topic_topic` bound to the data type that will be transmitted.
 
  * The :ref:`dds_layer_publisher_dataWriterQos` describing the behavior of the DataWriter.
-   If the provided value is :class:`DATAWRITER_QOS_DEFAULT`,
+   If the provided value is :code:`DATAWRITER_QOS_DEFAULT`,
    the value of the :ref:`dds_layer_defaultDataWriterQos` is used.
-   If the provided value is :class:`DATAWRITER_QOS_USE_TOPIC_QOS`,
+   If the provided value is :code:`DATAWRITER_QOS_USE_TOPIC_QOS`,
    the values of the default QoS and the provided TopicQoS are used, whereby any policy
    that is set on the TopicQoS overrides the corresponding policy on the default QoS.
 

docs/fastdds/dds_layer/publisher/dataWriter/dataWriter.rst

@@ -91,7 +91,7 @@ default values.
 .. note::
 
    Reliability kind (whether the publication is reliable or best effort) is not mutable.
-   However, the ``max_blocking_time`` data member of |ReliabilityQosPolicy| can be modified any time.
+   However, the :code:`max_blocking_time` data member of |ReliabilityQosPolicy| can be modified any time.
 .. note::
 
    Not all data members of RTPSReliableWriterQos are mutable, please refer to |RTPSReliableWriterQos|
@@ -114,7 +114,7 @@ Default DataWriterQos
 
 The default :ref:`dds_layer_publisher_dataWriterQos` refers to the value returned by the
 |Publisher::get_default_datawriter_qos-api| member function on the Publisher instance.
-The special value :class:`DATAWRITER_QOS_DEFAULT` can be used as QoS argument on |Publisher::create_datawriter-api|
+The special value :code:`DATAWRITER_QOS_DEFAULT` can be used as QoS argument on |Publisher::create_datawriter-api|
 or |DataWriter::set_qos-api| member functions to indicate that the current default
 DataWriterQos should be used.
 
@@ -131,8 +131,8 @@ DataWriter instances.
    :end-before: //!
    :dedent: 8
 
-|Publisher::set_default_datawriter_qos-api| member function also accepts the special value ``DATAWRITER_QOS_DEFAULT``
-as input argument.
+|Publisher::set_default_datawriter_qos-api| member function also accepts the special value
+:code:`DATAWRITER_QOS_DEFAULT` as input argument.
 This will reset the current default DataWriterQos to default constructed
 value |DataWriterQos::DataWriterQos-api|.
 
@@ -143,7 +143,7 @@ value |DataWriterQos::DataWriterQos-api|.
    :dedent: 8
 
 .. note::
-   The value ``DATAWRITER_QOS_DEFAULT`` has different meaning depending on where it is used:
+   The value :code:`DATAWRITER_QOS_DEFAULT` has different meaning depending on where it is used:
 
    * On |Publisher::create_datawriter-api| and |DataWriter::set_qos-api| it refers to the default DataWriterQos
      as returned by |Publisher::get_default_datawriter_qos-api|.

docs/fastdds/dds_layer/publisher/publisher/createPublisher.rst

@@ -13,7 +13,7 @@ DomainParticipant instance, that acts as a factory for the Publisher.
 Mandatory arguments are:
 
  * The :ref:`dds_layer_publisher_publisherQos` describing the behavior of the Publisher.
-   If the provided value is :class:`PUBLISHER_QOS_DEFAULT`,
+   If the provided value is :code:`PUBLISHER_QOS_DEFAULT`,
    the value of the :ref:`dds_layer_defaultPublisherQos` is used.
 
 Optional arguments are:

docs/fastdds/dds_layer/publisher/publisher/publisher.rst

@@ -58,7 +58,7 @@ Default PublisherQos
 
 The default :ref:`dds_layer_publisher_publisherQos` refers to the value returned by the
 |DomainParticipant::get_default_publisher_qos-api| member function on the DomainParticipant instance.
-The special value :class:`PUBLISHER_QOS_DEFAULT` can be used as QoS argument on
+The special value :code:`PUBLISHER_QOS_DEFAULT` can be used as QoS argument on
 |DomainParticipant::create_publisher-api| or |Publisher::set_qos-api| member functions to indicate that the current
 default PublisherQos should be used.
 
@@ -76,7 +76,7 @@ Modifying the default PublisherQos will not affect already existing
    :dedent: 8
 
 |DomainParticipant::set_default_publisher_qos-api| member function also accepts the special value
-``PUBLISHER_QOS_DEFAULT`` as input argument.
+:code:`PUBLISHER_QOS_DEFAULT` as input argument.
 This will reset the current default PublisherQos to default constructed
 value |PublisherQos::PublisherQos-api|.
 
@@ -87,7 +87,7 @@ value |PublisherQos::PublisherQos-api|.
    :dedent: 8
 
 .. note::
-   The value ``PUBLISHER_QOS_DEFAULT`` has different meaning depending on where it is used:
+   The value :code:`PUBLISHER_QOS_DEFAULT` has different meaning depending on where it is used:
 
    * On |DomainParticipant::create_publisher-api| and |Publisher::set_qos-api| it refers to the default
      :ref:`dds_layer_publisher_publisherQos`.

docs/fastdds/dds_layer/subscriber/dataReader/createDataReader.rst

@@ -15,9 +15,9 @@ Mandatory arguments are:
  * A :ref:`dds_layer_topic_topic` bound to the data type that will be transmitted.
 
  * The :ref:`dds_layer_subscriber_dataReaderQos` describing the behavior of the DataReader.
-   If the provided value is :class:`DATAREADER_QOS_DEFAULT`,
+   If the provided value is :code:`DATAREADER_QOS_DEFAULT`,
    the value of the :ref:`dds_layer_defaultDataReaderQos` is used.
-   If the provided value is :class:`DATAREADER_QOS_USE_TOPIC_QOS`,
+   If the provided value is :code:`DATAREADER_QOS_USE_TOPIC_QOS`,
    the values of the default QoS and the provided TopicQoS are used, whereby any policy
    that is set on the TopicQoS overrides the corresponding policy on the default QoS.
 

docs/fastdds/dds_layer/subscriber/dataReader/dataReader.rst

@@ -120,7 +120,7 @@ Default DataReaderQos
 The default DataReaderQos refers to the value returned by the
 |Subscriber::get_default_datareader_qos-api| member function on the
 :ref:`dds_layer_subscriber_subscriber` instance.
-The special value ``DATAREADER_QOS_DEFAULT`` can be used as QoS argument on
+The special value :code:`DATAREADER_QOS_DEFAULT` can be used as QoS argument on
 |Subscriber::create_datareader-api| or
 |DataReader::set_qos-api| member functions to indicate that the current default
 DataReaderQos should be used.
@@ -140,7 +140,7 @@ Modifying the default DataReaderQos will not affect already existing
    :dedent: 8
 
 |Subscriber::set_default_datareader_qos-api| member function also accepts
-the special value ``DATAREADER_QOS_DEFAULT`` as input argument.
+the special value :code:`DATAREADER_QOS_DEFAULT` as input argument.
 This will reset the current default DataReaderQos to default constructed
 value |DataReaderQos::DataReaderQos-api|.
 
@@ -151,7 +151,7 @@ value |DataReaderQos::DataReaderQos-api|.
    :dedent: 8
 
 .. note::
-   The value ``DATAREADER_QOS_DEFAULT`` has different meaning depending on where it is used:
+   The value :code:`DATAREADER_QOS_DEFAULT` has different meaning depending on where it is used:
 
    * On |Subscriber::create_datareader-api|
      and |DataReader::set_qos-api| it refers to the default

docs/fastdds/dds_layer/subscriber/sampleInfo/sampleInfo.rst

@@ -8,7 +8,7 @@ SampleInfo
 
 When a sample is retrieved from the :ref:`dds_layer_subscriber_dataReader`, in addition to the sample data,
 a |SampleInfo-api| instance is returned.
-This object contains additional information that complements the returned data value and helps on it interpretation.
+This object contains additional information that complements the returned data value and helps on its interpretation.
 For example, if the :ref:`dds_layer_subscriber_sampleInfo_validdata` value is ``false``, the
 DataReader is not informing the application about a new value in the data instance,
 but a change on its status, and the returned data value must be discarded.