Browse Source

ZOOKEEPER-567. javadoc for getchildren2 needs to mention "new in 3.3.0"

git-svn-id: https://svn.apache.org/repos/asf/hadoop/zookeeper/trunk@835519 13f79535-47bb-0310-9956-ffa450edef68
Benjamin Reed 15 years ago
parent
commit
41bd0e5f7f
2 changed files with 18 additions and 2 deletions
  1. 8 0
      src/c/include/zookeeper.h
  2. 10 2
      src/java/main/org/apache/zookeeper/ZooKeeper.java

+ 8 - 0
src/c/include/zookeeper.h

@@ -830,6 +830,8 @@ ZOOAPI int zoo_awget_children(zhandle_t *zh, const char *path,
 /**
  * \brief lists the children of a node, and get the parent stat.
  * 
+ * This function is new in version 3.3.0
+ *
  * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init
  * \param path the name of the node. Expressed as a file name with slashes 
  * separating ancestors of the node.
@@ -856,6 +858,8 @@ ZOOAPI int zoo_aget_children2(zhandle_t *zh, const char *path, int watch,
  * This function is similar to \ref zoo_aget_children2 except it allows one specify 
  * a watcher object rather than a boolean watch flag.
  *  
+ * This function is new in version 3.3.0
+ *
  * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init
  * \param path the name of the node. Expressed as a file name with slashes 
  * separating ancestors of the node.
@@ -1288,6 +1292,8 @@ ZOOAPI int zoo_wget_children(zhandle_t *zh, const char *path,
 /**
  * \brief lists the children of a node and get its stat synchronously.
  * 
+ * This function is new in version 3.3.0
+ *
  * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init
  * \param path the name of the node. Expressed as a file name with slashes 
  * separating ancestors of the node.
@@ -1312,6 +1318,8 @@ ZOOAPI int zoo_get_children2(zhandle_t *zh, const char *path, int watch,
  * This function is similar to \ref zoo_get_children except it allows one specify 
  * a watcher object rather than a boolean watch flag.
  * 
+ * This function is new in version 3.3.0
+ *
  * \param zh the zookeeper handle obtained by a call to \ref zookeeper_init
  * \param path the name of the node. Expressed as a file name with slashes 
  * separating ancestors of the node.

+ 10 - 2
src/java/main/org/apache/zookeeper/ZooKeeper.java

@@ -1312,6 +1312,8 @@ public class ZooKeeper {
      * A KeeperException with error code KeeperException.NoNode will be thrown
      * if no node with the given path exists.
      *
+     * @since 3.3.0
+     * 
      * @param path
      * @param watcher explicit watcher
      * @param stat stat of the znode designated by path
@@ -1366,6 +1368,8 @@ public class ZooKeeper {
      * A KeeperException with error code KeeperException.NoNode will be thrown
      * if no node with the given path exists.
      *
+     * @since 3.3.0
+     * 
      * @param path
      * @param watch
      * @param stat stat of the znode designated by path
@@ -1384,7 +1388,9 @@ public class ZooKeeper {
      * The Asynchronous version of getChildren. The request doesn't actually
      * until the asynchronous callback is called.
      *
-     * @see #getChildren(String, Watcher)
+     * @since 3.3.0
+     * 
+     * @see #getChildren(String, Watcher, Stat)
      */
     public void getChildren(final String path, Watcher watcher,
             Children2Callback cb, Object ctx)
@@ -1414,7 +1420,9 @@ public class ZooKeeper {
      * The Asynchronous version of getChildren. The request doesn't actually
      * until the asynchronous callback is called.
      *
-     * @see #getChildren(String, boolean)
+     * @since 3.3.0
+     * 
+     * @see #getChildren(String, boolean, Stat)
      */
     public void getChildren(String path, boolean watch, Children2Callback cb,
             Object ctx)