diff --git a/tools/generate-wire.py b/tools/generate-wire.py
index 9698eb09c..6a74a34a3 100755
--- a/tools/generate-wire.py
+++ b/tools/generate-wire.py
@@ -16,6 +16,9 @@
 # Subtypes:
 #   subtype,<subtypename>
 #   subtypedata,<subtypename>,<fieldname>,<typename>,[<count>]
+#
+# Note: <count> can be a fixed value, a named value read before,
+#       or '...' to read until the end of the current structure.
 
 from argparse import ArgumentParser, REMAINDER
 from collections import OrderedDict