aboutsummaryrefslogtreecommitdiffstats
path: root/guides
diff options
context:
space:
mode:
authorXavier Noria <fxn@hashref.com>2015-11-04 13:03:41 +0100
committerXavier Noria <fxn@hashref.com>2015-11-08 22:49:50 -0800
commit7d2ae1328cf34873e4d73c3cb6fae750b3b7e213 (patch)
treefee9174655b2c4566d49a2b3a04a0b85b66cf9b9 /guides
parentb685095fc957a428fd86514d28a9183dbbdc3ab5 (diff)
downloadrails-7d2ae1328cf34873e4d73c3cb6fae750b3b7e213.tar.gz
rails-7d2ae1328cf34873e4d73c3cb6fae750b3b7e213.tar.bz2
rails-7d2ae1328cf34873e4d73c3cb6fae750b3b7e213.zip
document the evented file system monitor opt-in in the config guide [ci skip]
Diffstat (limited to 'guides')
-rw-r--r--guides/source/configuring.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/guides/source/configuring.md b/guides/source/configuring.md
index 28388e4957..3bb056493e 100644
--- a/guides/source/configuring.md
+++ b/guides/source/configuring.md
@@ -1149,3 +1149,25 @@ Disallow: /
To block just specific pages, it's necessary to use a more complex syntax. Learn
it on the [official documentation](http://www.robotstxt.org/robotstxt.html).
+
+Evented File System Monitor
+---------------------------
+
+If the [listen gem](https://github.com/guard/listen) is loaded Rails uses an
+evented file system monitor to detect changes when `config.cache_classes` is
+false:
+
+```ruby
+group :development do
+ gem 'listen'
+end
+```
+
+Otherwise, in every request Rails walks the application tree to check if
+anything has changed.
+
+On Linux and Mac OS X no additional gems are needed, but some are required
+[for *BSD](https://github.com/guard/listen#on-bsd) and
+[for Windows](https://github.com/guard/listen#on-windows).
+
+Note that [some setups are unsupported](https://github.com/guard/listen#issues--limitations).