Update direct references to connection manager.

Use the new methods and document the methods removed and added.
Update configuration docs for connections.
Update index and promote setting encoding.
Add DSN docs.
Merge pull request #711 from cakephp/3.0-connectionmanager

3.0 connectionmanager