NAME

       watchman-wait - waits for changes to files.

SYNOPSIS

       watchman [-h] [--relative RELATIVE] [--fields FIELDS]
       [-s SEPARATOR] [-m MAX_EVENTS] [-p PATTERN [PATTERN ...]]
       [-t TIMEOUT]
       path [path ...]

DESCRIPTION

       watchman-wait  uses  the  watchman  service  to  efficiently  and  recursively  watch your
       specified list of paths.

       It is suitable for waiting for changes to files from shell scripts.

       It can stop after a configurable number of events are observed.  The default is  a  single
       event.  You may also remove the limit and allow it to execute continuously.

       watchman-wait  will  print  one  event  per  line.   The  event  information includes your
       specified list of fields, with each  field  separated  by  a  space  (or  your  choice  of
       --separator).

       Events  are  consolidated and settled by the watchman server before they are dispatched to
       watchman-wait.

USAGE

       OPTIONAL ARGUMENTS

       -h, --help

              show this help message and exit

       --relative RELATIVE

              print paths relative to this dir (default=PWD)

       --fields FIELDS

              Comma separated list of file information fields to return. The default is just  the
              name.   For  a  list  of  possible  fields,  see:  https://facebook.github.io/watch
              man/docs/cmd/query.html#available-fields

       -s SEPARATOR, --separator SEPARATOR

              String to use as field separator for event output.

       -m MAX_EVENTS, --max-events MAX_EVENTS

              Set the maximum number of events that will be processed. When the limit is reached,
              watchman-wait  will  exit.  The  default  is  1. Setting the limit to 0 removes the
              limit, causing watchman-wait to execute indefinitely.

       -p PATTERN [PATTERN ...], --pattern PATTERN [PATTERN ...]

              Only emit paths that match this list of  patterns.  Patterns  are  applied  by  the
              watchman  server  and  are matched against the root-relative paths. You will almost
              certainly want to use quotes around your pattern list so that  your  shell  doesn't
              interpret  the  pattern.  The  pattern  syntax  is  wildmatch  style; globbing with
              recursive matching via '**'.

       -t TIMEOUT, --timeout TIMEOUT

              Exit if no events trigger within the specified timeout. If  timeout  is  zero  (the
              default) then keep running indefinitely.

       POSITIONAL ARGUMENTS

       path

              path(s) to watch

       EXIT STATUS

       0

              After successfully waiting for event(s)

       1

              In case of a runtime error of some kind

       2

              The -t/--timeout option was used and that amount of time passed before an event was
              received

       3

              Execution was interrupted (Ctrl-C)

SEE ALSO

       watchman(1), watchman-make(1)

       For     more     information,     please     refer      the      online      documentation
       ⟨http://facebook.github.io/watchman/docs/cli-options.html⟩