Function documentation is missing for BSD sockets

[jukkar]

The BSD socket API function documentation is missing in include/net/socket.h

[pfalcon]

That's true but BSD Socket API is intended to implement standard POSIX API, as described in http://pubs.opengroup.org/onlinepubs/9699919799/ . Beyond that, it's unclear where exactly (as belonging to which part) it should be described. I first would like sockets API to be integrated with POSIX subsystems, then we can decide where docs belong.

Thus, changing this to "enhancement".

[jukkar]

We have a section for BSD sockets in the documentation and currently the zsock_ xxx() API functions are empty. This is definitely a bug and not enhancement so putting the proper label back.

[pfalcon]

#13495 at least updates the intro section.

[nashif]

The API documentation can refer to whatever posix standard we are implementing, right now it is empty and it is not clear how those should be used:

https://docs.zephyrproject.org/latest/reference/networking/sockets.html