more java docs in equipment classes