Confining grading to selection

The manual for P2020 (yes, it's error-ridden) says that a selection can be filled with a gradient, by dragging within the selection. Not true. The whole canvas is filled.