Clarify “Include only folders” syntax

[P1h3r1e3d13]

“Include only folders” field and tooltip for property

image.png (19.39 KiB) Viewed 1019 times

The tooltip for “Include only folders” in property settings says:

Include a backslash (\) to match full paths and filenames.
Otherwise, match name only.

And the examples all have full paths with backslashes:

Example: C:\Downloads;D:\My Documents;E:\

• I imagine the sans-backslash case is like
  foo*
  to include folders named “foo”, “foob”, etc. anywhere they're found.
• Would
  foo\bar
  include a “bar” folder in a “foo” folder, wherever “foo” is found? Or does an entry with a backslash have to be a full path?
• Are trailing backslashes permitted? Ignored? I note that the list management GUI does not include them when adding a folder.
• What about specifying an entire drive?
  G:
  (no backslash) is the full path, but I guess it's also the folder name. So would
  G:
  and
  G:\
  work the same?
• I assume all the (relevant) answers are the same for “Include only files”?

I'm sorry if some of that is pedantic. I didn't find any documentation for “Include only folders” in the Properties thread or by searching. void, perhaps you could add some detail on the syntax of the field, and expand the examples to show more of the possible formats.

[P1h3r1e3d13]

Bonus question: Is it not the same syntax for “Include only” under a FAT/NTFS/etc. index?
The tooltip and docs suggest it's strictly full paths.

“Include only” field and tooltip for FAT disk

image.png (9.5 KiB) Viewed 1016 times

[void]

I imagine the sans-backslash case is like foo* to include folders named “foo”, “foob”, etc. anywhere they're found.

Correct.

Would foo\bar include a “bar” folder in a “foo” folder, wherever “foo” is found? Or does an entry with a backslash have to be a full path?

It has to be a full path.
Use wildcards:

**\foo\bar

to match anywhere in the full path.

Are trailing backslashes permitted? Ignored? I note that the list management GUI does not include them when adding a folder.

They are ignored.

What about specifying an entire drive? G: (no backslash) is the full path, but I guess it's also the folder name. So would G: and G:\ work the same?

G: and G:\ are the same.
Excluding G: would exclude all files/folders on the G: drive.

I assume all the (relevant) answers are the same for “Include only files”?

Yes.

I'm sorry if some of that is pedantic. I didn't find any documentation for “Include only folders” in the Properties thread or by searching. void, perhaps you could add some detail on the syntax of the field, and expand the examples to show more of the possible formats.

Added a more advanced Exclude and Include only Syntax

[void]

Bonus question: Is it not the same syntax for “Include only” under a FAT/NTFS/etc. index?
The tooltip and docs suggest it's strictly full paths.

It's the same basic syntax.
However, only full paths are useful in this case.

[P1h3r1e3d13]

Awesome, thank you!