diff --git a/doc/manpages/qvm-shutdown.rst b/doc/manpages/qvm-shutdown.rst
index da62e5d..f9239f0 100644
--- a/doc/manpages/qvm-shutdown.rst
+++ b/doc/manpages/qvm-shutdown.rst
@@ -3,15 +3,6 @@
 :program:`qvm-shutdown` -- Gracefully shut down a qube
 ======================================================
 
-.. warning::
-
-   This page was autogenerated from command-line parser. It shouldn't be 1:1
-   conversion, because it would add little value. Please revise it and add
-   more descriptive help, which normally won't fit in standard ``--help``
-   option.
-
-   After rewrite, please remove this admonition.
-
 Synopsis
 --------
 
@@ -42,7 +33,9 @@ Options
 
 .. option:: --wait
 
-   wait for the VMs to shut down
+   wait for the VMs to shut down. If some domains are providing network to other
+   domains, wait for those domains to shut down before shutting down their
+   dependents.
 
 .. option:: --timeout