improved javadoc that was confusingly talking about strings