- cache ref didn't work because it referred to a private variable (which isn't documented) from a public interface definition (which is). Meaning the Javadoc generator was trying to link to documentation that didn't exist.
