good spot -- i just copied the method but the javadoc is definitely wrong.  i will amend the javadoc for now, since we haven't noticed any problems...