diff --git a/bin/hledger-addon-example.hs b/bin/hledger-addon-example.hs
index 6d14ded37..1ac1d3a95 100755
--- a/bin/hledger-addon-example.hs
+++ b/bin/hledger-addon-example.hs
@@ -55,6 +55,8 @@ import Hledger.Cli
 
 ------------------------------------------------------------------------------
 cmdmode = hledgerCommandMode
+  -- Command name and help text goes here. Current limitations:
+  -- help text must be above _FLAGS, blank lines will not be displayed.
   [s| addon-example
 Print the number of transactions in the journal.