exchange

commit 165f5780507fa50f6a6979edad5a4db83f0a7732
parent 281e292bb1edc082ac0cf4ab6ba6af11a1d21adc
Author: Christian Grothoff <christian@grothoff.org>
Date:   Sun, 11 Oct 2026 14:07:11 +0200

clarify start_row usage

Diffstat:
M
src/include/taler/taler_bank_service.h
 | 
14
++++++++++++--

1 file changed, 12 insertions(+), 2 deletions(-)
diff --git a/src/include/taler/taler_bank_service.h b/src/include/taler/taler_bank_service.h
@@ -811,7 +811,12 @@ typedef void
  *
  * @param ctx curl context for the event loop
  * @param auth authentication data to use
- * @param start_row from which row on do we want to get results, use UINT64_MAX for the latest; exclusive
+ * @param start_row from which row on do we want to get results, exclusive;
+ *                  UINT64_MAX with a negative @a num_results starts at the
+ *                  latest row, and 0 with a positive @a num_results starts
+ *                  at the beginning of the history; UINT64_MAX with a
+ *                  positive @a num_results (or 0 with a negative one) is
+ *                  sent to the bank verbatim and thus matches no row at all
  * @param num_results how many results do we want; negative numbers to go into the past,
  *                    positive numbers to go into the future starting at @a start_row;
  *                    must not be zero.
@@ -968,7 +973,12 @@ typedef void
  *
  * @param ctx curl context for the event loop
  * @param auth authentication data to use
- * @param start_row from which row on do we want to get results, use UINT64_MAX for the latest; exclusive
+ * @param start_row from which row on do we want to get results, exclusive;
+ *                  UINT64_MAX with a negative @a num_results starts at the
+ *                  latest row, and 0 with a positive @a num_results starts
+ *                  at the beginning of the history; UINT64_MAX with a
+ *                  positive @a num_results (or 0 with a negative one) is
+ *                  sent to the bank verbatim and thus matches no row at all
  * @param num_results how many results do we want; negative numbers to go into the past,
  *                    positive numbers to go into the future starting at @a start_row;
  *                    must not be zero.