Added Javadoc to core

Reasoning behind my changes are based on:

http://www.oracle.com/technetwork/java/javase/documentation/index-137868
.html#@return
Merge branch 'iteration-5' of https://github.com/meoblast001/OnionUmlVisualization into iteration-5
More Javadoc added to core package