README.md in guard-rails-0.3.4 vs README.md in guard-rails-0.4.0

- old
+ new

@@ -3,25 +3,43 @@ [![Gem Version](https://badge.fury.io/rb/guard-rails.png)](http://badge.fury.io/rb/guard-rails) [![Build Status](https://travis-ci.org/ranmocy/guard-rails.png)](https://travis-ci.org/ranmocy/guard-rails) [![Dependency Status](https://gemnasium.com/ranmocy/guard-rails.png)](https://gemnasium.com/ranmocy/guard-rails) [![Code Climate](https://codeclimate.com/github/ranmocy/guard-rails.png)](https://codeclimate.com/github/ranmocy/guard-rails) -## Want to restart your Rails development server whilst you work? Now you can! +## Main repository +Currently, the official fork repository is at [ranmocy/guard-rails](http://github.com/ranmocy/guard-rails). +Please, come here and communicate with me. - guard 'rails', :port => 5000 do - watch('Gemfile.lock') - watch(%r{^(config|lib)/.*}) - end +## Install +Please make sure to have [Guard](https://github.com/guard/guard) installed before continue. + +Add Guard::Rails to your `Gemfile`: + +```ruby +group :development do + gem 'guard-rails' +end +``` + +Add the default Guard::Rails template to your `Guardfile` by running: + +```bash +$ guard init rails +``` + +Now I can automatically restart your Rails development server as your files changed! + ## Lots of fun options growing! * `:daemon` runs the server as a daemon, without any output to the terminal that ran `guard` (**default `false`**) * `:debugger` enable the debugger in server. Required ruby-debug gem. (**default `false`**) * `:environment` is the server environment (**default `development`**) * `:force_run` kills any process that's holding the listen port before attempting to (re)start Rails (**default `false`**) * `:pid_file` specify your pid\_file (**default `tmp/pids/[RAILS_ENV].pid`**) * `:port` is the server port number (**default `3000`**) +* `:root` lets you specify the Rails root, i.e. for using guard-rails to run a dummy app within an engine (try `:root => '/spec/dummy'`). * `:server` the webserver engine to use (**try `:server => :thin`**) * `:start_on_start` will start the server when starting Guard (**default `true`**) * `:timeout` waits when restarting the Rails server, in seconds (**default `30`**). * `:zeus_plan` the [custom plan](https://github.com/burke/zeus/blob/master/docs/ruby/modifying.md) in zeus, only works when `zeus` option is `true` (**default `server`**) * `:zeus` support [zeus](https://github.com/burke/zeus) to boost rails init speed (**default `false`**). @@ -30,14 +48,17 @@ ## How-to * **Multiple instances** use `pid_file` option to run multiple instances with same rails\_env ## Contribute -Feel free to fork'n'fix for any willing. -Or +The best choise to contact me is the Issues and Pull Request system on GitHub. +Currently the official fork repository is at [ranmocy/guard-rails](http://github.com/ranmocy/guard-rails). -Tell.me in: any.way +Please, post your issue or pull request there. +And I will be there as your call. ## Philosophy +* **All Platforms** MRI is the main test case. But will be tested under REE and JRuby. +* **Live in edge** I am tested under Ruby 1.8.7, 1.9.3, 2.0.0 with newest gems. Will be rewrited to fit Ruby 2.0.0 when I am released as version 1.0.0. * [Semantic Version](http://semver.org/)