javadoc: methods for creating tokens documented