Summary of important user-visible changes for sockets 1.0.8:
-------------------------------------------------------------------

 ** updated function documentation with more details
