sockets documentation stub + other minor changes