mdBook/book-example/src/cli/watch.md

# The watch command

The `watch` command is useful when you want your book to be rendered on every file change.
You could repeatedly issue `mdbook build` every time a file is changed. But using `mdbook watch` once will watch your files and will trigger a build automatically whenever you modify a file.

#### Specify a directory

Like `init` and `build`, `watch` can take a directory as an argument to use
instead of the current working directory.

```bash
mdbook watch path/to/book
```

#### --open

When you use the `--open` (`-o`) option, mdbook will open the rendered book in
your default web browser.

#### --dest-dir

The `--dest-dir` (`-d`) option allows you to change the output directory for your book.

-----

***note:*** *the `watch` command has not gotten a lot of testing yet, there could be some rough edges. If you discover a problem, please report it [on Github](https://github.com/rust-lang-nursery/mdBook/issues)*
Watch builds are now spawned in new threads (using crossbeam) and there is a timelock, preventing multiple builds being triggered in less than a second 2015-11-09 21:31:00 +08:00			`# The watch command`

Update documentation, Closes #80 2015-12-30 22:04:24 +08:00			The `watch` command is useful when you want your book to be rendered on every file change.
			You could repeatedly issue `mdbook build` every time a file is changed. But using `mdbook watch` once will watch your files and will trigger a build automatically whenever you modify a file.
Watch builds are now spawned in new threads (using crossbeam) and there is a timelock, preventing multiple builds being triggered in less than a second 2015-11-09 21:31:00 +08:00
			`#### Specify a directory`

Update documentation to reflect addition of `clean` subcommand. (#607) * update documentation Update README.md and User Guide to reflect addition of `clean` subcommand. Do minor spelling fixes too. * fix grammar in `clean` documentation 2018-02-18 15:04:04 +08:00			Like `init` and `build`, `watch` can take a directory as an argument to use
			`instead of the current working directory.`
Watch builds are now spawned in new threads (using crossbeam) and there is a timelock, preventing multiple builds being triggered in less than a second 2015-11-09 21:31:00 +08:00
fix mdbook test for the book 2015-12-30 06:59:08 +08:00			```bash
Watch builds are now spawned in new threads (using crossbeam) and there is a timelock, preventing multiple builds being triggered in less than a second 2015-11-09 21:31:00 +08:00			`mdbook watch path/to/book`
			```
Update documentation, Closes #80 2015-12-30 22:04:24 +08:00
Add a CLI option to open a web browser 2017-01-02 01:42:47 +08:00			`#### --open`

			When you use the `--open` (`-o`) option, mdbook will open the rendered book in
			`your default web browser.`
Update documentation, Closes #80 2015-12-30 22:04:24 +08:00
Add docs for --dest-dir option 2017-01-17 08:11:39 +08:00			`#### --dest-dir`

			The `--dest-dir` (`-d`) option allows you to change the output directory for your book.

Update documentation, Closes #80 2015-12-30 22:04:24 +08:00			`-----`

updated links from azerupi to rust-lang-nursery (#489) 2017-11-22 18:35:18 +08:00			*note:* the `watch` command has not gotten a lot of testing yet, there could be some rough edges. If you discover a problem, please report it [on Github](https://github.com/rust-lang-nursery/mdBook/issues)