document another gotcha that seems to bite lots of people