docs-update

just to fill in the gaps with documenting the codebase - have applied javadoc comments to most class declarations and method signatures.