filewatch/add

    cfunction
    src/core/filewatch.c on line 599, column 1

    (filewatch/add watcher path &opt flags)

    Add a path to the watcher. Available flags depend on the current 
    OS, and are as follows:

    Windows/MINGW (flags correspond to `FILE_NOTIFY_CHANGE_*` flags in 
    win32 documentation):

    $*$ `:all` $-$ trigger an event for all of the below triggers.

    $*$ `:attributes` $-$ `FILE_NOTIFY_CHANGE_ATTRIBUTES`

    $*$ `:creation` $-$ `FILE_NOTIFY_CHANGE_CREATION`

    $*$ `:dir-name` $-$ `FILE_NOTIFY_CHANGE_DIR_NAME`

    $*$ `:last-access` $-$ `FILE_NOTIFY_CHANGE_LAST_ACCESS`

    $*$ `:last-write` $-$ `FILE_NOTIFY_CHANGE_LAST_WRITE`

    $*$ `:security` $-$ `FILE_NOTIFY_CHANGE_SECURITY`

    $*$ `:size` $-$ `FILE_NOTIFY_CHANGE_SIZE`

    $*$ `:recursive` $-$ watch subdirectories recursively

    Linux (flags correspond to `IN_*` flags from <sys/inotify.h>):

    $*$ `:access` $-$ `IN_ACCESS`

    $*$ `:all` $-$ `IN_ALL_EVENTS`

    $*$ `:attrib` $-$ `IN_ATTRIB`

    $*$ `:close-nowrite` $-$ `IN_CLOSE_NOWRITE`

    $*$ `:close-write` $-$ `IN_CLOSE_WRITE`

    $*$ `:create` $-$ `IN_CREATE`

    $*$ `:delete` $-$ `IN_DELETE`

    $*$ `:delete-self` $-$ `IN_DELETE_SELF`

    $*$ `:ignored` $-$ `IN_IGNORED`

    $*$ `:modify` $-$ `IN_MODIFY`

    $*$ `:move-self` $-$ `IN_MOVE_SELF`

    $*$ `:moved-from` $-$ `IN_MOVED_FROM`

    $*$ `:moved-to` $-$ `IN_MOVED_TO`

    $*$ `:open` $-$ `IN_OPEN`

    $*$ `:q-overflow` $-$ `IN_Q_OVERFLOW`

    $*$ `:unmount` $-$ `IN_UNMOUNT`

    On Windows, events will have the following possible types:

    $*$ `:unknown`

    $*$ `:added`

    $*$ `:removed`

    $*$ `:modified`

    $*$ `:renamed-old`

    $*$ `:renamed-new`

    On Linux, events will a `:type` corresponding to the possible 
    flags, excluding `:all`.