Index: /trunk/data/defaultpresets.xml
===================================================================
--- /trunk/data/defaultpresets.xml	(revision 7666)
+++ /trunk/data/defaultpresets.xml	(revision 7667)
@@ -8,162 +8,8 @@
     http://openclipart.org/media/view/media/clip_art
     http://www.sjjb.co.uk/mapicons/ (meanwhile in osm svn)
+
+    Format description: https://josm.openstreetmap.de/wiki/TaggingPresets
 -->
-<!--
-item:
-  name: the text to display
-  icon: the icon to display
-  - relative to the icon path
-  - URL's are also supported to allow remote icons (are cached locally)
-  type: the data types - way,node,relation,closedway (separated by comma)
-  name_template: define custom formatting for OSM primitives
-                 see https://josm.openstreetmap.de/wiki/NameTemplate
-  preset_name_label: whether to insert "[preset name]" label in dialog
-                     (defaults to "false" for backward-compatibility on external presets)
 
-group: a group of items (same syntax as "item")
-
-link: link to the relating map features website
-  href: the URL
-
-preset_link: a link to an other preset
-  preset_name: the exact name of the preset to link to
-
-label: simple static text label
-  text: the text to display
-  icon: location of icon to display (optional)
-  icon_size: maximal size of icon (optional). If no value is given, default is 16px
-
-space: empty line
-
-optional: optional tags, short for "space" plus "label" plus "space"
-  text: the text to display (defaults to "Optional Attributes:")
-
-separator: separator line in menus
-
-item_separator: horizontal separator line between items (in window)
-
-key: fixed key/value pair to be set
-  key: key to set
-  value: value to set
-  match: none/key/key!/keyvalue/keyvalue! (default is "keyvalue!", see below for more information)
-
-text: text box
-  key: key to set
-  text: fixed label to display
-  default: default string to display (defaults to "")
-  use_last_as_default: true/false/force (default is "false")
-  auto_increment: may contain a comma separated list of integer increments or
-                  decrements, e.g. "-2,-1,+1,+2"; a button will be shown next
-                  to the text field for each value, allowing the user to select
-                  auto-increment with the given stepping. auto-increment only
-                  happens if the user selects it. default is no auto-increment;
-                  mutually exclusive with use_last_as_default.
-  match: none/key/key!/keyvalue/keyvalue! (default is "none", see below for more information)
-  length: length of input box (number of characters allowed)
-  alternative_autocomplete_keys: comma separated list of alternative keys to use for autocompletion
-
-combo: combo box, with multiple choices and possible to enter free form text
-  key: key to set
-  text: fixed label to display
-  delimiter: character that separates values (default: comma)
-  values: separated list of values
-  values_from: to use instead of "values" if the list of values has to be obtained with a Java method
-               of this form: public static String[] getValues();
-               The value must be: "full.package.name.ClassName#methodName"
-  display_values: comma separated list of values to be displayed instead of the
-                  database values, order and number must be equal to values
-  short_descriptions: comma separated list of texts to be displayed below each
-                      display_value. (Only if it is not possible to describe
-                      the entry in 2-3 words.) Instead of comma separated list
-  instead using values, display_values and short_descriptions, the following form is also supported:
-    <list_entry value="" display_value="" short_description="" icon="" icon_size="" />
-        icon: location of icon
-        icon_size: maximal size of icon. If tag is not setup it is taken default size of icon file
-  default: default string to display (defaults to "")
-  use_last_as_default: true/false/force (default is "false")
-  editable: allow to add other values as text (default is "true")
-  match: none/key/key!/keyvalue/keyvalue! (default is none, see below for more information)
-  values_searchable: true/false (whether to search in combo (display_)values when searching for presets)
-  length: length of input box (number of characters allowed)
-
-multiselect: list of values from which zero or more can be selected
-  key: key to set
-  text: fixed label to display
-  delimiter: character that separates values (default: semicolon) - this
-             will also be used to separate selected values in the tag.
-  values: delimiter-separated list of values (delimiter can be escaped with backslash)
-  values_from: to use instead of "values" if the list of values has to be obtained with a Java method
-               of this form: public static String[] getValues();
-               The value must be: "full.package.name.ClassName#methodName"
-  rows: specify the number of rows to display (default -1)
-  display_values: delimiter-separated list of values to be displayed instead of the
-                  database values, order and number must be equal to values
-  short_descriptions: delimiter-separated list of texts to be displayed below each
-                      display_value. (Only if it is not possible to describe
-                      the entry in 2-3 words.) Instead of a separated list
-  instead using values, display_values and short_descriptions, the following form is also supported:
-    <list_entry value="" display_value="' short_description="" icon="" icon_size="" />
-        icon: location of icon
-        icon_size: maximal size of icon. If tag is not setup it is taken default size of icon file
-  default: default string to display (defaults to "")
-  use_last_as_default: true/false/force (default is "false")
-  match: none/key/key!/keyvalue/keyvalue! (default is "none", see below for more information)
-  values_searchable: true/false (whether to search in multiselect (display_)values when searching for presets)
-
-checkgroup: group of checks
-  columns: number of columns
-
-check: checkbox
-  key: key to set
-  text: fixed label to display
-  default: ticked on/off (default is "off")
-  value_on: the value to set when checked (default is "yes")
-  value_off: the value to set when unchecked (default is "no")
-  disable_off: whether the off value is disabled in the dialog, i.e., only unset or yes are provided
-  match: none/key/key!/keyvalue/keyvalue! (default is "none", see below for more information)
-
-role: type to specify possible roles in relations
-  key: the role name used in relation
-  text: fixed label to display
-  requisite: optional/required (default is "optional")
-  count: how often can the role occur (if not given unlimited number is assumed)
-  type: the data types - way,node,relation,closedway (separated by comma)
-  member_expression: an expression (cf. search dialog) for objects of this role
-
-chunk: a template of elements for later (repeated) use
-  id: the unique identifier for this chunk
-
-reference: include an earlier defined template
-  ref: the unique identifier of the (already defined) template to include
-
- presets: For external files <presets> should have following attributes:
-   author: the author of the preset
-   version: a version number of some sort (e.g. creation date)
-   description: what is your preset meant to be
-   shortdescription: very short description
-   link: a link to a helpful website (optional)
-   icon: an icon for the whole presets
- The fields description, shortdescription and link may also be localized (e.g. de.link)
-
-See also https://josm.openstreetmap.de/wiki/TaggingPresets wiki page.
-
-The fields "name", "text", "display_values" may also be localized (e.g. de.name).
-When translations of equal words but different meanings may conflict, a translation
-context should be specified. Use "name_context", "text_context" or "values_context"
-for this. The context should be a meaningful short description to help translators.
-
-In JOSM internally all "name", "text" and "display_values" are translated when
-no specific translation has been given in XML file. When no "display_values"
-are supplied, then "values" will be treated as "display_values" and translated instead.
-
-The match attribute allows to change the matching process, i.e., determining whether
-the tags of an OSM object fit into this preset.
- - none: neutral, i.e., do not consider this item for matching
- - key: positive if key matches, neutral otherwise
- - key!: positive if key matches, negative otherwise
- - keyvalue: positive if key and value matches, neutral otherwise
- - keyvalue!: positive if key and value matches, negative otherwise
-Note that for a match, at least one positive and no negative is required.
--->
     <!-- Item chunks -->
     <chunk id="surface">