sio: prepare for conversion to plain C.

Describe in module comments the principles of API construction
for sio.c. Add necessary comments. Add a helper function
which makes the code a little simpler.

In scope of gh-3234.