aboutsummaryrefslogtreecommitdiffstats
path: root/guides
diff options
context:
space:
mode:
authorJon Atack <jonnyatack@gmail.com>2015-12-21 19:14:37 +0100
committerJon Atack <jonnyatack@gmail.com>2015-12-21 19:14:37 +0100
commitbdf280bef1fc56ba9f012011707a37f32a569cab (patch)
tree0afc3a4d04d130862758f1f1086b4739e9b94ae3 /guides
parent0207464f9b7a00d4916dbd9bc864515524097b7d (diff)
downloadrails-bdf280bef1fc56ba9f012011707a37f32a569cab.tar.gz
rails-bdf280bef1fc56ba9f012011707a37f32a569cab.tar.bz2
rails-bdf280bef1fc56ba9f012011707a37f32a569cab.zip
Clarify config settings for AS::halt_callback_chains_on_return_false
[skip ci]
Diffstat (limited to 'guides')
-rw-r--r--guides/source/configuring.md2
1 files changed, 1 insertions, 1 deletions
diff --git a/guides/source/configuring.md b/guides/source/configuring.md
index 756cb5bba0..2f8542cf14 100644
--- a/guides/source/configuring.md
+++ b/guides/source/configuring.md
@@ -545,7 +545,7 @@ There are a few configuration options available in Active Support:
* `config.active_support.time_precision` sets the precision of JSON encoded time values. Defaults to `3`.
-* `ActiveSupport.halt_callback_chains_on_return_false` specifies whether Active Record and Active Model callback chains can be halted by returning `false` in a 'before' callback. Defaults to `true`.
+* `ActiveSupport.halt_callback_chains_on_return_false` specifies whether Active Record and Active Model callback chains can be halted by returning `false` in a 'before' callback. When set to `false`, callback chains are halted only when explicitly done so with `throw(:abort)`. When set to `true`, callback chains are halted when a callback returns false (the previous behavior before Rails 5) and a deprecation warning is given. Defaults to `true` during the deprecation period. New Rails 5 apps generate an initializer file called `callback_terminator.rb` which sets the value to `false`. This file is *not* added when running `rake rails:update`, so returning `false` will still work on older apps ported to Rails 5 and display a deprecation warning to prompt users to update their code.
* `ActiveSupport::Logger.silencer` is set to `false` to disable the ability to silence logging in a block. The default is `true`.