Mailing-List: contact dev-help@zookeeper.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@zookeeper.apache.org
Date: Mon, 26 Jun 2017 01:11:00 +0000 (UTC)
From: "ASF GitHub Bot (JIRA)" <jira@apache.org>
To: dev@zookeeper.apache.org
Message-ID: <JIRA.13081987.1498189303000.101150.1498439460964@Atlassian.JIRA>
In-Reply-To: <JIRA.13081987.1498189303000@Atlassian.JIRA>
References: <JIRA.13081987.1498189303000@Atlassian.JIRA> <JIRA.13081987.1498189303174@jira-lw-us.apache.org>
Subject: [jira] [Commented] (ZOOKEEPER-2818) Improve the ZooKeeper#setACL
  java doc
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 7bit
archived-at: Mon, 26 Jun 2017 01:11:08 -0000


    [ https://issues.apache.org/jira/browse/ZOOKEEPER-2818?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16062467#comment-16062467 ] 

ASF GitHub Bot commented on ZOOKEEPER-2818:
-------------------------------------------

Github user brahmareddybattula commented on a diff in the pull request:

    https://github.com/apache/zookeeper/pull/291#discussion_r123914814
  
    --- Diff: src/java/main/org/apache/zookeeper/ZooKeeper.java ---
    @@ -2347,25 +2347,25 @@ public void getACL(final String path, Stat stat, ACLCallback cb,
     
         /**
          * Set the ACL for the node of the given path if such a node exists and the
    -     * given version matches the version of the node. Return the stat of the
    +     * given aclVersion matches the aclVersion of the node. Return the stat of the
          * node.
          * <p>
          * A KeeperException with error code KeeperException.NoNode will be thrown
          * if no node with the given path exists.
          * <p>
          * A KeeperException with error code KeeperException.BadVersion will be
    -     * thrown if the given version does not match the node's version.
    +     * thrown if the given aclVersion does not match the node's aclVersion.
          *
          * @param path
          * @param acl
    -     * @param version
    +     * @param aclVersion
    --- End diff --
    
    In that case dn't we need to consider remain two args(path,acl) also..? if you agree, might be handle in another jira..?


> Improve the ZooKeeper#setACL  java doc
> --------------------------------------
>
>                 Key: ZOOKEEPER-2818
>                 URL: https://issues.apache.org/jira/browse/ZOOKEEPER-2818
>             Project: ZooKeeper
>          Issue Type: Bug
>            Reporter: Brahma Reddy Battula
>
> As per discussion in [mailinglist|http://mail-archives.apache.org/mod_mbox/zookeeper-user/201706.mbox/browser],It's better improve Java doc or argument which might not mislead for new users.


--
This message was sent by Atlassian JIRA
(v6.4.14#64029)