api: document socket

include