I would prefer it if this javadoc told users what to use instead.