Document wl_display_add_socket_auto and elaborate on display socket lookup
This MR extracts and slightly expands on some of the documentation improvements from !113 . See commit messages.
This MR extracts and slightly expands on some of the documentation improvements from !113 . See commit messages.