diff --git a/lib/i18n.rb b/lib/i18n.rb
index 297a6255..c3d97367 100644
--- a/lib/i18n.rb
+++ b/lib/i18n.rb
@@ -140,10 +140,14 @@ def reload!
# called and passed the key and options.
#
# E.g. assuming the key :salutation resolves to:
- # lambda { |key, options| options[:gender] == 'm' ? "Mr. %{options[:name]}" : "Mrs. %{options[:name]}" }
+ # lambda { |key, options| options[:gender] == 'm' ? "Mr. #{options[:name]}" : "Mrs. #{options[:name]}" }
#
# Then I18n.t(:salutation, :gender => 'w', :name => 'Smith') will result in "Mrs. Smith".
#
+ # Note that the string returned by lambda will go through string interpolation too,
+ # so the following lambda would give the same result:
+ # lambda { |key, options| options[:gender] == 'm' ? "Mr. %{name}" : "Mrs. %{name}" }
+ #
# It is recommended to use/implement lambdas in an "idempotent" way. E.g. when
# a cache layer is put in front of I18n.translate it will generate a cache key
# from the argument values passed to #translate. Therefor your lambdas should