emberjs/ember.js — pull request #1271 by elucid (2012-08-14 16:08:30+00:00)
Title: change `controllers` property to `router` in controllers injection

The documentation [here](https://github.com/emberjs/ember.js/blob/master/packages/ember-application/lib/system/application.js#L102) indicates that controllers automatically instantiated by a router end up with a `router` property pointing back to it. This would be useful not only for grabbing non-global references to other automatically instantiated controllers but also for sending events to the router. However, the property isn't actually set.

I initially thought to just add an additional `router` property in the controllers injection but noticed the `controllers` property and how it is used by controllers. Rather than doing this, it seemed to make more sense to just rename the `controllers` property rather than add yet another reference to the same object.

AFAICT the `controllers` property is only used internally. It's not documented and I haven't seen any example apps using it directly.