Document that directories are not watched recursively

[vadz]

Thanks for a very useful extension, this is exactly what I was looking for to update the preview of the files I edit in the browser automatically. And it does seem to work great, but at least under Linux you have to specify the immediate parent directory of the file, which is not immediately obvious and cost me some time to discover.

So I think it would be great to mention this in the instructions about writing rules on the web site.

[nicorac]

at least under Linux you have to specify the immediate parent directory

I've had a look at FileWatch sources:

On Windows the library uses ReadDirectoryChangesW(); setting its 4th parameter bWatchSubtree to true enables watching subtrees.

On Linux it uses inotify; its readme reports this "limitation":

Inotify monitoring of directories is not recursive: to monitor
subdirectories under a directory, additional watches must be
created. This can take a significant amount time for large
directory trees.

that's why it won't detect file changes in subdirectories (haven't tested it before, sorry 😔).

Other softwares are able to detect changes of (large) subtrees on Linux (i.e. VSCode, nodemon, ...), so I'll leave this issue open till I have the time to investigate it.

Feel free to contribute if you like. I'm open to switching to another multiplatform library if needed.