JavaDoc needs to be brought up to speed

Don't make the same mistake as in the predecessor to this project. Get that JavaDoc written as soon as possible and keep it up to date.