From: Mike Curtiss <mcurtiss@fb.com>
Date: Thu, 16 May 2013 18:16:37 +0000 (-0700)
Subject: Gen apply comment
X-Git-Tag: v0.22.0~968
X-Git-Url: http://demsky.eecs.uci.edu/git/?a=commitdiff_plain;h=b297ef2d39823ef74e1be98c6f9329e5173af928;p=folly.git

Gen apply comment

Summary: Comment

Test Plan: Builds

Reviewed By: tjackson@fb.com

FB internal diff: D814986
---

diff --git a/folly/experimental/Gen-inl.h b/folly/experimental/Gen-inl.h
index 6a90d266..e8861d0b 100644
--- a/folly/experimental/Gen-inl.h
+++ b/folly/experimental/Gen-inl.h
@@ -156,10 +156,10 @@ class GenImpl : public FBounded<Self> {
 
   /**
    * apply() - Send all values produced by this generator to given
-   * handler until the handler returns false. Returns true until the handler
-   * returns false. GOTCHA: It should return true even if it completes (without
-   * the handler returning false), as 'Chain' uses the return value of apply
-   * to determine if it should process the second object in its chain.
+   * handler until the handler returns false. Returns false if and only if the
+   * handler returns false. Note: It should return true even if it completes
+   * (without the handler returning false), as 'Chain' uses the return value of
+   * apply to determine if it should process the second object in its chain.
    */
   template<class Handler>
   bool apply(Handler&& handler) const;