net: sockets: Update zsock_poll() API documentation

It is no longer true that zsock_poll() works only with networking
sockets, we now support for example eventfd objects which can also be
polled. Therefore just remove the outdated comment in the zsock_poll()
documentation, as it is misleading.

Signed-off-by: Robert Lubos <robert.lubos@nordicsemi.no>