doc: kernel: Fix Doxygen comments for stats.h

Cleanup doxygen documentation by adding missing comments + enabling
docs for fields guarded by CONFIG_SCHED_THREAD_USAGE_ANALYSIS.

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