julianhyde commented on a change in pull request #1554: [CALCITE-3462] Add 
method in RelBuilder for conveniently projecting out expressions
URL: https://github.com/apache/calcite/pull/1554#discussion_r355782129
 
 

 ##########
 File path: core/src/main/java/org/apache/calcite/tools/RelBuilder.java
 ##########
 @@ -1189,8 +1187,8 @@ public RelBuilder filter(Iterable<? extends RexNode> 
predicates) {
     return filter(ImmutableSet.of(), predicates);
   }
 
-  /** Creates a {@link Filter} of a list of correlation variables
-   * and an array of predicates.
+  /** Creates a {@link Filter} with the specified correlation variables
+   * and predicates.
 
 Review comment:
   I prefer "list of". It's plainer english, less lawyerly. (If "Iterable" were 
an english word, I'd say use that. But it isn't.)
   
   Also, I believe that two overloads of the same method should have different 
descriptions. We should not have two methods both with the description "Creates 
a {@link Filter} with the specified predicates."

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to