Sleep is the wrong primitive for a machine you want to reach

How Rest mode came about, why it is implemented four separate times, and the platform-specific ways holding a computer awake goes quietly wrong.