This is an automated email from the ASF dual-hosted git repository.
cutting 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 764c932 Updated spec to agree with implementation of AVRO-1340 (#357)
764c932 is described below
commit 764c9322c136f0e3b8bd1e3f646d683321927e1a
Author: Raymie Stata <[email protected]>
AuthorDate: Thu Oct 25 15:36:04 2018 -0700
Updated spec to agree with implementation of AVRO-1340 (#357)
* Updated spec to agree with implementation of AVRO-1340
* Improvement
---
doc/src/content/xdocs/spec.xml | 11 ++++++++++-
1 file changed, 10 insertions(+), 1 deletion(-)
diff --git a/doc/src/content/xdocs/spec.xml b/doc/src/content/xdocs/spec.xml
index 3a680a2..fd780f9 100644
--- a/doc/src/content/xdocs/spec.xml
+++ b/doc/src/content/xdocs/spec.xml
@@ -172,6 +172,14 @@
be unique; duplicates are prohibited. Every symbol must
match the regular expression <code>[A-Za-z_][A-Za-z0-9_]*</code>
(the same requirement as for <a href="#names">names</a>).</li>
+ <li><code>default</code>: A default value for this
+ enumeration, used during resolution when the reader
+ encounters a symbol from the writer that isn't defined
+ in the reader's schema (optional). The value provided
+ here must be a JSON string that's a member of
+ the <code>symbols</code> array.
+ See documentation on schema resolution for how this gets
+ used.</li>
</ul>
<p>For example, playing card suits might be defined with:</p>
<source>
@@ -1139,7 +1147,8 @@
<li><strong>if both are enums:</strong>
<p>if the writer's symbol is not present in the reader's
- enum, then an error is signalled.</p>
+ enum and the reader has a <code>default</code> value, then
+ that value is used, otherwise an error is signalled.</p>
</li>
<li><strong>if both are arrays:</strong>
