diff --git a/docbook/attributes.adoc b/docbook/attributes.adoc
index 71fa9ba807..5c9da12dd9 100644
--- a/docbook/attributes.adoc
+++ b/docbook/attributes.adoc
@@ -7,6 +7,8 @@
 :experimental:
 
 // Don't add a "Last updated" footer to our man pages.
+// We could use the "reproducible" attribute here, but it generates an
+// empty black box.
 :nofooter:
 
 // Create PA4 (210 × 280mm) pages: https://en.wikipedia.org/wiki/Paper_size#PA4_or_L4