Some doc improvements
Merge pull request #1248 from sba1/doc-fix

Some doc improvements in transport.h