Updated $controller API doc wrt return value

Fixed the documentation for $controller to clarify that the return value
may be either the controller instance, or the object returned by the
controller constructor function. Also added a note about what the effect
of writing the controller construction function in CoffeeScript can be.