Add pagination to SafeSql

Author: fluentfuture

mug-safesql/src/main/java/com/google/mu/safesql/SafeSql.java

@@ -982,8 +982,9 @@ public <T> Optional<T> queryForOne(
    * If {@code orderByKeys} is empty, the paginated query will use {@code OFFSET} keyword
    * instead of the sort key columns to specify the next page offset.
    * 
-   * <p>All column names are automatically double-quoted to avoid clashing with keywords or spaces
-   * in identifiers. If your DB is case sensitive, make sure you pass in the accurate case.
+   * <p>The {@code orderByKeys} column names are automatically double-quoted to avoid clashing
+   * with keywords or spaces in identifiers. 
+   * If your DB is case sensitive, make sure you pass in the accurate case.
    * 
    * <p>The method is lazy. Paginated queries are only sent when the returned stream is consumed.
    * The caller should close the {@code connection} after done, which will close the cached
@@ -1022,8 +1023,9 @@ public <T> Stream<List<T>> paginateLazily(
    * If {@code orderByKeys} is empty, the paginated query will use {@code OFFSET} keyword
    * instead of the sort key columns to specify the next page offset.
    * 
-   * <p>All column names are automatically double-quoted to avoid clashing with keywords or spaces
-   * in identifiers. If your DB is case sensitive, make sure you pass in the accurate case.
+   * <p>The {@code orderByKeys} column names are automatically double-quoted to avoid clashing
+   * with keywords or spaces in identifiers. 
+   * If your DB is case sensitive, make sure you pass in the accurate case.
    * 
    * <p>The method is lazy. Paginated queries are only sent when the returned stream is consumed.
    * The caller should close the {@code connection} after done, which will close the cached
@@ -1065,8 +1067,9 @@ public <T> Stream<List<T>> paginateLazily(
    * If {@code orderByKeys} is empty, the paginated query will use {@code OFFSET} keyword
    * instead of the sort key columns to specify the next page offset.
    * 
-   * <p>All column names are automatically double-quoted to avoid clashing with keywords or spaces
-   * in identifiers. If your DB is case sensitive, make sure you pass in the accurate case.
+   * <p>The {@code orderByKeys} column names are automatically double-quoted to avoid clashing
+   * with keywords or spaces in identifiers. 
+   * If your DB is case sensitive, make sure you pass in the accurate case.
    * 
    * <p>The method is lazy. Paginated queries are only sent when the returned stream is consumed.
    * The caller should close the {@code connection} after done, which will close the cached
@@ -1105,8 +1108,9 @@ public <T> Stream<List<T>> paginateLazily(
    * If {@code orderByKeys} is empty, the paginated query will use {@code OFFSET} keyword
    * instead of the sort key columns to specify the next page offset.
    * 
-   * <p>All column names are automatically double-quoted to avoid clashing with keywords or spaces
-   * in identifiers. If your DB is case sensitive, make sure you pass in the accurate case.
+   * <p>The {@code orderByKeys} column names are automatically double-quoted to avoid clashing
+   * with keywords or spaces in identifiers. 
+   * If your DB is case sensitive, make sure you pass in the accurate case.
    * 
    * <p>The method is lazy. Paginated queries are only sent when the returned stream is consumed.
    * The caller should close the {@code connection} after done, which will close the cached