diff --git a/ChangeLog b/ChangeLog index 4e87b80c40..cebd18faa4 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +Sat Jan 19 09:27:31 2013 Eric Hodel + + * doc/syntax/assignment.rdoc (Local Variables and Methods): Made it + more clear that local variables are created by the parser, not + execution. Thanks to John Hawthorn. + Sat Jan 19 09:15:58 2013 Eric Hodel * doc/syntax/assignment.rdoc: Improved links diff --git a/doc/syntax/assignment.rdoc b/doc/syntax/assignment.rdoc index 830ba39ff0..c371593fbe 100644 --- a/doc/syntax/assignment.rdoc +++ b/doc/syntax/assignment.rdoc @@ -70,7 +70,17 @@ have not assigned to one of these ambiguous names ruby will assume you wish to call a method. Once you have assigned to the name ruby will assume you wish to reference a local variable. -This leads to some potentially confusing code, for example: +The local variable is created when the parser encounters the assignment, not +when the assignment occurs: + + a = 0 if false # does not assign to a + + p local_variables # prints [:a] + + p a # prints nil + +The similarity between method and local variable names can lead to confusing +code, for example: def big_calculation 42 # pretend this takes a long time