diff --git a/doc/source/man/heat.rst b/doc/source/man/heat.rst
index 5da86af6..d1b6e67b 100644
--- a/doc/source/man/heat.rst
+++ b/doc/source/man/heat.rst
@@ -81,6 +81,13 @@ Abandon a stack::
 
     heat stack-abandon mystack
 
+Adopt a stack ::
+
+    heat stack-adopt -a <adopt_file> mystack
+
+Note: stack-adopt and stack-abandon commands are not available by default.
+Please ask your Openstack operator to enable this feature.
+
 BUGS
 ====