include: mgmt: mcumgr: doc: massive doxygen makeover

This cleans up the doxygen documentation for the MCUmgr subsystem
(consolidated the doxygen groups, added some missing docs, added proper
@name'd sections where appropriate, etc).

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