Documentation Flaw for "binding"

4 views
Skip to first unread message

Curran Kelleher

unread,
May 12, 2009, 7:48:39 PM5/12/09
to Clojure
Hello,

Clojure's documentation is incredible, kudos to Rich Hickey! However
I'd like to bring attention to one sentence in the docs which
definitely needs revision:

"Bindings created with binding can be assigned to, which provides a
means for nested contexts to communicate with code before it the call
stack." - http://clojure.org/vars

"code before it" - "it" refers to ...nested contexts (plural)?
"before it the call stack" - that's just nonsensical

Should that be "before it [in] the call stack"? ..meaning

"Bindings created with binding can be assigned to, which provides a
means for nested contexts to communicate with one another without the
need to propagate values up and down the call stack as return values
and arguments."

or

"Bindings created with binding can be assigned to, which provides a
means for code to communicate with code above it in the call stack."

Is one of these the intended meaning of that sentence?

Thanks to everyone for being such a vibrant community. Clojure rocks!

Best,
Curran
Reply all
Reply to author
Forward
0 new messages