You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@ws.apache.org by ve...@apache.org on 2011/07/21 11:37:24 UTC
svn commit: r1149091 -
/webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml
Author: veithen
Date: Thu Jul 21 09:37:22 2011
New Revision: 1149091
URL: http://svn.apache.org/viewvc?rev=1149091&view=rev
Log:
AXIOM-372: Started to add a section about illegal namespace declarations to the user guide (not yet finished).
Modified:
webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml
Modified: webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml
URL: http://svn.apache.org/viewvc/webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml?rev=1149091&r1=1149090&r2=1149091&view=diff
==============================================================================
--- webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml (original)
+++ webservices/commons/trunk/modules/axiom/src/docbkx/userguide.xml Thu Jul 21 09:37:22 2011
@@ -1240,6 +1240,36 @@ while (iterator.hasNext()) {
<section id="changes-1.2.13">
<title>Changes in Axiom 1.2.13</title>
<section>
+ <title>Handling of illegal namespace declarations</title>
+ <para>
+ Both XML 1.0 and XML 1.1 forbid binding a namespace prefix to the empty namespace name.
+ Only the default namespace can have an empty namespace name.
+ In XML 1.0, prefixed namespace bindings may not be empty, as explained in section 5 of
+ <xref linkend="bib.xmlns"/>:
+ </para>
+ <blockquote>
+ <para>
+ In a namespace declaration for a prefix (i.e., where the NSAttName is a PrefixedAttName), the
+ attribute value MUST NOT be empty.
+ </para>
+ </blockquote>
+ <para>
+ In XML 1.1, prefixed namespace bindings may be empty, but rather than binding the empty namespace name
+ to a prefix, such a namespace declaration "unbinds" the prefix, as explained in section 5
+ of <xref linkend="bib.xmlns11"/>:
+ </para>
+ <blockquote>
+ <para>
+ The namespace prefix, unless it is <literal>xml</literal> or <literal>xmlns</literal>, must
+ have been declared in a namespace declaration attribute in either the start-tag of the
+ element where the prefix is used or in an ancestor element
+ (i.e. an element in whose content the prefixed markup occurs). Furthermore, the attribute
+ value in the innermost such declaration must not be an empty string.
+ </para>
+ </blockquote>
+
+ </section>
+ <section>
<title>New abstract APIs</title>
<para>
Axiom 1.2.13 introduces a couple of new abstract APIs which give implementations of the Axiom API
@@ -1644,6 +1674,18 @@ public class TestOMBuilder {
<publishername>W3C Recommendation</publishername>
<pubdate>26 November 2008</pubdate>
</biblioentry>
+ <biblioentry id="bib.xmlns">
+ <abbrev>XMLNS</abbrev>
+ <title><ulink url="http://www.w3.org/TR/2009/REC-xml-names-20091208/">Namespaces in XML 1.0 (Third Edition)</ulink></title>
+ <publishername>W3C Recommendation</publishername>
+ <pubdate>8 December 2009</pubdate>
+ </biblioentry>
+ <biblioentry id="bib.xmlns11">
+ <abbrev>XMLNS11</abbrev>
+ <title><ulink url="http://www.w3.org/TR/2006/REC-xml-names11-20060816/">Namespaces in XML 1.1 (Second Edition)</ulink></title>
+ <publishername>W3C Recommendation</publishername>
+ <pubdate>16 August 2006</pubdate>
+ </biblioentry>
</bibliodiv>
</bibliography>
</book>