kern/38887: manual pages should describe basic realtime info better

[ad%netbsd.org@localhost]

>Number:         38887
>Category:       kern
>Synopsis:       manual pages should describe basic realtime info better
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    kern-bug-people
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Sat Jun 07 22:30:00 +0000 2008
>Originator:     Andrew Doran
>Release:        4.99.64
>Organization:
The NetBSD Project
>Environment:
n/a
>Description:
Looking at the manual pages for the various realtime components we have 
like schedctl, it's not obvious that SCHED_FIFO and SCHED_RR are realtime 
scheduling classes and that SCHED_OTHER is not. To understand that you
have to have spent a while reading the POSIX spec first.

Also, we don't have a description of:

- each class as defined by POSIX, in brief
- if any class takes priority over another
- will cause kernel preemption

>How-To-Repeat:
Look at a few of the manual pages.
>Fix:
Spend some time writing documentation. :-)