Return-Path: Delivered-To: apmail-hadoop-zookeeper-commits-archive@minotaur.apache.org Received: (qmail 65532 invoked from network); 19 Feb 2010 02:34:00 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 19 Feb 2010 02:34:00 -0000 Received: (qmail 15589 invoked by uid 500); 19 Feb 2010 02:34:00 -0000 Delivered-To: apmail-hadoop-zookeeper-commits-archive@hadoop.apache.org Received: (qmail 15548 invoked by uid 500); 19 Feb 2010 02:33:59 -0000 Mailing-List: contact zookeeper-commits-help@hadoop.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: zookeeper-dev@ Delivered-To: mailing list zookeeper-commits@hadoop.apache.org Received: (qmail 15538 invoked by uid 99); 19 Feb 2010 02:33:59 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 19 Feb 2010 02:33:59 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 19 Feb 2010 02:33:58 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 1E80B23888DD; Fri, 19 Feb 2010 02:33:38 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r911676 - in /hadoop/zookeeper/trunk: ./ docs/ src/docs/src/documentation/content/xdocs/ Date: Fri, 19 Feb 2010 02:33:37 -0000 To: zookeeper-commits@hadoop.apache.org From: mahadev@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20100219023338.1E80B23888DD@eris.apache.org> Author: mahadev Date: Fri Feb 19 02:33:37 2010 New Revision: 911676 URL: http://svn.apache.org/viewvc?rev=911676&view=rev Log: ZOOKEEPER-672. typo nits across documentation (Kay Kay via mahadev) Modified: hadoop/zookeeper/trunk/CHANGES.txt hadoop/zookeeper/trunk/docs/javaExample.html hadoop/zookeeper/trunk/docs/javaExample.pdf hadoop/zookeeper/trunk/docs/recipes.html hadoop/zookeeper/trunk/docs/recipes.pdf hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html hadoop/zookeeper/trunk/docs/zookeeperProgrammers.pdf hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/javaExample.xml hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/recipes.xml hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml Modified: hadoop/zookeeper/trunk/CHANGES.txt URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/CHANGES.txt?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/CHANGES.txt (original) +++ hadoop/zookeeper/trunk/CHANGES.txt Fri Feb 19 02:33:37 2010 @@ -221,6 +221,8 @@ ZOOKEEPER-673. Fix observer documentation regarding leader election (flavio via mahadev) + ZOOKEEPER-672. typo nits across documentation (Kay Kay via mahadev) + IMPROVEMENTS: ZOOKEEPER-473. cleanup junit tests to eliminate false positives due to "socket reuse" and failure to close client (phunt via mahadev) Modified: hadoop/zookeeper/trunk/docs/javaExample.html URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/javaExample.html?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/docs/javaExample.html (original) +++ hadoop/zookeeper/trunk/docs/javaExample.html Fri Feb 19 02:33:37 2010 @@ -332,7 +332,7 @@ }

- Recall that the Executor's job is to starts and stop the executable whose name you pass in on the command line. + Recall that the Executor's job is to start and stop the executable whose name you pass in on the command line. It does this in response to events fired by the ZooKeeper object. As you can see in the code above, the Executor passes a reference to itself as the Watcher argument in the ZooKeeper constructor. It also passes a reference to itself as DataMonitorListener argument to the DataMonitor constructor. Per the Executor's definition, it implements both these Modified: hadoop/zookeeper/trunk/docs/javaExample.pdf URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/javaExample.pdf?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== Binary files - no diff available. Modified: hadoop/zookeeper/trunk/docs/recipes.html URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/recipes.html?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/docs/recipes.html (original) +++ hadoop/zookeeper/trunk/docs/recipes.html Fri Feb 19 02:33:37 2010 @@ -510,13 +510,13 @@ the create() call set to true. Because the sequence flag is set, the new pathnames will have the form _path-to-queue-node_/queue-X, where X is a monotonic increasing number. A - client that wants to be remove from the queue calls ZooKeeper's getChildren( ) function, with + client that wants to be removed from the queue calls ZooKeeper's getChildren( ) function, with watch set to true on the queue node, and begins processing nodes with the lowest number. The client does not need to issue another getChildren( ) until it exhausts the list obtained from the first getChildren( ) call. If there are are no children in the queue node, the - reader waits for a watch notification to check to queue again.

+ reader waits for a watch notification to check the queue again.

Priority Queues

To implement a priority queue, you need only make two simple @@ -524,7 +524,7 @@ recipe . First, to add to a queue, the pathname ends with "queue-YY" where YY is the priority of the element with lower numbers representing higher priority (just like UNIX). Second, when removing - from the queue a client uses an up-to-date children list meaning that + from the queue, a client uses an up-to-date children list meaning that the client will invalidate previously obtained children lists if a watch notification triggers for the queue node.

Modified: hadoop/zookeeper/trunk/docs/recipes.pdf URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/recipes.pdf?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== Binary files - no diff available. Modified: hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html (original) +++ hadoop/zookeeper/trunk/docs/zookeeperProgrammers.html Fri Feb 19 02:33:37 2010 @@ -510,8 +510,8 @@

In distributed application engineering, the word node can refer to a generic host machine, a server, a member of an ensemble, a client process, etc. In the ZooKeeper - documentatin, znodes refer to the data nodes. - Servers to refer to machines that make up the + documentation, znodes refer to the data nodes. + Servers refer to machines that make up the ZooKeeper service; quorum peers refer to the servers that make up an ensemble; client refers to any host or process which uses a ZooKeeper service.

@@ -556,7 +556,7 @@

Sequence Nodes -- Unique Naming

When creating a znode you can also request that - ZooKeeper append a monotonicly increasing counter to the end + ZooKeeper append a monotonically increasing counter to the end of path. This counter is unique to the parent znode. The counter has a format of %010d -- that is 10 digits with 0 (zero) padding (the counter is formatted in this way to @@ -901,7 +901,7 @@

-

One watch event will be sent to the client the data has changed. +

One watch event will be sent to the client when the data has changed. For example, if a client does a getData("/znode1", true) and later the data for /znode1 is changed or deleted, the client will get a watch event for /znode1. If /znode1 changes again, no watch event will be @@ -1606,7 +1606,7 @@

-Simultaneously Conistent Cross-Client Views +Simultaneously Consistent Cross-Client Views

ZooKeeper does not guarantee that at every instance in Modified: hadoop/zookeeper/trunk/docs/zookeeperProgrammers.pdf URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/docs/zookeeperProgrammers.pdf?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== Binary files - no diff available. Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/javaExample.xml URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/javaExample.xml?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/javaExample.xml (original) +++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/javaExample.xml Fri Feb 19 02:33:37 2010 @@ -125,7 +125,7 @@ - Recall that the Executor's job is to starts and stop the executable whose name you pass in on the command line. + Recall that the Executor's job is to start and stop the executable whose name you pass in on the command line. It does this in response to events fired by the ZooKeeper object. As you can see in the code above, the Executor passes a reference to itself as the Watcher argument in the ZooKeeper constructor. It also passes a reference to itself as DataMonitorListener argument to the DataMonitor constructor. Per the Executor's definition, it implements both these Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/recipes.xml URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/recipes.xml?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/recipes.xml (original) +++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/recipes.xml Fri Feb 19 02:33:37 2010 @@ -258,14 +258,14 @@ the create() call set to true. Because the sequence flag is set, the new pathnames will have the form _path-to-queue-node_/queue-X, where X is a monotonic increasing number. A - client that wants to be remove from the queue calls ZooKeeper's getChildren( ) function, with watch set to true on the queue node, and begins processing nodes with the lowest number. The client does not need to issue another getChildren( ) until it exhausts the list obtained from the first getChildren( ) call. If there are are no children in the queue node, the - reader waits for a watch notification to check to queue again. + reader waits for a watch notification to check the queue again.

Priority Queues @@ -275,7 +275,7 @@ recipe . First, to add to a queue, the pathname ends with "queue-YY" where YY is the priority of the element with lower numbers representing higher priority (just like UNIX). Second, when removing - from the queue a client uses an up-to-date children list meaning that + from the queue, a client uses an up-to-date children list meaning that the client will invalidate previously obtained children lists if a watch notification triggers for the queue node.
Modified: hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml URL: http://svn.apache.org/viewvc/hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml?rev=911676&r1=911675&r2=911676&view=diff ============================================================================== --- hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml (original) +++ hadoop/zookeeper/trunk/src/docs/src/documentation/content/xdocs/zookeeperProgrammers.xml Fri Feb 19 02:33:37 2010 @@ -175,8 +175,8 @@ In distributed application engineering, the word node can refer to a generic host machine, a server, a member of an ensemble, a client process, etc. In the ZooKeeper - documentatin, znodes refer to the data nodes. - Servers to refer to machines that make up the + documentation, znodes refer to the data nodes. + Servers refer to machines that make up the ZooKeeper service; quorum peers refer to the servers that make up an ensemble; client refers to any host or process which uses a ZooKeeper service. @@ -232,7 +232,7 @@ Sequence Nodes -- Unique Naming When creating a znode you can also request that - ZooKeeper append a monotonicly increasing counter to the end + ZooKeeper append a monotonically increasing counter to the end of path. This counter is unique to the parent znode. The counter has a format of %010d -- that is 10 digits with 0 (zero) padding (the counter is formatted in this way to @@ -505,7 +505,7 @@ One-time trigger - One watch event will be sent to the client the data has changed. + One watch event will be sent to the client when the data has changed. For example, if a client does a getData("/znode1", true) and later the data for /znode1 is changed or deleted, the client will get a watch event for /znode1. If /znode1 changes again, no watch event will be @@ -1103,7 +1103,7 @@ - Simultaneously Conistent Cross-Client Views + Simultaneously Consistent Cross-Client Views ZooKeeper does not guarantee that at every instance in