Fix spec comments for Process constants

A number of comments related to PRIORITY_ constants were inaccurate.

Explicitly warn about real-time scheduling policies, since
ill-considered use can basically wedge the device.

Test: None
Flag: DOCS_ONLY
Change-Id: I55f49c3ec424b8a10c89bb0ecfa861f559e269b7