improve javadoc; don't crash on empty lines