Merge branch '1.0' into master

src/DockWidgetBase.h

@@ -130,7 +130,12 @@ public:
 
     /**
      * @brief sets the widget which this dock widget hosts.
-     * @param widget to show inside this dock widget
+     * @param widget widget to show inside this dock widget. Must not be null.
+     *
+     * Ownership for @p widget is transfered to DockWidgetBase.
+     * Ownsership for any previously existing widget is transfered back to the user. Meaning if you
+     * call setWidget(A) followed by setWidget(B) then A will have to be deleted by you, while B is
+     * owned by the dock widget.
      */
     void setWidget(QWidgetOrQuick *widget);