update javadoc
safe create with null to empty list