Changeset 4635 in josm for trunk/src/org/openstreetmap/josm/data

Timestamp:

04.12.2011 20:00:58 (6 months ago)

Author:

bastiK

Message:

status report should use new xml preference file (see #7027)

File:

• trunk/src/org/openstreetmap/josm/data/Preferences.java (modified) (3 diffs)

trunk/src/org/openstreetmap/josm/data/Preferences.java

@@ -61 +61 @@
  * saved upon set-access.
  *
- * Each property is a simple key=value pair of Strings.
+ * Each property is a key=setting pair, where key is a String and setting can be one of
+ * 4 types:
+ *     string, list, list of lists and list of maps.
  * In addition, each key has a unique default value that is set when the value is first
  * accessed using one of the get...() methods. You can use the same preference
@@ -69 +71 @@
  * off all possible settings.
  *
- * At the moment, there is no such thing as an empty value.
- * If you put "" or null as value, the property is removed.
+ * At the moment, you cannot put the empty string for string properties.
+ * put(key, "") means, the property is removed.
  *
  * @author imi
@@ -83 +85 @@
 
     /**
-     * Map the property name to the property object. Does not contain null or "" values.
+     * Map the property name to strings. Does not contain null or "" values.
      */
     protected final SortedMap<String, String> properties = new TreeMap<String, String>();
+    /** Map of defaults, can contain null values */
     protected final SortedMap<String, String> defaults = new TreeMap<String, String>();
     protected final SortedMap<String, String> colornames = new TreeMap<String, String>();
 
+    /** Mapping for list settings. Must not conatin null values */
     protected final SortedMap<String, List<String>> collectionProperties = new TreeMap<String, List<String>>();
+    /** Defaults, can contain null values */
     protected final SortedMap<String, List<String>> collectionDefaults = new TreeMap<String, List<String>>();