QPID-5154: Further corrections to the Connection API doc; a patch from Ernie Allen

git-svn-id: https://svn.apache.org/repos/asf/qpid/trunk@1525570 13f79535-47bb-0310-9956-ffa450edef68