Javadoc docs completed

Complete for now.  Really need to reduce documentation debt going
forwards!