Sip updates for source select provider and registry

Author: elpaso

python/gui/qgssourceselectprovider.sip

@@ -59,7 +59,7 @@ Text for the menu item entry, it will be visible to the user so make sure it's t
  :rtype: int
 %End
 
-    virtual QgsAbstractDataSourceWidget *createDataSourceWidget( QWidget *parent = 0 ) const = 0 /Factory/;
+    virtual QgsAbstractDataSourceWidget *createDataSourceWidget( QWidget *parent = 0, Qt::WindowFlags fl = Qt::Widget, QgsProviderRegistry::WidgetMode widgetMode = QgsProviderRegistry::WidgetMode::Embedded ) const = 0 /Factory/;
 %Docstring
  Create a new instance of QgsAbstractDataSourceWidget (or null).
  Caller takes responsibility of deleting created.

python/gui/qgssourceselectproviderregistry.sip

@@ -43,23 +43,24 @@ Get list of available providers
 
     void addProvider( QgsSourceSelectProvider *provider /Transfer/ );
 %Docstring
-Add a provider implementation. Takes ownership of the object.
+Add a ``provider`` implementation. Takes ownership of the object.
 %End
 
-    void removeProvider( QgsSourceSelectProvider *provider );
+    bool removeProvider( QgsSourceSelectProvider *provider /Transfer/ );
 %Docstring
-Remove provider implementation from the list (provider object is deleted)
+:return: true if the provider was actually removed and deleted
+ :rtype: bool
 %End
 
     QgsSourceSelectProvider *providerByName( const QString &name );
 %Docstring
-Return a provider by name or None if not found
+Return a provider by ``name`` or None if not found
  :rtype: QgsSourceSelectProvider
 %End
 
     QList<QgsSourceSelectProvider *> providersByKey( const QString &providerKey );
 %Docstring
-Return a (possibly empty) list of providers by data provider's key
+Return a (possibly empty) list of providers by data ``providerkey``
  :rtype: list of QgsSourceSelectProvider
 %End