Why does the Double.valueof javadoc say it caches values, when it doesn't?

Question

In OpenJDK, for the method:

public static Double valueOf(double d)

The javadoc says:

Returns a Double instance repre

Answer 1

The designers of the API probably didn’t want to restrict alternate implementation. Those are now free to add caching to the Double class.