Index: src/java/org/apache/hadoop/hbase/client/HTable.java =================================================================== --- src/java/org/apache/hadoop/hbase/client/HTable.java (revision 902195) +++ src/java/org/apache/hadoop/hbase/client/HTable.java (working copy) @@ -2024,8 +2024,12 @@ } /** + * Get nbRows rows. + * How many RPCs are made is determined by the {@link Scan#setCaching(int)} + * setting (or hbase.client.scanner.caching in hbase-site.xml). * @param nbRows number of rows to return - * @return Between zero and nbRows RowResults + * @return Between zero and nbRows RowResults. Scan is done + * if returned array is of zero-length (We never return null). * @throws IOException */ public Result [] next(int nbRows) throws IOException {