Updated javadocs per @turt2live's comments