diff --git a/xep-0004.xml b/xep-0004.xml index 5a73b854..c5d903a5 100644 --- a/xep-0004.xml +++ b/xep-0004.xml @@ -27,6 +27,17 @@ &jer; &temas; &stpeter; + + 2.12.0 + 2021-11-27 + fs, jsc + +

+ Clarify that the 'reported' element must appear before any + 'item' element. +

+ + 2.11.0 2020-09-29 @@ -295,6 +306,10 @@
  • One and only <reported/> element, which can be understood as a "table header" describing the data to follow.
  • Zero or more <item/> elements, which can be understood as "table cells" containing data (if any) that matches the request.
    • +

    The <reported/> element MUST appear before any <item/> element inside the <x/> element.

    +

    + Older revisions of this XEP (before 2.12.0) did not contain an explicit requirement for the ordering between <reported> and <item>. Implementations are therefore encouraged to be flexible when processing incoming data, as there might still be implementations which do not implement a strict ordering when generating reports. +

    The syntax is as follows:

    ]]> -

    Each of these elements MUST contain one or more <field/> children. The <reported/> element defines the data format for the result items by specifying the fields to be expected for each item; for this reason, the <field/> elements SHOULD possess a 'type' attribute and 'label' attribute in addition to the 'var' attribute, and SHOULD NOT contain a <value/> element. Each <item/> element defines one item in the result set, and MUST contain each field specified in the <reported/> element (although the XML character data of the <value/> element MAY be null).

    +

    Each of these <item/> elements and the <reported/> element MUST contain one or more <field/> children. The <reported/> element defines the data format for the result items by specifying the fields to be expected for each item; for this reason, its <field/> elements SHOULD possess a 'type' attribute and 'label' attribute in addition to the 'var' attribute, and SHOULD NOT contain a <value/> element. Each <item/> element defines one item in the result set, and MUST contain each field specified in the <reported/> element (although the XML character data of the <value/> element MAY be null).