Changes: Update MDialog's addButton(buttonModel) and removeButton(buttonModel) doc

Fixes: NB#187275 - removeButton in MDialog deletes the MButtonModel in contrast to documentation

RevBy: Daniel d'Andrada
Details: Updated documentation to clarify what removeButton really does.

1 files changed, 11 insertions, 3 deletions

diff --git a/src/corelib/widgets/mdialog.h b/src/corelib/widgets/mdialog.h
index ddb577c5..7218c506 100644
--- a/src/corelib/widgets/mdialog.h
+++ b/src/corelib/widgets/mdialog.h
@@ -371,7 +371,11 @@ public:
     /*!
      * \brief Adds a given \a button to the button box.
      *
-     * \param button A button
+     * \param button Button model to be added.
+     *
+     * Causes the reference count of \a button to be increased by one.
+     *
+     * \sa removeButton(MButtonModel *button)
      */
     void addButton(MButtonModel *button);
 
@@ -412,9 +416,13 @@ public:
     MButtonModel *addButton(M::StandardButton button);
 
     /*!
-     * \brief Removes \a button from the dialog without deleting it.
+     * \brief Removes \a button from dialog's button box.
+     *
+     * \param button Button model to be removed.
+     *
+     * Causes the reference count of \a button to be decreased by one.
      *
-     * \sa addButton()
+     * \sa addButton(MButtonModel *button)
      */
     void removeButton(MButtonModel *button);