Documentation for $dialog is wrong

[hlship]

https://github.com/angular-ui/bootstrap/blob/master/src/dialog/README.md

If I'm reading the code correctly, then:

Conflates $dialog(options) with dialog.open().

$dialog takes an optional options object to set flags and provide a resolve object.

The returned dialog object's open() method can take:

• no parameters (templateURL and controller identified in options)
• templateURL, controller name
• templateURL, controller function
• controller name
• controller function

[pkozlowski-opensource]

It will be handled in #441