comparison cutils/util/glob.py @ 310:1371ceb6fad6

glob: also describe the "**/" pattern
author Franz Glasner <fzglas.hg@dom66.de>
date Sun, 09 Mar 2025 20:43:20 +0100
parents 16a5c337fcb9
children 6d1add815d14
comparison
equal deleted inserted replaced
309:553d6f7309d9 310:1371ceb6fad6
6 r"""Glob handling. 6 r"""Glob handling.
7 7
8 .. seealso:: 8 .. seealso::
9 - https://docs.oracle.com/javase/8/docs/api/java/nio/file/FileSystem.html#getPathMatcher-java.lang.String- 9 - https://docs.oracle.com/javase/8/docs/api/java/nio/file/FileSystem.html#getPathMatcher-java.lang.String-
10 - https://docs.oracle.com/javase/tutorial/essential/io/fileOps.html#glob 10 - https://docs.oracle.com/javase/tutorial/essential/io/fileOps.html#glob
11 - Mercurial: :command:`hg help patterns`
11 12
12 The following rules are used to interpret glob patterns: 13 The following rules are used to interpret glob patterns:
13 14
14 - The ``*`` character matches zero or more characters of a name 15 - The ``*`` character matches zero or more characters of a name
15 component without crossing directory boundaries. 16 component without crossing directory boundaries.
16 17
17 - The ``**`` characters matches zero or more characters crossing 18 - The ``**`` characters matches zero or more characters crossing
18 directory boundaries. 19 directory boundaries.
20
21 - ``**/`` matches zero or more subdirectories; files do not match.
19 22
20 - The ``?`` character matches exactly one character of a name component. 23 - The ``?`` character matches exactly one character of a name component.
21 24
22 - The backslash character (``\``) is used to escape characters that 25 - The backslash character (``\``) is used to escape characters that
23 would otherwise be interpreted as special characters. The expression 26 would otherwise be interpreted as special characters. The expression