Niraj Tolia created ZOOKEEPER-1786:
--------------------------------------
Summary: ZooKeeper data model documentation is incorrect
Key: ZOOKEEPER-1786
URL: https://issues.apache.org/jira/browse/ZOOKEEPER-1786
Project: ZooKeeper
Issue Type: Bug
Components: documentation
Affects Versions: 3.4.6
Reporter: Niraj Tolia
Priority: Minor
Fix For: 3.4.6
When I look at
https://zookeeper.apache.org/doc/trunk/zookeeperProgrammers.html#ch_zkDataModel,
I see two things that seem wrong in terms of restricted characters:
* \uXFFFE - \uXFFFF (where X is a digit 1 - E)
* \uF0000 - \uFFFFF
These definitions are invalid characters in Java and aren't reflected in
PathUtils either (or PathUtilsTest). In fact the code in PathUtils states:
{code:borderStyle=solid}
} else if (c > '\u0000' && c <= '\u001f'
|| c >= '\u007f' && c <= '\u009F'
|| c >= '\ud800' && c <= '\uf8ff'
|| c >= '\ufff0' && c <= '\uffff') {
reason = "invalid charater @" + i;
break;
}
{code}
Unless I am missing something, this simple patch should fix the documentation
problem:
{code}
Index: src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml
===================================================================
--- src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml
(revision 1530514)
+++ src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml
(working copy)
@@ -139,8 +139,7 @@
<listitem>
<para>The following characters are not allowed: \ud800 - uF8FF,
- \uFFF0 - uFFFF, \uXFFFE - \uXFFFF (where X is a digit 1 - E), \uF0000 -
- \uFFFFF.</para>
+ \uFFF0 - uFFFF.</para>
</listitem>
<listitem>
{code}
--
This message was sent by Atlassian JIRA
(v6.1#6144)
