Improving sched.h documentation

According to @kaspar030`s suggestions.