PROTON-191: API reconciliation tool tidy-up - removed whitespace, added comments etc

git-svn-id: https://svn.apache.org/repos/asf/qpid/proton/branches/jni-binding@1433545 13f79535-47bb-0310-9956-ffa450edef68