Add unsupported note to new ignore DomainPartListener callbacks (#3619)…

… (#3622) * Add unsupported note to new ignore DomainPartListener callbacks Signed-off-by: jparisu <javierparis@eprosima.com> * Change subscriber/publisher for DataReader/DataWriter Signed-off-by: jparisu <javierparis@eprosima.com> --------- Signed-off-by: jparisu <javierparis@eprosima.com> (cherry picked from commit cf46990) Co-authored-by: jparisu <69341543+jparisu@users.noreply.github.com>
eProsima · Jul 6, 2023 · d13c6da · d13c6da
1 parent 2f09f01
commit d13c6da
Showing 1 changed file with 18 additions and 14 deletions.
diff --git a/include/fastdds/dds/domain/DomainParticipantListener.hpp b/include/fastdds/dds/domain/DomainParticipantListener.hpp
@@ -113,11 +113,11 @@ class DomainParticipantListener :
 #endif // if HAVE_SECURITY
 
     /*!
-     * This method is called when a new Subscriber is discovered, or a previously discovered subscriber changes
+     * This method is called when a new DataReader is discovered, or a previously discovered DataReader changes
      * its QOS or is removed.
      *
-     * @param[out] participant Pointer to the Participant which discovered the remote subscriber.
-     * @param[out] info Remote subscriber information. User can take ownership of the object.
+     * @param[out] participant Pointer to the Participant which discovered the remote DataReader.
+     * @param[out] info Remote DataReader information. User can take ownership of the object.
      */
     virtual void on_subscriber_discovery(
             DomainParticipant* participant,
@@ -128,12 +128,14 @@ class DomainParticipantListener :
     }
 
     /*!
-     * This method is called when a new Subscriber is discovered, or a previously discovered subscriber changes
+     * This method is called when a new DataReader is discovered, or a previously discovered DataReader changes
      * its QOS or is removed.
      *
-     * @param[out] participant Pointer to the Participant which discovered the remote subscriber.
-     * @param[out] info Remote subscriber information. User can take ownership of the object.
-     * @param[out] should_be_ignored Flag to indicate the library to automatically ignore the discovered Participant.
+     * @warning Not Supported. This callback will never be called in the current version.
+     *
+     * @param[out] participant Pointer to the Participant which discovered the remote DataReader.
+     * @param[out] info Remote DataReader information. User can take ownership of the object.
+     * @param[out] should_be_ignored Flag to indicate the library to automatically ignore the discovered DataReader.
      */
     virtual void on_subscriber_discovery(
             DomainParticipant* participant,
@@ -146,11 +148,11 @@ class DomainParticipantListener :
     }
 
     /*!
-     * This method is called when a new Publisher is discovered, or a previously discovered publisher changes
+     * This method is called when a new DataWriter is discovered, or a previously discovered DataWriter changes
      * its QOS or is removed.
      *
-     * @param[out] participant Pointer to the Participant which discovered the remote publisher.
-     * @param[out] info Remote publisher information. User can take ownership of the object.
+     * @param[out] participant Pointer to the Participant which discovered the remote DataWriter.
+     * @param[out] info Remote DataWriter information. User can take ownership of the object.
      */
     virtual void on_publisher_discovery(
             DomainParticipant* participant,
@@ -161,12 +163,14 @@ class DomainParticipantListener :
     }
 
     /*!
-     * This method is called when a new Publisher is discovered, or a previously discovered publisher changes
+     * This method is called when a new DataWriter is discovered, or a previously discovered DataWriter changes
      * its QOS or is removed.
      *
-     * @param[out] participant Pointer to the Participant which discovered the remote publisher.
-     * @param[out] info Remote publisher information. User can take ownership of the object.
-     * @param[out] should_be_ignored Flag to indicate the library to automatically ignore the discovered Participant.
+     * @warning Not Supported. This callback will never be called in the current version.
+     *
+     * @param[out] participant Pointer to the Participant which discovered the remote DataWriter.
+     * @param[out] info Remote DataWriter information. User can take ownership of the object.
+     * @param[out] should_be_ignored Flag to indicate the library to automatically ignore the discovered DataWriter.
      */
     virtual void on_publisher_discovery(
             DomainParticipant* participant,