XML Encryption 1.1 schema and related text consistency and clarity review and proposed change

I took an action to review XML Encryption 1.1 for its schema snippets and related text for consistency and clarity (ACTION-867)

(1) I notice in section 3.5.3  for "The ds:RetrievalMethod  Element" there is the following not very clear or useful schema definition:

[[

Schema Definition:

            <!--
            <attribute name='Type' type='anyURI' use='optional'/>
            -->

]]

I suggest we remove this from the document as the full schema definition is in XML SIgnature, and is clearly referenced from the section. This snippet is neither clear nor helpful.

(2)
5.3 Stream Encryption Algorithms
The restriction needs to be indented (purely editorial)

[[

Schema Definition:

    <simpleType name="KeySizeType">
    <restriction base="integer"/>
    </simpleType>

]]

(3)
5.5.2 RSA-OAEP
Suggest a blank line before the complexType for clarity (purely editorial)

[[

Schema Definition:
    <!-- use these element types as children of EncryptionMethod
      when used with RSA-OAEP -->
    <element name="OAEPparams" minOccurs="0" type="base64Binary"/>
    <element ref="ds:DigestMethod" minOccurs="0"/>
    <element name="MGF" type="xenc11:MGFType"/>
    <complexType name="MGFType">
      <complexContent>
        <restriction base="xenc11:AlgorithmIdentifierType">
          <attribute name="Algorithm" type="anyURI" use="required" />
        </restriction>
      </complexContent>
    </complexType>

]]

Please indicate agreement or concern with these changes on the list.

I'd like to incorporate these changes into the CR publication, unless there is objection. Hearing nothing before Tuesday I'll assume there is no problem and complete the change.

(This is purely editorial in my opinion, even for #1).

regards, Frederick

Frederick Hirsch
Nokia


For tracker, this should complete ACTION-867

Received on Friday, 2 March 2012 19:19:42 UTC