     "locals-word-test locals-word-test eq? ."
     "t"
 }
-"However, literals with locals in them actually expand into code for constructing a new object:"
+"However, literals with lexical variables in them actually construct a new object:"
 { $example
     "USING: locals splitting ;"
     "IN: scratchpad"

    "locals-fry"
    "locals-limitations"
}
"Local variables complement " { $link "namespaces" } "." ;

ABOUT: "locals"

    "        { [ a 0 = ] [ ... ] }"
    "    } swap swap cond ;"
}
"The reason is that lexical variable references are rewritten into stack code at parse time, whereas macro expansion is performed later during compile time. To circumvent this problem, the " { $vocab-link "macros.expander" } " vocabulary is used to rewrite simple macro usages prior to lexical variable transformation. However, " { $vocab-link "macros.expander" } " cannot deal with more complicated cases where the literal inputs to the macro do not immediately precede the macro call in the source." ;

ARTICLE: "locals" "Lexical variables"
"The " { $vocab-link "locals" } " vocabulary provides lexically scoped local variables. Full closure semantics, both downward and upward, are supported. Mutable variable bindings are also provided, supporting assignment to bindings in the current scope or in outer scopes."
{ $subsections
    "locals-examples"
}
"Word definitions where the inputs are bound to lexical variables:"
{ $subsections
    POSTPONE: ::
    POSTPONE: M::
