diff --git a/docs/apibuild.py b/docs/apibuild.py
index 9c82c4a5e8..888275900b 100755
--- a/docs/apibuild.py
+++ b/docs/apibuild.py
@@ -114,8 +114,8 @@ ignored_macros = {
 
 # macros that should be completely skipped
 hidden_macros = {
-  "VIR_DEPRECATED", # internal macro to mark deprecated apis
-  "VIR_EXPORT_VAR", # internal macro to mark exported vars
+  "VIR_DEPRECATED": "internal macro to mark deprecated apis",
+  "VIR_EXPORT_VAR": "internal macro to mark exported vars",
 }
 
 def escape(raw):