bluetooth: doc: Improve sdp.h Doxygen doc

Grouped some defines together, documented service classes and
attributes, and fixed some missing javadoc-style comments.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>