fswatch icon indicating copy to clipboard operation
fswatch copied to clipboard

Out of date list of monitors at wiki page or obsolete/removed monitors for Solaris and Windows?

Open birbilis opened this issue 5 years ago • 5 comments

at http://emcrisostomo.github.io/fswatch/ one reads: ...

  • A monitor based on File Events Notification, a Solaris/Illumos kernel API that reports file events.
  • A monitor based on ReadDirectoryChangesW, a Microsoft Windows API that reports changes to a directory. ...

but at https://github.com/emcrisostomo/fswatch/wiki those two are missing in the list of supported monitors

are they still in there? is the 2nd text just out-of-date?

birbilis avatar Aug 15 '20 08:08 birbilis

just noticed this page does list those two monitors missing from the wiki page: https://github.com/emcrisostomo/fswatch in a bit of a different order from the http://emcrisostomo.github.io/fswatch/ page

birbilis avatar Aug 15 '20 09:08 birbilis

Also https://github.com/emcrisostomo/fswatch/wiki/How-to-Choose-a-Monitor speaks of FSEvents and inotify and kqueue but doesn't have any recommendations about other monitors, instead suggests using the poll monitor if the previous 3 aren't available

at https://github.com/emcrisostomo/fswatch/wiki/Monitors again it doesn't list Solaris and Windows ones

at http://emcrisostomo.github.io/fswatch/doc/1.14.0/libfswatch.html/ it does list them (obviously need to keep a list of where monitors are mentioned to update all if more monitors are added in the future or if monitor-related recommendations change etc.)

birbilis avatar Aug 15 '20 09:08 birbilis

also at http://emcrisostomo.github.io/fswatch/ it writes on the header text: "A cross-platform file change monitor with multiple backends: Apple OS X File System Events API, *BSD kqueue, Solaris/Illumos File Events Notification, Linux inotify and a stat()-based backend." but that doesn't mention "Windows ReadDirectoryChangesW" which is mentioned though in that page's text below

birbilis avatar Aug 15 '20 10:08 birbilis

Agreed they should all be updated to be consistent with each other

SamuelMarks avatar Nov 26 '21 21:11 SamuelMarks

Thanks for the report, I agree with you, the wiki hasn't caught up with the texinfo and doxygen documentation, from which the PDF manuals are generated. I'll review this.

emcrisostomo avatar Jul 10 '22 22:07 emcrisostomo