W3C home > Mailing lists > Public > public-xmlsec@w3.org > May 2010

Re: ACTION-570: namespace text in generic-hybrids

From: Thomas Roessler <tlr@w3.org>
Date: Tue, 4 May 2010 18:28:26 +0200
Cc: XMLSec WG Public List <public-xmlsec@w3.org>
Message-Id: <80CC7069-A98C-40CA-A547-C40D3BC98BF9@w3.org>
To: Thomas Roessler <tlr@w3.org>
Looking again, we actually have duplicate text.  So, a more complete suggestion:

Before:

> No provision is made for an explicit version number in this syntax. If a future version is needed, it will use a different namespace. The XML namespace [XML-NAMES] URI that must be used by implementations of this (dated) specification is:
> 
> xmlns gh="http://www.w3.org/2009/xmlsec-gh#"
> Warning: this namespace URI is currently subject to change.
> This namespace is also used as the prefix for identifiers defined by this specification. While applications must support XML and XML namespaces, the use of internal entities or our gh XML namespace prefix and defaulting/scoping conventions are optional; we use these facilities to provide compact and readable examples.
> 
> This specification uses Uniform Resource Identifiers [URI] to identify resources, algorithms, and semantics. The URI in the namespace declaration above is also used as a prefix for URIs under the control of this specification.
> 
> This document does not change the URI associated with XML Encryption itself.

After:

> No provision is made for an explicit version number in this syntax. If a future version is needed, it will use a different namespace. The XML namespace [XML-NAMES] URI that must be used by implementations of this (dated) specification is:
> 
> xmlns gh="http://www.w3.org/2009/xmlsec-gh#"
> Warning: this namespace URI is currently subject to change.
> 
> While applications must support XML and XML namespaces, the use of internal entities or the gh XML namespace prefix is optional; we use these facilities to provide compact and readable examples.
> 
> This specification uses Uniform Resource Identifiers [URI] to identify resources, algorithms, and semantics. Identifiers under the control of this specification are coined within the scope of the above namespace.

(In fact, we use the "prefix" language in Signature, too, but it's unambiguous there since it is in a paragraph that's separate from the language about the XML namespace prefix.)

--
Thomas Roessler, W3C  <tlr@w3.org>







On 4 May 2010, at 18:04, Thomas Roessler wrote:

> We currently say:
> 
>> This namespace is also used as the prefix for identifiers defined by this specification.
> 
> I propose instead:
> 
>> This namespace is also used for identifier URIs defined by this specification.
> 
> The rest of the txt is ok, since the use of "gh" for the XML namespace prefix is indeed notation only; the use of the URIs isn't.  Using "prefix" to describe the use of the namespace in coining URIs created the confusion here.
> 
> Regards,
> --
> Thomas Roessler, W3C  <tlr@w3.org>
> 
> 
> 
> 
> 
> 
> 
Received on Tuesday, 4 May 2010 16:28:29 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 4 May 2010 16:28:29 GMT