Clarify in the registerMapLayerPropertiesFactory docstring that the ownership of the factory is not transferred

Author: manisandro

python/gui/qgisinterface.sip

@@ -281,8 +281,9 @@ class QgisInterface : QObject
 
     /** Register a new tab in the vector layer properties dialog.
      * @note added in QGIS 2.16
-     * @see unregisterMapLayerPropertiesFactory()
-    */
+     * @note Ownership of the factory is not transferred, and the factory must
+     *       be unregistered when plugin is unloaded.
+     * @see unregisterMapLayerPropertiesFactory() */
     virtual void registerMapLayerPropertiesFactory( QgsMapLayerPropertiesFactory* factory ) = 0;
 
     /** Unregister a previously registered tab in the vector layer properties dialog.

src/app/qgisappinterface.h

@@ -290,8 +290,9 @@ class APP_EXPORT QgisAppInterface : public QgisInterface
 
     /** Register a new tab in the vector layer properties dialog.
      * @note added in QGIS 2.16
-     * @see unregisterMapLayerPropertiesFactory()
-    */
+     * @note Ownership of the factory is not transferred, and the factory must
+     *       be unregistered when plugin is unloaded.
+     * @see unregisterMapLayerPropertiesFactory() */
     virtual void registerMapLayerPropertiesFactory( QgsMapLayerPropertiesFactory* factory ) override;
 
     /** Unregister a previously registered tab in the vector layer properties dialog.

src/gui/qgisinterface.h

@@ -331,8 +331,9 @@ class GUI_EXPORT QgisInterface : public QObject
 
     /** Register a new tab in the vector layer properties dialog.
      * @note added in QGIS 2.16
-     * @see unregisterMapLayerPropertiesFactory()
-    */
+     * @note Ownership of the factory is not transferred, and the factory must
+     *       be unregistered when plugin is unloaded.
+     * @see unregisterMapLayerPropertiesFactory() */
     virtual void registerMapLayerPropertiesFactory( QgsMapLayerPropertiesFactory* factory ) = 0;
 
     /** Unregister a previously registered tab in the vector layer properties dialog.