javadoc updated for nul, empty string...