Index: /trunk/doc/manual/en_US/user_GuestAdditions.xml
===================================================================
--- /trunk/doc/manual/en_US/user_GuestAdditions.xml	(revision 76161)
+++ /trunk/doc/manual/en_US/user_GuestAdditions.xml	(revision 76162)
@@ -2032,4 +2032,24 @@
     </para>
 
+    <sect2 id="guestadd-guestprops-waits">
+
+      <title>Using Guest Properties to Wait on VM Events</title>
+
+      <para>
+        The properties <computeroutput>/VirtualBox/HostInfo/VBoxVer</computeroutput>,
+        <computeroutput>/VirtualBox/HostInfo/VBoxVerExt</computeroutput> or
+        <computeroutput>/VirtualBox/HostInfo/VBoxRev</computeroutput> can be waited
+        on to detect that the VM state was restored from saved state or snapshot:
+      </para>
+
+<screen>$ VBoxControl guestproperty wait /VirtualBox/HostInfo/VBoxVer</screen>
+
+      <para>
+        Similarly the <computeroutput>/VirtualBox/HostInfo/ResumeCounter</computeroutput>
+        can be used to detect that a VM was resumed from the paused state or saved state.
+      </para>
+
+    </sect2>
+
   </sect1>