diff --git a/docs/qmp-events.txt b/docs/qmp-events.txt
deleted file mode 100644
index d84be5fdd4..0000000000
--- a/docs/qmp-events.txt
+++ /dev/null
@@ -1,16 +0,0 @@
-                   QEMU Machine Protocol Events
-                   ============================
-
-MIGRATION_PASS
---------------
-
-Emitted from the source side of a migration at the start of each pass
-(when it syncs the dirty bitmap)
-
-Data: None.
-
-  - "pass": An incrementing count (starting at 1 on the first pass)
-
-Example:
-{"timestamp": {"seconds": 1449669631, "microseconds": 239225},
- "event": "MIGRATION_PASS", "data": {"pass": 2}}
diff --git a/qapi/event.json b/qapi/event.json
index 9d1c2f9fe4..f3737b771f 100644
--- a/qapi/event.json
+++ b/qapi/event.json
@@ -430,6 +430,12 @@
 # @pass: An incrementing count (starting at 1 on the first pass)
 #
 # Since: 2.6
+#
+# Example:
+#
+# { "timestamp": {"seconds": 1449669631, "microseconds": 239225},
+#   "event": "MIGRATION_PASS", "data": {"pass": 2} }
+#
 ##
 { 'event': 'MIGRATION_PASS',
   'data': { 'pass': 'int' } }