diff --git a/hledger/hledger.m4.md b/hledger/hledger.m4.md
index 90f1a3d14..a0c3e173a 100644
--- a/hledger/hledger.m4.md
+++ b/hledger/hledger.m4.md
@@ -2540,15 +2540,16 @@ So, you can do
 - `include **.journal` to include all other journal files in this directory and below (excluding dot directories/files)
 - `include timelogs/2???.timedot` to include all timedot files named like a year number.
 
+There is a limitation: hledger's globs always exclude paths involving dot files or dot directories.
+This is a workaround for unavoidable dot directory traversal; 
+you can disable it and revert to older behaviour with the `--old-glob` flag, for now.
+
 If you are using many, or deeply nested, include files, and have an error that's hard to pinpoint:
 a good troubleshooting command is `hledger files --debug=6` (or 7).
 
-
-
 <!-- https://hackage.haskell.org/package/Glob-0.9.2/docs/System-FilePath-Glob.html#v:compile -->
 
 
-
 ## `P` directive
 
 The `P` directive declares a market price, which is