diff --git a/docs/qmp-events.txt b/docs/qmp-events.txt
index 2e3a22aabb..83f03557ee 100644
--- a/docs/qmp-events.txt
+++ b/docs/qmp-events.txt
@@ -312,20 +312,6 @@ Example:
 {"timestamp": {"seconds": 1449669631, "microseconds": 239225},
  "event": "MIGRATION_PASS", "data": {"pass": 2}}
 
-SUSPEND_DISK
-------------
-
-Emitted when the guest makes a request to enter S4 state.
-
-Data: None.
-
-Example:
-
-{ "event": "SUSPEND_DISK",
-     "timestamp": { "seconds": 1344456160, "microseconds": 309119 } }
-
-Note: QEMU shuts down when entering S4 state.
-
 VNC_CONNECTED
 -------------
 
diff --git a/qapi/event.json b/qapi/event.json
index 34e046769e..a3792cd2fa 100644
--- a/qapi/event.json
+++ b/qapi/event.json
@@ -109,6 +109,12 @@
 # Note: QEMU shuts down (similar to event @SHUTDOWN) when entering this state
 #
 # Since: 1.2
+#
+# Example:
+#
+# <-   { "event": "SUSPEND_DISK",
+#        "timestamp": { "seconds": 1344456160, "microseconds": 309119 } }
+#
 ##
 { 'event': 'SUSPEND_DISK' }