tweaked some javadocs so I won't keep going nuts