fix leftover and missging SIP_THROW and better dox

3nids · 3nids · commit 0529d6077b26 · 2023-01-17T06:56:57.000+01:00
diff --git a/python/core/auto_generated/settings/qgssettings.sip.in b/python/core/auto_generated/settings/qgssettings.sip.in
@@ -66,7 +66,7 @@ static bool setGlobalSettingsPath( QString path );
     };
 
 
-    static QgsSettingsTreeElement *createPluginTreeElement( const QString &pluginName ) throw( QgsSettingsException );
+    static QgsSettingsTreeElement *createPluginTreeElement( const QString &pluginName );
 %Docstring
 Creates a settings tree element for the given ``pluginName``
 
diff --git a/python/core/auto_generated/settings/qgssettingsentry.sip.in b/python/core/auto_generated/settings/qgssettingsentry.sip.in
@@ -64,26 +64,28 @@ Transforms a dynamic key part string to list
 %Docstring
 Constructor for QgsSettingsEntryBase.
 
-The ``key`` argument specifies the key of the settings.
-The ``section`` argument specifies the section.
-The ``defaultValue`` argument specifies the default value for the settings entry.
-The ``description`` argument specifies a description for the settings entry.
-The ``options`` argument specifies the options for the settings entry.
+\arg key specifies the key of the settings.
+\arg section specifies the section.
+\arg defaultValue specifies the default value for the settings entry.
+\arg description specifies a description for the settings entry.
+\arg options specifies the options for the settings entry.
 %End
 
     QgsSettingsEntryBase( const QString &key,
                           QgsSettingsTreeElement *parentTreeElement,
                           const QVariant &defaultValue = QVariant(),
                           const QString &description = QString(),
-                          Qgis::SettingsOptions options = Qgis::SettingsOptions() );
+                          Qgis::SettingsOptions options = Qgis::SettingsOptions() ) throw( QgsSettingsException );
 %Docstring
 Constructor for QgsSettingsEntryBase.
 
-The ``key`` argument specifies the key of the settings.
-The ``parent`` argument specifies the parent in the tree of settings.
-The ``defaultValue`` argument specifies the default value for the settings entry.
-The ``description`` argument specifies a description for the settings entry.
-The ``options`` argument specifies the options for the settings entry.
+\arg key specifies the key of the settings.
+\arg parent specifies the parent in the tree of settings.
+\arg defaultValue specifies the default value for the settings entry.
+\arg description specifies a description for the settings entry.
+\arg options specifies the options for the settings entry.
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     virtual ~QgsSettingsEntryBase();
@@ -92,14 +94,14 @@ The ``options`` argument specifies the options for the settings entry.
 %Docstring
 Returns settings entry key.
 
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
 %End
 
     QString key( const QStringList &dynamicKeyPartList ) const;
 %Docstring
 Returns settings entry key.
 
-The ``dynamicKeyParts`` argument specifies the list of dynamic parts of the settings key.
+\arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
 %End
 
     bool keyIsValid( const QString &key ) const;
@@ -110,7 +112,7 @@ This is useful for settings with dynamic keys. For example this permits one to c
 the settings key "NewsFeed/httpsfeedqgisorg/27/content" is valid for the settings entry
 defined with the key "NewsFeed/%1/%2/content"
 
-The ``key`` to check
+\arg key to check
 %End
 
     QString definitionKey() const;
@@ -136,14 +138,14 @@ Returns the settings options
 %Docstring
 Returns ``True`` if the settings is contained in the underlying QSettings.
 
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
 %End
 
     bool exists( const QStringList &dynamicKeyPartList ) const;
 %Docstring
 Returns ``True`` if the settings is contained in the underlying QSettings.
 
-The ``dynamicKeyParts`` argument specifies the list of dynamic parts of the settings key.
+\arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
 %End
 
     Qgis::SettingsOrigin origin( const QStringList &dynamicKeyPartList ) const;
@@ -161,14 +163,14 @@ Returns the origin of the setting if it exists
 %Docstring
 Removes the settings from the underlying QSettings.
 
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
 %End
 
     void remove( const QStringList &dynamicKeyPartList ) const;
 %Docstring
 Removes the settings from the underlying QSettings.
 
-The ``dynamicKeyParts`` argument specifies the list of dynamic parts of the settings key.
+\arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
 %End
 
  QgsSettings::Section section() const;
@@ -184,7 +186,7 @@ Returns settings section. The settings section of the parent group is returned i
 Set settings value.
 
 The ``value`` to set.
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
 
 .. deprecated:: QGIS 3.26
    use setVariantValuePrivate or an implementation setValue instead
@@ -195,20 +197,20 @@ The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
 Set settings value.
 
 The ``value`` to set.
-The ``dynamicKeyParts`` argument specifies the list of dynamic parts of the settings key.
+\arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
 
 .. deprecated:: QGIS 3.26
    use setVariantValuePrivate or an implementation setValue instead
 %End
 
     QVariant valueAsVariant( const QString &dynamicKeyPart = QString() ) const;
 %Docstring
-Returns settings value with the ``dynamicKeyPart`` argument specifying the dynamic part of the settings key.
+Returns settings value with \arg dynamicKeyPart specifying the dynamic part of the settings key.
 %End
 
     QVariant valueAsVariant( const QStringList &dynamicKeyPartList ) const;
 %Docstring
-Returns settings value with the ``dynamicKeyPart`` argument specifying the dynamic part of the settings key.
+Returns settings value with \arg dynamicKeyPart specifying the dynamic part of the settings key.
 %End
 
     QVariant valueAsVariantWithDefaultOverride( const QVariant &defaultValueOverride, const QString &dynamicKeyPart = QString() ) const;
@@ -222,8 +224,8 @@ Returns settings value with a ``defaultValueOverride``
 %Docstring
 Returns settings value.
 
-The ``dynamicKeyPartList`` argument specifies the list of dynamic parts of the settings key.
-The ``defaultValueOverride`` argument if valid is used instead of the normal default value.
+\arg dynamicKeyPartList specifies the list of dynamic parts of the settings key.
+\arg defaultValueOverride if valid is used instead of the normal default value.
 
 .. versionadded:: 3.26
 %End
@@ -358,11 +360,13 @@ Base abstract class for settings entry which are passed by reference
 %Docstring
 Constructor for QgsSettingsEntryByReference.
 
-The ``key`` argument specifies the key of the settings.
-The ``parent`` argument specifies the parent in the tree of settings.
-The ``defaultValue`` argument specifies the default value for the settings entry.
-The ``description`` argument specifies a description for the settings entry.
-The ``options`` arguments specifies the options for the settings entry.
+\arg key specifies the key of the settings.
+\arg parent specifies the parent in the tree of settings.
+\arg defaultValue specifies the default value for the settings entry.
+\arg description specifies a description for the settings entry.
+\arg optionss specifies the options for the settings entry.
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     QgsSettingsEntryByReference( const QString &key,
@@ -373,11 +377,11 @@ The ``options`` arguments specifies the options for the settings entry.
 %Docstring
 Constructor for QgsSettingsEntryByReference.
 
-The ``key`` argument specifies the key of the settings.
-The ``section`` argument specifies the section.
-The ``defaultValue`` argument specifies the default value for the settings entry.
-The ``description`` argument specifies a description for the settings entry.
-The ``options`` arguments specifies the options for the settings entry.
+\arg key specifies the key of the settings.
+\arg section specifies the section.
+\arg defaultValue specifies the default value for the settings entry.
+\arg description specifies a description for the settings entry.
+\arg optionss specifies the options for the settings entry.
 %End
 
 
@@ -429,15 +433,15 @@ Returns the settings value for the ``dynamicKeyPartList`` and  with a ``defaultV
 Set settings value.
 
 The ``value`` to set.
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
 %End
 
     bool setValue( const T &value, const QStringList &dynamicKeyPartList ) const;
 %Docstring
 Set settings value.
 
 The ``value`` to set.
-The ``dynamicKeyParts`` argument specifies the list of dynamic parts of the settings key.
+\arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
 %End
 
     T defaultValue() const;
@@ -503,23 +507,25 @@ Base abstract class for settings entry which are passed by value
 %Docstring
 Constructor for QgsSettingsEntryByValue.
 
-The ``key`` argument specifies the key of the settings.
-The ``parent`` argument specifies the parent in the tree of settings.
-The ``section`` argument specifies the section.
-The ``defaultValue`` argument specifies the default value for the settings entry.
-The ``description`` argument specifies a description for the settings entry.
-The ``options`` arguments specifies the options for the settings entry.
+\arg key specifies the key of the settings.
+\arg parent specifies the parent in the tree of settings.
+\arg section specifies the section.
+\arg defaultValue specifies the default value for the settings entry.
+\arg description specifies a description for the settings entry.
+\arg optionss specifies the options for the settings entry.
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     QgsSettingsEntryByValue( const QString &key, const QString &section, QVariant defaultValue, const QString &description = QString(), Qgis::SettingsOptions options = Qgis::SettingsOptions() );
 %Docstring
 Constructor for QgsSettingsEntryByValue.
 
-The ``key`` argument specifies the key of the settings.
-The ``section`` argument specifies the section.
-The ``defaultValue`` argument specifies the default value for the settings entry.
-The ``description`` argument specifies a description for the settings entry.
-The ``options`` arguments specifies the options for the settings entry.
+\arg key specifies the key of the settings.
+\arg section specifies the section.
+\arg defaultValue specifies the default value for the settings entry.
+\arg description specifies a description for the settings entry.
+\arg optionss specifies the options for the settings entry.
 %End
 
     virtual Qgis::SettingsType settingsType() const = 0;
@@ -528,16 +534,16 @@ The ``options`` arguments specifies the options for the settings entry.
 %Docstring
 Returns settings value.
 
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
-The ``defaultValueOverride`` argument if valid is used instead of the normal default value.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
+\arg defaultValueOverride if valid is used instead of the normal default value.
 %End
 
     T value( const QStringList &dynamicKeyPartList )  const;
 %Docstring
 Returns settings value.
 
-The ``dynamicKeyPartList`` argument specifies the list of dynamic parts of the settings key.
-The ``defaultValueOverride`` argument if valid is used instead of the normal default value.
+\arg dynamicKeyPartList specifies the list of dynamic parts of the settings key.
+\arg defaultValueOverride if valid is used instead of the normal default value.
 %End
 
     T valueWithDefaultOverride( T defaultValueOverride, const QString &dynamicKeyPart = QString() ) const;
@@ -571,15 +577,15 @@ Returns the settings value for the ``dynamicKeyPartList`` and  with a ``defaultV
 Set settings value.
 
 The ``value`` to set.
-The ``dynamicKeyPart`` argument specifies the dynamic part of the settings key.
+\arg dynamicKeyPart specifies the dynamic part of the settings key.
 %End
 
     bool setValue( T value, const QStringList &dynamicKeyPartList ) const;
 %Docstring
 Set settings value.
 
 The ``value`` to set.
-The ``dynamicKeyParts`` argument specifies the list of dynamic parts of the settings key.
+\arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
 %End
 
     T defaultValue() const;
diff --git a/python/core/auto_generated/settings/qgssettingstreeelement.sip.in b/python/core/auto_generated/settings/qgssettingstreeelement.sip.in
@@ -64,6 +64,9 @@ to automatically register a settings entry on its creation when a parent is prov
     QgsSettingsTreeElement *createChildElement( const QString &key ) throw( QgsSettingsException ) /KeepReference/;
 %Docstring
 Creates a normal tree element
+It will return the existing child element if it exists at the given key
+
+:raises QgsSettingsException: if a setting exists with the same key
 %End
 
     QgsSettingsTreeNamedListElement *createNamedListElement( const QString &key, const QgsSettingsTreeElement::Options &options = QgsSettingsTreeElement::Options() ) throw( QgsSettingsException ) /KeepReference/;
@@ -91,7 +94,9 @@ Registers a child setting
 
 .. note::
 
-   This is automatically done when calling the setting's constructor with the parent argument
+   The registration is automatically done when calling the setting's constructor with the parent argument signature
+
+:raises QgsSettingsException: if a setting exists with the same key
 %End
 
     void unregisterChildSetting( const QgsSettingsEntryBase *setting, bool deleteSettingValues = false, const QStringList &parentsNamedItems = QStringList() );
@@ -157,7 +162,7 @@ Returns the number of named elements in the complete key
 %End
 
   protected:
-    void registerChildElement( QgsSettingsTreeElement *element ) throw( QgsSettingsException );
+    void registerChildElement( QgsSettingsTreeElement *element );
 %Docstring
 Registers a child elements
 %End
@@ -206,6 +211,8 @@ the named list element is used to store a group of settings under a dynamically
 Returns the list of items
 
 :param parentsNamedItems: the list of named items in the parent named list (if any)
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     QStringList items( Qgis::SettingsOrigin origin, const QStringList &parentsNamedItems = QStringList() ) const throw( QgsSettingsException );
@@ -214,6 +221,8 @@ Returns the list of items
 
 :param origin: can be used to restrict the origin of the setting (local or global)
 :param parentsNamedItems: the list of named items in the parent named list (if any)
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
 
@@ -223,13 +232,17 @@ Sets the selected named item from the named list element
 
 :param item: the item to set as selected
 :param parentsNamedItems: the list of named items in the parent named list (if any)
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     QString selectedItem( const QStringList &parentsNamedItems = QStringList() ) throw( QgsSettingsException );
 %Docstring
 Returns the selected named item from the named list element
 
 :param parentsNamedItems: the list of named items in the parent named list (if any)
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     void deleteItem( const QString &item, const QStringList &parentsNamedItems = QStringList() ) throw( QgsSettingsException );
@@ -238,6 +251,8 @@ Deletes a named item from the named list element
 
 :param item: the item to delete
 :param parentsNamedItems: the list of named items in the parent named list (if any)
+
+:raises QgsSettingsException: if the number of given parent named items doesn't match the complete key definition
 %End
 
     const QgsSettingsEntryString *selectedItemSetting() const;
diff --git a/src/core/settings/qgssettings.h b/src/core/settings/qgssettings.h
@@ -117,7 +117,7 @@ class CORE_EXPORT QgsSettings : public QObject
      * Creates a settings tree element for the given \a pluginName
      * \since QGIS 3.30
      */
-    static QgsSettingsTreeElement *createPluginTreeElement( const QString &pluginName ) SIP_THROW( QgsSettingsException );
+    static QgsSettingsTreeElement *createPluginTreeElement( const QString &pluginName );
 
 
     /**
diff --git a/src/core/settings/qgssettingsentry.h b/src/core/settings/qgssettingsentry.h
diff --git a/src/core/settings/qgssettingstreeelement.h b/src/core/settings/qgssettingstreeelement.h

-Original file line number
+Diff line change
     /**
      * Constructor for QgsSettingsEntryBase.
+     *
 -     * The \a key argument specifies the key of the settings.
 -     * The \a section argument specifies the section.
 -     * The \a defaultValue argument specifies the default value for the settings entry.
 -     * The \a description argument specifies a description for the settings entry.
 -     * The \a options argument specifies the options for the settings entry.
 +     * \arg key specifies the key of the settings.
 +     * \arg section specifies the section.
 +     * \arg defaultValue specifies the default value for the settings entry.
 +     * \arg description specifies a description for the settings entry.
 +     * \arg options specifies the options for the settings entry.
      */
     QgsSettingsEntryBase( const QString &key,
                           const QString &section,
     /**
      * Constructor for QgsSettingsEntryBase.
+     *
 -     * The \a key argument specifies the key of the settings.
 -     * The \a parent argument specifies the parent in the tree of settings.
 -     * The \a defaultValue argument specifies the default value for the settings entry.
 -     * The \a description argument specifies a description for the settings entry.
 -     * The \a options argument specifies the options for the settings entry.
 +     * \arg key specifies the key of the settings.
 +     * \arg parent specifies the parent in the tree of settings.
 +     * \arg defaultValue specifies the default value for the settings entry.
 +     * \arg description specifies a description for the settings entry.
 +     * \arg options specifies the options for the settings entry.
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
      */
     QgsSettingsEntryBase( const QString &key,
                           QgsSettingsTreeElement *parentTreeElement,
                           const QVariant &defaultValue = QVariant(),
                           const QString &description = QString(),
 -                          Qgis::SettingsOptions options = Qgis::SettingsOptions() );
 +                          Qgis::SettingsOptions options = Qgis::SettingsOptions() ) SIP_THROW( QgsSettingsException );
     /**
      * Destructor for QgsSettingsEntryBase.
     /**
      * Returns settings entry key.
+     *
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
      */
     QString key( const QString &dynamicKeyPart = QString() ) const;
     /**
      * Returns settings entry key.
+     *
 -     * The \a dynamicKeyParts argument specifies the list of dynamic parts of the settings key.
 +     * \arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
      */
     QString key( const QStringList &dynamicKeyPartList ) const;
      * the settings key "NewsFeed/httpsfeedqgisorg/27/content" is valid for the settings entry
      * defined with the key "NewsFeed/%1/%2/content"
+     *
 -     * The \a key to check
 +     * \arg key to check
      */
     bool keyIsValid( const QString &key ) const;
     /**
      * Returns TRUE if the settings is contained in the underlying QSettings.
+     *
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
      */
     bool exists( const QString &dynamicKeyPart = QString() ) const;
     /**
      * Returns TRUE if the settings is contained in the underlying QSettings.
+     *
 -     * The \a dynamicKeyParts argument specifies the list of dynamic parts of the settings key.
 +     * \arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
      */
     bool exists( const QStringList &dynamicKeyPartList ) const;
     /**
      * Removes the settings from the underlying QSettings.
+     *
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
      */
     void remove( const QString &dynamicKeyPart = QString() ) const;
     /**
      * Removes the settings from the underlying QSettings.
+     *
 -     * The \a dynamicKeyParts argument specifies the list of dynamic parts of the settings key.
 +     * \arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
      */
     void remove( const QStringList &dynamicKeyPartList ) const;
      * Set settings value.
+     *
      * The \a value to set.
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
      * \deprecated since QGIS 3.26 use setVariantValuePrivate or an implementation setValue instead
      */
     Q_DECL_DEPRECATED virtual bool setVariantValue( const QVariant &value, const QString &dynamicKeyPart = QString() ) const SIP_DEPRECATED;
      * Set settings value.
+     *
      * The \a value to set.
 -     * The \a dynamicKeyParts argument specifies the list of dynamic parts of the settings key.
 +     * \arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
      * \deprecated since QGIS 3.26 use setVariantValuePrivate or an implementation setValue instead
      */
     Q_DECL_DEPRECATED virtual bool setVariantValue( const QVariant &value, const QStringList &dynamicKeyPartList ) const SIP_DEPRECATED;
 -    //! Returns settings value with the \a dynamicKeyPart argument specifying the dynamic part of the settings key.
 +    //! Returns settings value with \arg dynamicKeyPart specifying the dynamic part of the settings key.
     QVariant valueAsVariant( const QString &dynamicKeyPart = QString() ) const;
 -    //! Returns settings value with the \a dynamicKeyPart argument specifying the dynamic part of the settings key.
 +    //! Returns settings value with \arg dynamicKeyPart specifying the dynamic part of the settings key.
     QVariant valueAsVariant( const QStringList &dynamicKeyPartList ) const;
     /**
     /**
      * Returns settings value.
+     *
 -     * The \a dynamicKeyPartList argument specifies the list of dynamic parts of the settings key.
 -     * The \a defaultValueOverride argument if valid is used instead of the normal default value.
 +     * \arg dynamicKeyPartList specifies the list of dynamic parts of the settings key.
 +     * \arg defaultValueOverride if valid is used instead of the normal default value.
      * \since QGIS 3.26
      */
     QVariant valueAsVariantWithDefaultOverride( const QVariant &defaultValueOverride, const QStringList &dynamicKeyPartList ) const;
     /**
      * Constructor for QgsSettingsEntryByReference.
+     *
 -     * The \a key argument specifies the key of the settings.
 -     * The \a parent argument specifies the parent in the tree of settings.
 -     * The \a defaultValue argument specifies the default value for the settings entry.
 -     * The \a description argument specifies a description for the settings entry.
 -     * The \a options arguments specifies the options for the settings entry.
 +     * \arg key specifies the key of the settings.
 +     * \arg parent specifies the parent in the tree of settings.
 +     * \arg defaultValue specifies the default value for the settings entry.
 +     * \arg description specifies a description for the settings entry.
 +     * \arg optionss specifies the options for the settings entry.
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
      */
     QgsSettingsEntryByReference( const QString &key,
                                  QgsSettingsTreeElement *parent,
     /**
      * Constructor for QgsSettingsEntryByReference.
+     *
 -     * The \a key argument specifies the key of the settings.
 -     * The \a section argument specifies the section.
 -     * The \a defaultValue argument specifies the default value for the settings entry.
 -     * The \a description argument specifies a description for the settings entry.
 -     * The \a options arguments specifies the options for the settings entry.
 +     * \arg key specifies the key of the settings.
 +     * \arg section specifies the section.
 +     * \arg defaultValue specifies the default value for the settings entry.
 +     * \arg description specifies a description for the settings entry.
 +     * \arg optionss specifies the options for the settings entry.
      */
     QgsSettingsEntryByReference( const QString &key,
                                  const QString &section,
      * Set settings value.
+     *
      * The \a value to set.
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
      */
     bool setValue( const T &value, const QString &dynamicKeyPart = QString() ) const
+    {
      * Set settings value.
+     *
      * The \a value to set.
 -     * The \a dynamicKeyParts argument specifies the list of dynamic parts of the settings key.
 +     * \arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
      */
     bool setValue( const T &value, const QStringList &dynamicKeyPartList ) const
+    {
     /**
      * Constructor for QgsSettingsEntryByValue.
+     *
 -     * The \a key argument specifies the key of the settings.
 -     * The \a parent argument specifies the parent in the tree of settings.
 -     * The \a section argument specifies the section.
 -     * The \a defaultValue argument specifies the default value for the settings entry.
 -     * The \a description argument specifies a description for the settings entry.
 -     * The \a options arguments specifies the options for the settings entry.
 +     * \arg key specifies the key of the settings.
 +     * \arg parent specifies the parent in the tree of settings.
 +     * \arg section specifies the section.
 +     * \arg defaultValue specifies the default value for the settings entry.
 +     * \arg description specifies a description for the settings entry.
 +     * \arg optionss specifies the options for the settings entry.
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
      */
     QgsSettingsEntryByValue( const QString &key, QgsSettingsTreeElement *parent, QVariant defaultValue, const QString &description = QString(), Qgis::SettingsOptions options = Qgis::SettingsOptions() )
       : QgsSettingsEntryBase( key, parent, defaultValue, description, options )
     /**
      * Constructor for QgsSettingsEntryByValue.
+     *
 -     * The \a key argument specifies the key of the settings.
 -     * The \a section argument specifies the section.
 -     * The \a defaultValue argument specifies the default value for the settings entry.
 -     * The \a description argument specifies a description for the settings entry.
 -     * The \a options arguments specifies the options for the settings entry.
 +     * \arg key specifies the key of the settings.
 +     * \arg section specifies the section.
 +     * \arg defaultValue specifies the default value for the settings entry.
 +     * \arg description specifies a description for the settings entry.
 +     * \arg optionss specifies the options for the settings entry.
      */
     QgsSettingsEntryByValue( const QString &key, const QString &section, QVariant defaultValue, const QString &description = QString(), Qgis::SettingsOptions options = Qgis::SettingsOptions() )
       : QgsSettingsEntryBase( key, section, defaultValue, description, options )
     /**
      * Returns settings value.
+     *
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 -     * The \a defaultValueOverride argument if valid is used instead of the normal default value.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
 +     * \arg defaultValueOverride if valid is used instead of the normal default value.
      */
     T value( const QString &dynamicKeyPart = QString() ) const { return this->convertFromVariant( valueAsVariant( dynamicKeyPart ) );}
     /**
      * Returns settings value.
+     *
 -     * The \a dynamicKeyPartList argument specifies the list of dynamic parts of the settings key.
 -     * The \a defaultValueOverride argument if valid is used instead of the normal default value.
 +     * \arg dynamicKeyPartList specifies the list of dynamic parts of the settings key.
 +     * \arg defaultValueOverride if valid is used instead of the normal default value.
      */
     T value( const QStringList &dynamicKeyPartList )  const { return this->convertFromVariant( valueAsVariant( dynamicKeyPartList ) );}
      * Set settings value.
+     *
      * The \a value to set.
 -     * The \a dynamicKeyPart argument specifies the dynamic part of the settings key.
 +     * \arg dynamicKeyPart specifies the dynamic part of the settings key.
      */
     bool setValue( T value, const QString &dynamicKeyPart = QString() ) const
+    {
      * Set settings value.
+     *
      * The \a value to set.
 -     * The \a dynamicKeyParts argument specifies the list of dynamic parts of the settings key.
 +     * \arg dynamicKeyParts specifies the list of dynamic parts of the settings key.
      */
     bool setValue( T value, const QStringList &dynamicKeyPartList ) const
+    {
-Original file line number
+Diff line change
      */
     static QgsSettingsTreeElement *createRootElement() SIP_SKIP;
 -    //! Creates a normal tree element
 +    /**
 +     * Creates a normal tree element
 +     * It will return the existing child element if it exists at the given key
 +     * \throws QgsSettingsException if a setting exists with the same key
 +     */
     QgsSettingsTreeElement *createChildElement( const QString &key ) SIP_THROW( QgsSettingsException ) SIP_KEEPREFERENCE;
     /**
      * \param setting the setting to register
      * \param key the key of the setting (not the complete key from its parents)
      * \note Ownership of the setting is transferred
 -     * \note This is automatically done when calling the setting's constructor with the parent argument
 +     * \note The registration is automatically done when calling the setting's constructor with the parent argument signature
 +     * \throws QgsSettingsException if a setting exists with the same key
      */
     void registerChildSetting( const QgsSettingsEntryBase *setting, const QString &key ) SIP_THROW( QgsSettingsException );
   protected:
     //! Registers a child elements
 -    void registerChildElement( QgsSettingsTreeElement *element ) SIP_THROW( QgsSettingsException );
 +    void registerChildElement( QgsSettingsTreeElement *element );
     Type mType = Type::Root;
     /**
      *  Returns the list of items
      * \param parentsNamedItems the list of named items in the parent named list (if any)
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
     */
     QStringList items( const QStringList &parentsNamedItems = QStringList() ) const SIP_THROW( QgsSettingsException );
     /**
      *  Returns the list of items
      * \param origin can be used to restrict the origin of the setting (local or global)
      * \param parentsNamedItems the list of named items in the parent named list (if any)
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
     */
     QStringList items( Qgis::SettingsOrigin origin, const QStringList &parentsNamedItems = QStringList() ) const SIP_THROW( QgsSettingsException );
      * Sets the selected named item from the named list element
      * \param item the item to set as selected
      * \param parentsNamedItems the list of named items in the parent named list (if any)
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
      */
     void setSelectedItem( const QString &item, const QStringList &parentsNamedItems = QStringList() ) SIP_THROW( QgsSettingsException );
     /**
      * Returns the selected named item from the named list element
      * \param parentsNamedItems the list of named items in the parent named list (if any)
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
      */
     QString selectedItem( const QStringList &parentsNamedItems = QStringList() ) SIP_THROW( QgsSettingsException );
     /**
      * Deletes a named item from the named list element
      * \param item the item to delete
      * \param parentsNamedItems the list of named items in the parent named list (if any)
 +     * \throws QgsSettingsException if the number of given parent named items doesn't match the complete key definition
      */
     void deleteItem( const QString &item, const QStringList &parentsNamedItems = QStringList() ) SIP_THROW( QgsSettingsException );