You are right; I do believe this is a area where the compiler and the doc's differ in opinion. Here I feel the compiler makes the most sense and the doc's may be out of date.

More generally; I too am a bit surprised by this, not sure how long this bug has been there,

Yours,
Kas.