diff --git a/actionpack/lib/abstract_controller/translation.rb b/actionpack/lib/abstract_controller/translation.rb
index 85a6b6ade1..db48022b9f 100644
--- a/actionpack/lib/abstract_controller/translation.rb
+++ b/actionpack/lib/abstract_controller/translation.rb
@@ -1,14 +1,13 @@
module AbstractController
module Translation
- # Delegates to I18n#translate but also performs one additional function.
+ # Delegates to I18n.translate. Also aliased as t.
#
- # It'll scope the key by the current action if the key starts
- # with a period. So if you call translate(".foo") from the
- # PeopleController#index action, you'll actually be calling
+ # When the given key starts with a period, it will be scoped by the current
+ # controller and action. So if you call translate(".foo") from
+ # PeopleController#index, it will convert the call to
# I18n.translate("people.index.foo"). This makes it less repetitive
- # to translate many keys within the same controller / action and gives you a simple framework
- # for scoping them consistently. If you don't prepend the key with a period,
- # nothing is converted.
+ # to translate many keys within the same controller / action and gives you a
+ # simple framework for scoping them consistently.
def translate(*args)
key = args.first
if key.is_a?(String) && (key[0] == '.')
@@ -20,7 +19,7 @@ module AbstractController
end
alias :t :translate
- # Delegates to I18n.localize with no additional functionality.
+ # Delegates to I18n.localize. Also aliased as l.
def localize(*args)
I18n.localize(*args)
end