2011-06-19 19:55:28 +00:00
|
|
|
guard(1) -- Guard keeps an eye on your file modifications.
|
|
|
|
========================================================
|
|
|
|
|
|
|
|
## DESCRIPTION
|
|
|
|
|
|
|
|
Guard is a command line tool that easily handle events on files modifications.
|
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
## SYNOPSIS
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
guard <command> <options>
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
## COMMANDS
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
### start
|
|
|
|
Starts Guard. This is the default command if none is provided.
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
The following options are available:
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`-c`/`--clear`
|
|
|
|
Clears the Shell after each change.
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`-n`/`--notify` <flag>
|
|
|
|
Disable notifications (Growl or Libnotify depending on your system).
|
|
|
|
Note that notifications can also be disabled globally by setting a GUARD_NOTIFY environment variable to false.
|
|
|
|
The <flag> part can be passed to guard using true/false or t/f.
|
2011-06-19 19:55:28 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`-d`/`--debug`
|
|
|
|
Runs Guard in debug mode.
|
2011-06-21 15:00:00 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`-g`/`--group` <group> ...
|
|
|
|
Runs only the groups specified.
|
2011-06-21 15:00:00 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`-w`/`--watchdir` <folder>
|
|
|
|
Specify the directory to watch.
|
|
|
|
|
|
|
|
`-G`/`--guardfile` <file>
|
|
|
|
Specify a Guardfile by giving its path.
|
2011-06-21 15:00:00 +00:00
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
### init [guard]
|
2011-06-21 15:00:00 +00:00
|
|
|
Add the requested guard's default Guardfile configuration to the current Guardfile.
|
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
### list
|
|
|
|
Lists guards that can be used with the `init` command.
|
|
|
|
|
|
|
|
### -T/show
|
2011-06-21 15:00:00 +00:00
|
|
|
List defined groups and guards for the current Guardfile.
|
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
## OPTIONS
|
|
|
|
|
|
|
|
* `-h`:
|
|
|
|
List all of Guard's available commands.
|
|
|
|
|
|
|
|
### start
|
|
|
|
|
2011-06-19 19:55:28 +00:00
|
|
|
## EXAMPLES
|
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`[bundle exec] guard [start] --watchdir ~/dev --guardfile ~/env/Guardfile --clear --group backend frontend --notify false --debug`
|
2011-06-19 19:55:28 +00:00
|
|
|
|
|
|
|
or in a more concise way:
|
|
|
|
|
2011-08-09 23:16:31 +00:00
|
|
|
`[bundle exec] guard [start] -w ~/dev -G ~/env/Guardfile -c -g backend frontend -n f -d`
|
2011-06-19 19:55:28 +00:00
|
|
|
|
|
|
|
## AUTHORS / CONTRIBUTORS
|
|
|
|
|
|
|
|
Thibaud Guillaume-Gentil is the main author.
|
|
|
|
|
|
|
|
A list of contributors based on all commits can be found here:
|
|
|
|
https://github.com/guard/guard/contributors
|
|
|
|
|
|
|
|
For an exhaustive list of all the contributors, please see the CHANGELOG:
|
|
|
|
https://github.com/guard/guard/blob/master/CHANGELOG.md
|
2011-08-09 23:16:31 +00:00
|
|
|
|
|
|
|
This manual has been written by Remy Coutable.
|
|
|
|
|
|
|
|
## WWW
|
|
|
|
|
|
|
|
https://github.com/guard/guard
|