[avro] branch master updated: AVRO-2849: Update spec to clarify valid namespaces (#917)

[rs...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

rskraba pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/avro.git


The following commit(s) were added to refs/heads/master by this push:
     new 9a33ed5  AVRO-2849: Update spec to clarify valid namespaces (#917)
9a33ed5 is described below

commit 9a33ed5498a68b58fc0d3d667d64899bed1fceeb
Author: emkornfield <em...@gmail.com>
AuthorDate: Fri Jun 12 01:29:23 2020 -0700

    AVRO-2849: Update spec to clarify valid namespaces (#917)
    
    - Adds the grammar as discussed on the mailing list:
    https://lists.apache.org/thread.html/r93c4142922587ceefab78d2695570778b22a51e4bd140fd58c21984b%40%3Cdev.avro.apache.org%3E
    
    - Removes double "the".
---
 doc/src/content/xdocs/spec.xml | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/doc/src/content/xdocs/spec.xml b/doc/src/content/xdocs/spec.xml
index cd029d3..94fa68e 100644
--- a/doc/src/content/xdocs/spec.xml
+++ b/doc/src/content/xdocs/spec.xml
@@ -132,7 +132,7 @@
 		  impacts sort ordering of this record (optional).
 		  Valid values are "ascending" (the default),
 		  "descending", or "ignore".  For more details on how
-		  this is used, see the the <a href="#order">sort
+		  this is used, see the <a href="#order">sort
 		  order</a> section below.</li>
 		<li><code>aliases:</code> a JSON array of strings, providing
 		  alternate names for this field (optional).</li>
@@ -284,6 +284,10 @@
         null namespace.
         Equality of names (including field names and enum symbols)
         as well as fullnames is case-sensitive.</p>
+        <p> The null namespace may not be used in a dot-separated
+        sequence of names.  So the grammar for a namespace
+        is:</p>
+        <p>&nbsp;&nbsp;<code>&lt;empty&gt; | &lt;name&gt;[(&lt;dot&gt;&lt;name&gt;)*]</code></p>
         <p>In record, enum and fixed definitions, the fullname is
         determined in one of the following ways:</p>
 	<ul>