Clarified the k > n case.

Instead of saying "missing neighbors are indicated...", we say now "If k > n,
missing neighbours are indicated..."

Closes #3743
Added hint to distance_upper_bound
Merge pull request #3932 from venthur/fix-3743

DOC: spatial: clarify meaning of "missing neighbors" in KDTree.query