1 files changed, 9 insertions, 1 deletions
diff --git a/src/corelib/tools/qscopedpointer.cpp b/src/corelib/tools/qscopedpointer.cpp
index 1dd77a22dc8..2f9f6f0dd43 100644
--- a/src/corelib/tools/qscopedpointer.cpp
+++ b/src/corelib/tools/qscopedpointer.cpp
@@ -267,6 +267,10 @@ QT_BEGIN_NAMESPACE
 */
 
 /*! \fn template <typename T, typename Cleanup> void QScopedPointer<T, Cleanup>::swap(QScopedPointer<T, Cleanup> &lhs, QScopedPointer<T, Cleanup> &rhs)
+
+    \obsolete Use std::unique_ptr instead; this function may let a pointer
+    escape its scope.
+
     Swaps \a lhs with \a rhs.
  */
 
@@ -333,7 +337,11 @@ QT_BEGIN_NAMESPACE
 */
 
 /*! \fn template <typename T, typename Cleanup> void QScopedArrayPointer<T, Cleanup>::swap(QScopedArrayPointer<T, Cleanup> &other)
-  Swap this pointer with \a other.
+
+    \obsolete Use std::unique_ptr instead; this function may let a pointer
+    escape its scope.
+
+    Swap this pointer with \a other.
  */
 
 QT_END_NAMESPACE