java doc for new methods