diff --git a/doc/snapraid.1 b/doc/snapraid.1 index cb136013..6999f119 100644 --- a/doc/snapraid.1 +++ b/doc/snapraid.1 @@ -1938,7 +1938,7 @@ not match directory separators. Classes support ranges and negation using an exclamation mark. .PP The fundamental distinction to remember is that \`*\`, \`?\`, and character -classes all respect directory boundaries and only match within a single path +classes all respect directory boundaries and only match within a single path component, while \`**\` is the only pattern that can match across directory separators. .PP @@ -1968,9 +1968,9 @@ Windows system directories, junctions, mount points, and other Windows special directories are treated as files, meaning that to exclude them, you must use a file rule, not a directory one. .PP -If the file name contains a \`*\`, \`?\`, \`[\`, -or \`]\` character, you must escape it to avoid having it interpreted as a -globbing character. In Unix, the escape character is \`\\\`; in Windows, it is \`^\`. +If the file name contains a \`*\`, \`?\`, \`[\`, or \`]\` character, you must +escape it to avoid having it interpreted as a globbing character. +In Unix, the escape character is \`\\\`; in Windows, it is \`^\`. When the pattern is on the command line, you must double the escape character to avoid having it interpreted by the command shell. .PP diff --git a/doc/snapraid.d b/doc/snapraid.d index 7282de8c..f028a2b4 100644 --- a/doc/snapraid.d +++ b/doc/snapraid.d @@ -1553,7 +1553,7 @@ Pattern an exclamation mark. The fundamental distinction to remember is that `*`, `?`, and character - classes all respect directory boundaries and only match within a single path + classes all respect directory boundaries and only match within a single path component, while `**` is the only pattern that can match across directory separators. @@ -1583,9 +1583,9 @@ Pattern special directories are treated as files, meaning that to exclude them, you must use a file rule, not a directory one. - If the file name contains a `*`, `?`, `[`, - or `]` character, you must escape it to avoid having it interpreted as a - globbing character. In Unix, the escape character is `\`; in Windows, it is `^`. + If the file name contains a `*`, `?`, `[`, or `]` character, you must + escape it to avoid having it interpreted as a globbing character. + In Unix, the escape character is `\`; in Windows, it is `^`. When the pattern is on the command line, you must double the escape character to avoid having it interpreted by the command shell. diff --git a/doc/snapraid.txt b/doc/snapraid.txt index d55666d9..fe26b037 100644 --- a/doc/snapraid.txt +++ b/doc/snapraid.txt @@ -1666,7 +1666,7 @@ not match directory separators. Classes support ranges and negation using an exclamation mark. The fundamental distinction to remember is that `*`, `?`, and character -classes all respect directory boundaries and only match within a single path +classes all respect directory boundaries and only match within a single path component, while `**` is the only pattern that can match across directory separators. @@ -1696,9 +1696,9 @@ Windows system directories, junctions, mount points, and other Windows special directories are treated as files, meaning that to exclude them, you must use a file rule, not a directory one. -If the file name contains a `*`, `?`, `[`, -or `]` character, you must escape it to avoid having it interpreted as a -globbing character. In Unix, the escape character is `\`; in Windows, it is `^`. +If the file name contains a `*`, `?`, `[`, or `]` character, you must +escape it to avoid having it interpreted as a globbing character. +In Unix, the escape character is `\`; in Windows, it is `^`. When the pattern is on the command line, you must double the escape character to avoid having it interpreted by the command shell.