Lots of JavaDoc improvements again, focusing on basic API-s. Some variable/field renamings along the way.