api: document socket

extra newline