diff --git a/python/gui/auto_generated/attributetable/qgsifeatureselectionmanager.sip.in b/python/gui/auto_generated/attributetable/qgsifeatureselectionmanager.sip.in
index 639f3a84184..2fd7192a677 100644
--- a/python/gui/auto_generated/attributetable/qgsifeatureselectionmanager.sip.in
+++ b/python/gui/auto_generated/attributetable/qgsifeatureselectionmanager.sip.in
@@ -25,23 +25,17 @@ e.g. QgsVectorLayer implements this interface to manage its selections.
     QgsIFeatureSelectionManager( QObject *parent /TransferThis/ );
     virtual int selectedFeatureCount() = 0;
 %Docstring
-The number of features that are selected in this layer
-
-:return: See description
+Returns the number of features that are selected in this layer.
 %End
 
     virtual void select( const QgsFeatureIds &ids ) = 0;
 %Docstring
-Select features
-
-:param ids: Feature ids to select
+Select features by feature ``ids``.
 %End
 
     virtual void deselect( const QgsFeatureIds &ids ) = 0;
 %Docstring
-Deselect features
-
-:param ids: Feature ids to deselect
+Deselect features by feature ``ids``.
 %End
 
     virtual void setSelectedFeatures( const QgsFeatureIds &ids ) = 0;
diff --git a/src/gui/attributetable/qgsifeatureselectionmanager.h b/src/gui/attributetable/qgsifeatureselectionmanager.h
index 833d5c0af7d..1d48f2c6edd 100644
--- a/src/gui/attributetable/qgsifeatureselectionmanager.h
+++ b/src/gui/attributetable/qgsifeatureselectionmanager.h
@@ -38,23 +38,17 @@ class GUI_EXPORT QgsIFeatureSelectionManager : public QObject
       : QObject( parent ) {}
 
     /**
-     * The number of features that are selected in this layer
-     *
-     * \returns See description
+     * Returns the number of features that are selected in this layer.
      */
     virtual int selectedFeatureCount() = 0;
 
     /**
-     * Select features
-     *
-     * \param ids            Feature ids to select
+     * Select features by feature \a ids.
      */
     virtual void select( const QgsFeatureIds &ids ) = 0;
 
     /**
-     * Deselect features
-     *
-     * \param ids            Feature ids to deselect
+     * Deselect features by feature \a ids.
      */
     virtual void deselect( const QgsFeatureIds &ids ) = 0;
 
diff --git a/src/gui/attributetable/qgsvectorlayerselectionmanager.h b/src/gui/attributetable/qgsvectorlayerselectionmanager.h
index 88449dfde0f..8fcaec3bb8e 100644
--- a/src/gui/attributetable/qgsvectorlayerselectionmanager.h
+++ b/src/gui/attributetable/qgsvectorlayerselectionmanager.h
@@ -36,42 +36,10 @@ class GUI_EXPORT QgsVectorLayerSelectionManager : public QgsIFeatureSelectionMan
   public:
     explicit QgsVectorLayerSelectionManager( QgsVectorLayer *layer, QObject *parent = nullptr );
 
-    /**
-     * The number of features that are selected in this layer
-     *
-     * \returns See description
-     */
     int selectedFeatureCount() override;
-
-    /**
-     * Select features
-     *
-     * \param ids            Feature ids to select
-     */
     void select( const QgsFeatureIds &ids ) override;
-
-    /**
-     * Deselect features
-     *
-     * \param ids            Feature ids to deselect
-     */
     void deselect( const QgsFeatureIds &ids ) override;
-
-    /**
-     * Change selection to the new set of features. Dismisses the current selection.
-     * Will emit the selectionChanged( const QgsFeatureIds&, const QgsFeatureIds&, bool ) signal with the
-     * clearAndSelect flag set.
-     *
-     * \param ids   The ids which will be the new selection
-     */
     void setSelectedFeatures( const QgsFeatureIds &ids ) override;
-
-    /**
-     * Returns reference to identifiers of selected features
-     *
-     * \returns A list of QgsFeatureIds
-     * \see selectedFeatures()
-     */
     const QgsFeatureIds &selectedFeatureIds() const override;
 
   private: