Index: trunk/src/org/openstreetmap/josm/data/preferences/CachedProperty.java
===================================================================
--- trunk/src/org/openstreetmap/josm/data/preferences/CachedProperty.java	(revision 12384)
+++ trunk/src/org/openstreetmap/josm/data/preferences/CachedProperty.java	(revision 12385)
@@ -6,4 +6,11 @@
 import org.openstreetmap.josm.data.Preferences.PreferenceChangedListener;
 
+/**
+ * This is an old-style cached preference value.
+ *
+ * You can replace this using the {@link StringProperty#cached()}, {@link BooleanProperty#cached()} accessors
+ *
+ * @param <T> The value type of this property
+ */
 public abstract class CachedProperty<T> extends AbstractProperty<T> implements PreferenceChangedListener {