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

Hudson commented on ZOOKEEPER-1262:
-----------------------------------

Integrated in ZooKeeper-trunk #1389 (See 
[https://builds.apache.org/job/ZooKeeper-trunk/1389/])
    ZOOKEEPER-1262. Documentation for Lock recipe has major flaw. (Jordan 
Zimmerman via mahadev)

mahadev : 
http://svn.apache.org/viewcvs.cgi/?root=Apache-SVN&view=rev&rev=1212166
Files : 
* /zookeeper/trunk/CHANGES.txt
* /zookeeper/trunk/docs/bookkeeperConfig.pdf
* /zookeeper/trunk/docs/bookkeeperOverview.pdf
* /zookeeper/trunk/docs/bookkeeperProgrammer.pdf
* /zookeeper/trunk/docs/bookkeeperStarted.pdf
* /zookeeper/trunk/docs/bookkeeperStream.pdf
* /zookeeper/trunk/docs/index.pdf
* /zookeeper/trunk/docs/javaExample.pdf
* /zookeeper/trunk/docs/linkmap.pdf
* /zookeeper/trunk/docs/recipes.html
* /zookeeper/trunk/docs/recipes.pdf
* /zookeeper/trunk/docs/releasenotes.pdf
* /zookeeper/trunk/docs/zookeeperAdmin.html
* /zookeeper/trunk/docs/zookeeperAdmin.pdf
* /zookeeper/trunk/docs/zookeeperHierarchicalQuorums.pdf
* /zookeeper/trunk/docs/zookeeperInternals.pdf
* /zookeeper/trunk/docs/zookeeperJMX.pdf
* /zookeeper/trunk/docs/zookeeperObservers.pdf
* /zookeeper/trunk/docs/zookeeperOver.pdf
* /zookeeper/trunk/docs/zookeeperProgrammers.pdf
* /zookeeper/trunk/docs/zookeeperQuotas.pdf
* /zookeeper/trunk/docs/zookeeperStarted.pdf
* /zookeeper/trunk/docs/zookeeperTutorial.pdf
* /zookeeper/trunk/src/docs/src/documentation/content/xdocs/recipes.xml

                
> Documentation for Lock recipe has major flaw
> --------------------------------------------
>
>                 Key: ZOOKEEPER-1262
>                 URL: https://issues.apache.org/jira/browse/ZOOKEEPER-1262
>             Project: ZooKeeper
>          Issue Type: Bug
>          Components: documentation
>    Affects Versions: 3.3.3
>            Reporter: Jordan Zimmerman
>            Assignee: Jordan Zimmerman
>             Fix For: 3.5.0
>
>         Attachments: patch.txt, recipes.diff, recipes.html
>
>
> The recipe for Locks documented here: 
> http://zookeeper.apache.org/doc/trunk/recipes.html#sc_recipes_Locks doesn't 
> deal with the problem of create() succeeding but the server crashing before 
> the result is returned. As written, if the server crashes before the result 
> is returned the client can never know what sequential node was created for 
> it. The way to deal with this is to embed the session ID in the node name. 
> The Lock implementation in the ZK distro does this. But, the documentation 
> will lead implementors to write bad code.

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators: 
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira

        

Reply via email to