This confusion happens often enough that I installed the attached documentation patch to try to make things clearer.