feature(delta): automagically set delta to default git diff

[webi-installers/.git] / watchexec / README.md

diff --git a/watchexec/README.md b/watchexec/README.md
index 809e9d948567511c82aef503713bc9d2e83deaf7..f3ee6bd11d9a3a08c2f1b0cfb4ad436e85740cf5 100644 (file)
--- a/watchexec/README.md
+++ b/watchexec/README.md
@@ -5,30 +5,76 @@ tagline: |
   watchexec is a simple, standalone tool that watches a path and runs a command whenever it detects modifications.
 ---
 
-### Updating `watchexec`
+To update or switch versions, run `webi watchexec@stable` (or `@v1.17`, `@beta`,
+etc).
 
-`webi watchexec@stable`
+## Cheat Sheet
 
-Use the `@beta` tag for pre-releases.
+`watchexec` runs a given command when any files in watched directories change. \
+It respects `.[git]ignore`.
 
-## Cheat Sheet
+Here's the shortlist of options we've found most useful:
+
+```txt
+-w, --watch     ./src/      watch the given directory
+-e, --exts      js,css      watch only the given extensions
+-i, --ignore    '*.md'      do not watch the given pattern
+-d, --debounce  5000        the minimum number of milleseconds
+                                to wait between changes
+
+-r, --restart               restart the process (for servers, etc)
+-s, --signal    SIGHUP      like -r, but with a signal (ex: SIGHUP)
+-c, --clear                 clear the screen between command runs
+-W  (wait)                  ignore all changes as the command runs
+
+--              npm start   what command to run, with its arguments
+
+--no-ignore                 disregard both .ignore and .gitignore
+--no-vcs-ignore             disregard only .gitignore
+--no-default-ignore         disregard built-in ignore lists
+```
 
-Watch all JavaScript, CSS and HTML files in the current directory and all
-subdirectories for changes, running `make` when a change is detected:
+### How to use
+
+Example: List the directory when any files change.
 
 ```bash
-watchexec --exts js,css,html make
+watchexec -c -- ls -lah
 ```
 
-Call `make test` when any file changes in this directory/subdirectory, except
-for everything below `target`:
+### Advanced Usage Example
+
+Here's a "kitchen sink" example.
 
 ```bash
-watchexec -i target make test
+watchexec -c -r -s SIGKILL -d 2000 -W --verbose \
+    -w ./src -w ./server.js \
+    -e js,css,html \
+    -i '*.md' -i 'package-lock.json' \
+    -- npm run build
 ```
 
-Call `ls -la` when any file changes in this directory/subdirectory:
+### How to use (Node, Go, Rust, rsync)
+
+These examples show how you might use this for builds, servers, and publishing
+or deploying.
 
 ```bash
-watchexec -- ls -la
+# Node / npm
+watchexec -W -- npm run build
+watchexec -r -- npm start
+
+# Golang
+watchexec -- go build .
+watchexec -r -- go run .
+
+# Rust
+watchexec -- cargo build --bin
+watchexec -r -- cargo run --bin
+
+# rsync (local copy)
+watchexec -- rsync -avhP ./ ./srv/MY_PROJECT/
+
+# rsync (remote publish)
+watchexec -- rsync -avhP ./ app@example.com:~/srv/MY_PROJECT/
 ```