--- a/src/hbcore/gui/hbstackedwidget.cpp	Tue Jul 06 14:36:53 2010 +0300
+++ b/src/hbcore/gui/hbstackedwidget.cpp	Wed Aug 18 10:05:37 2010 +0300
@@ -189,8 +189,7 @@
 /*!
     \brief Removes a widget.
 
-    Removes the given \a widget from the stack. The widget is not deleted.
-    The widget is set invisible.
+    Removes the given \a widget from the stack. The widget is not destroyed.
 
     Removing the current widget will set the next widget (or previous
     if the current widget was the last one) to be the current widget.
@@ -198,6 +197,9 @@
     Removing a widget from an index less than the current index will
     decrement the current index, but keep the current widget.
 
+    Make no assumptions about the visibility of \a widget or about being part of the scene.
+    If needed, call QGraphicsItem::setVisible(), QGraphicsScene::removeItem(), etc. after removeWidget().
+
     \param widget widget to be removed.
  */
 void HbStackedWidget::removeWidget(QGraphicsWidget *widget)