Added some more javadocs, also affecting how the documentation is written.