diff --git a/versions/3.2.0.md b/versions/3.2.0.md index eecf592e0f..fb1bac5034 100644 --- a/versions/3.2.0.md +++ b/versions/3.2.0.md @@ -3369,7 +3369,6 @@ See examples for expected behavior. | ---- | :----: | ---- | | name | `string` | Replaces the name of the element/attribute used for the described schema property. When defined within `items`, it will affect the name of the individual XML elements within the list. When defined alongside `type` being `"array"` (outside the `items`), it will affect the wrapping element if and only if `wrapped` is `true`. If `wrapped` is `false`, it will be ignored. | | namespace | `string` | The URI of the namespace definition. Value MUST be in the form of a non-relative URI. | -| prefix | `string` | The prefix to be used for the [name](#xml-name). | | attribute | `boolean` | Declares whether the property definition translates to an attribute instead of an element. Default value is `false`. | | wrapped | `boolean` | MAY be used only for an array definition. Signifies whether the array is wrapped (for example, ``) or unwrapped (``). Default value is `false`. The definition takes effect only when defined alongside `type` being `"array"` (outside the `items`). | @@ -3377,7 +3376,8 @@ This object MAY be extended with [Specification Extensions](#specification-exten The `namespace` field is intended to match the syntax of [XML namespaces](https://www.w3.org/TR/xml-names11/), although there are a few caveats: -* Versions 3.1.0, 3.0.3, and earlier of this specification erroneously used the term "absolute URI" instead of "non-relative URI", so authors using namespaces that include a fragment should check tooling support carefully. +* Versions 3.1.1 and earlier of this specification errorneously allowed to specify the namespace prefix. Only namespace URIs should be used to identify the namespaces used. The prefix functions only as a placeholder and has a meaning exclusively in the context of the XML document ([Namespaces in XML 1.0 (Third Edition)](https://www.w3.org/TR/REC-xml-names/#ns-qualnames)). +* Versions 3.1.0, 3.0.3, and earlier of this specification errorneously used the term "absolute URI" instead of "non-relative URI", so authors using namespaces that include a fragment should check tooling support carefully. * XML allows but discourages relative URI-references, while this specification outright forbids them. * XML 1.1 allows IRIs ([RFC3987](https://datatracker.ietf.org/doc/html/rfc3987)) as namespaces, and specifies that namespaces are compared without any encoding or decoding, which means that IRIs encoded to meet this specification's URI syntax requirement cannot be compared to IRIs as-is. @@ -3457,7 +3457,7 @@ animals: ... ``` -###### XML Attribute, Prefix and Namespace +###### XML Attribute and Namespace In this example, a full model definition is shown. @@ -3476,8 +3476,7 @@ In this example, a full model definition is shown. "name": { "type": "string", "xml": { - "namespace": "https://example.com/schema/sample", - "prefix": "sample" + "namespace": "https://example.com/schema/sample" } } } @@ -3498,12 +3497,21 @@ Person: type: string xml: namespace: https://example.com/schema/sample - prefix: sample ``` ```xml - - example + + example + +``` + +Another document that uses a different namespace prefix +will also match the specification and therefore +is considered equivalent to the example above: + +```xml + + example ```