Javadoc experiments, part 1

Experimenting with Javadoc writing to be more useful in class usage.