doc: Mention behavoir details of pathwatcher.watch.
Add specs for changes under a watched directory.