;doc: include: mention glob pattern's dot limitation and the --old-glob flag

This commit is contained in:
Simon Michael 2025-07-17 08:10:34 -07:00
parent b7e35f84a2
commit d5ff7fe454

View File

@ -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