add documentation about connection handling and a hook for async I/O
fix formatting of doxygen doc