sched: improve doxygen comments