DCE

28 files changed, 86 insertions, 78 deletions

diff --git a/src/auditordb/pg_get_amount_arithmetic_inconsistency.h b/src/auditordb/pg_get_amount_arithmetic_inconsistency.h
index 7cf4260fe..02f55b24c 100644
--- a/src/auditordb/pg_get_amount_arithmetic_inconsistency.h
+++ b/src/auditordb/pg_get_amount_arithmetic_inconsistency.h
@@ -24,8 +24,8 @@
  * Get information about deposit confirmations from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_amount_arithmetic_inconsistency (
   TALER_AUDITORDB_AmountArithmeticInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_AMOUNT_ARITHMETIC_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_auditor_closure_lags.h b/src/auditordb/pg_get_auditor_closure_lags.h
index 03822864e..7c1148575 100644
--- a/src/auditordb/pg_get_auditor_closure_lags.h
+++ b/src/auditordb/pg_get_auditor_closure_lags.h
@@ -28,6 +28,8 @@
  * @param cls the @e cls of this struct with the plugin-specific state
  * @param start_id row/serial ID where to start the iteration (0 from
  *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +44,4 @@ TAH_PG_get_auditor_closure_lags (
   TALER_AUDITORDB_ClosureLagsCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_AUDITOR_CLOSURE_LAGS_H
+#endif
diff --git a/src/auditordb/pg_get_bad_sig_losses.h b/src/auditordb/pg_get_bad_sig_losses.h
index 5694458d3..8cf04eddd 100644
--- a/src/auditordb/pg_get_bad_sig_losses.h
+++ b/src/auditordb/pg_get_bad_sig_losses.h
@@ -25,9 +25,12 @@
  * Get information about bad signature losses from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
+ * @param filter_spec_pub filter by @a op_spec_pub
+ * @param op_spec_pub public key to filter by; FIXME: replace by pointer
+ * @param op operation to filter by
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
  * @return query result status
@@ -44,4 +47,4 @@ TAH_PG_get_bad_sig_losses (
   TALER_AUDITORDB_BadSigLossesCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_BAD_SIG_LOSSES_H
+#endif
diff --git a/src/auditordb/pg_get_balances.h b/src/auditordb/pg_get_balances.h
index 48c9287b1..4507c277f 100644
--- a/src/auditordb/pg_get_balances.h
+++ b/src/auditordb/pg_get_balances.h
@@ -22,18 +22,21 @@
 #include "taler_json_lib.h"
 #include "taler_auditordb_plugin.h"
 
+
 /**
  * Get information about balances from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
  * @param start_id row/serial ID where to start the iteration (0 from
  *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
+ * @param balance_key key to look for
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
  * @return query result status
  */
-
 enum GNUNET_DB_QueryStatus
 TAH_PG_get_balances (
   void *cls,
@@ -44,4 +47,4 @@ TAH_PG_get_balances (
   TALER_AUDITORDB_BalancesCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_BALANCES_H
+#endif
diff --git a/src/auditordb/pg_get_coin_inconsistency.h b/src/auditordb/pg_get_coin_inconsistency.h
index 9bff05397..00e700e42 100644
--- a/src/auditordb/pg_get_coin_inconsistency.h
+++ b/src/auditordb/pg_get_coin_inconsistency.h
@@ -24,8 +24,8 @@
  * Get information about deposit confirmations from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -41,4 +41,4 @@ TAH_PG_get_coin_inconsistency (
   void *cb_cls);
 
 
-#endif // SRC_PG_GET_COIN_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_denomination_key_validity_withdraw_inconsistency.h b/src/auditordb/pg_get_denomination_key_validity_withdraw_inconsistency.h
index 199e2c364..1f0b375a8 100644
--- a/src/auditordb/pg_get_denomination_key_validity_withdraw_inconsistency.h
+++ b/src/auditordb/pg_get_denomination_key_validity_withdraw_inconsistency.h
@@ -24,8 +24,8 @@
  * Get information about denominations key validity withdraw inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_denomination_key_validity_withdraw_inconsistency (
   TALER_AUDITORDB_DenominationKeyValidityWithdrawInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_DENOMINATION_KEY_VALIDITY_WITHDRAW_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_denomination_pending.h b/src/auditordb/pg_get_denomination_pending.h
index f1578553b..478c3248c 100644
--- a/src/auditordb/pg_get_denomination_pending.h
+++ b/src/auditordb/pg_get_denomination_pending.h
@@ -26,8 +26,8 @@
  * Get information about denomination-pending from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_denomination_pending (
   TALER_AUDITORDB_DenominationPendingCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_DENOMINATION_PENDING_H
+#endif
diff --git a/src/auditordb/pg_get_denominations_without_sigs.h b/src/auditordb/pg_get_denominations_without_sigs.h
index 63bb54583..bfbec7aa3 100644
--- a/src/auditordb/pg_get_denominations_without_sigs.h
+++ b/src/auditordb/pg_get_denominations_without_sigs.h
@@ -26,8 +26,8 @@
  * Get information about denominations-without-sigs from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_denominations_without_sigs (
   TALER_AUDITORDB_DenominationsWithoutSigsCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_DENOMINATIONS_WITHOUT_SIGS_H
+#endif
diff --git a/src/auditordb/pg_get_deposit_confirmations.h b/src/auditordb/pg_get_deposit_confirmations.h
index 141f2a276..299bd02dc 100644
--- a/src/auditordb/pg_get_deposit_confirmations.h
+++ b/src/auditordb/pg_get_deposit_confirmations.h
@@ -30,8 +30,8 @@
  * Get information about deposit confirmations from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
diff --git a/src/auditordb/pg_get_emergency.h b/src/auditordb/pg_get_emergency.h
index 09530920e..df4b7da7f 100644
--- a/src/auditordb/pg_get_emergency.h
+++ b/src/auditordb/pg_get_emergency.h
@@ -24,8 +24,8 @@
  * Get information about emergency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_emergency (
   TALER_AUDITORDB_EmergencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_EMERGENCY_H
+#endif
diff --git a/src/auditordb/pg_get_emergency_by_count.h b/src/auditordb/pg_get_emergency_by_count.h
index 2054e2aee..5961fd68f 100644
--- a/src/auditordb/pg_get_emergency_by_count.h
+++ b/src/auditordb/pg_get_emergency_by_count.h
@@ -24,8 +24,8 @@
  * Get information about emergency by count from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_emergency_by_count (
   TALER_AUDITORDB_EmergenciesByCountCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_EMERGENCY_BY_COUNT_H
+#endif
diff --git a/src/auditordb/pg_get_exchange_signkeys.h b/src/auditordb/pg_get_exchange_signkeys.h
index e30602c48..58d7e1411 100644
--- a/src/auditordb/pg_get_exchange_signkeys.h
+++ b/src/auditordb/pg_get_exchange_signkeys.h
@@ -26,8 +26,8 @@
  * Get information about exchange-signkeys from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_exchange_signkeys (
   TALER_AUDITORDB_ExchangeSignkeysCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_EXCHANGE_SIGNKEYS_H
+#endif
diff --git a/src/auditordb/pg_get_fee_time_inconsistency.h b/src/auditordb/pg_get_fee_time_inconsistency.h
index 8874cffff..cb84d6712 100644
--- a/src/auditordb/pg_get_fee_time_inconsistency.h
+++ b/src/auditordb/pg_get_fee_time_inconsistency.h
@@ -24,8 +24,8 @@
  * Get information about fee time inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_fee_time_inconsistency (
   TALER_AUDITORDB_FeeTimeInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_FEE_TIME_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_historic_denomination_revenue.h b/src/auditordb/pg_get_historic_denomination_revenue.h
index c5847c667..01e2820ea 100644
--- a/src/auditordb/pg_get_historic_denomination_revenue.h
+++ b/src/auditordb/pg_get_historic_denomination_revenue.h
@@ -26,8 +26,8 @@
  * Get information about historic-denomination-revenue from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_historic_denomination_revenue (
   TALER_AUDITORDB_HistoricDenominationRevenueCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_HISTORIC_DENOMINATION_REVENUE_H
+#endif
diff --git a/src/auditordb/pg_get_historic_reserve_summary.h b/src/auditordb/pg_get_historic_reserve_summary.h
index 2d4f16dbe..70b5dd59e 100644
--- a/src/auditordb/pg_get_historic_reserve_summary.h
+++ b/src/auditordb/pg_get_historic_reserve_summary.h
@@ -26,8 +26,8 @@
  * Get information about historic-reserve-summary from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_historic_reserve_summary (
   TALER_AUDITORDB_HistoricReserveSummaryCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_HISTORIC_RESERVE_SUMMARY_H
+#endif
diff --git a/src/auditordb/pg_get_misattribution_in_inconsistency.h b/src/auditordb/pg_get_misattribution_in_inconsistency.h
index e8f7d4bf7..a6ac0bb0d 100644
--- a/src/auditordb/pg_get_misattribution_in_inconsistency.h
+++ b/src/auditordb/pg_get_misattribution_in_inconsistency.h
@@ -26,8 +26,8 @@
  * Get information about misattribution-in-inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_misattribution_in_inconsistency (
   TALER_AUDITORDB_MisattributionInInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_MISATTRIBUTION_IN_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_purse_not_closed_inconsistencies.h b/src/auditordb/pg_get_purse_not_closed_inconsistencies.h
index ef7bdb3ae..b68c5cfe7 100644
--- a/src/auditordb/pg_get_purse_not_closed_inconsistencies.h
+++ b/src/auditordb/pg_get_purse_not_closed_inconsistencies.h
@@ -24,8 +24,8 @@
  * Get information about purse not closed inconsistencies from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_purse_not_closed_inconsistencies (
   TALER_AUDITORDB_PurseNotClosedInconsistenciesCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_PURSE_NOT_CLOSED_INCONSISTENCIES_H
+#endif
diff --git a/src/auditordb/pg_get_purses.h b/src/auditordb/pg_get_purses.h
index b0dc3183b..5ee19bf2e 100644
--- a/src/auditordb/pg_get_purses.h
+++ b/src/auditordb/pg_get_purses.h
@@ -26,8 +26,8 @@
  * Get information about purses from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_purses (
   TALER_AUDITORDB_PursesCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_PURSES_H
+#endif
diff --git a/src/auditordb/pg_get_refreshes_hanging.h b/src/auditordb/pg_get_refreshes_hanging.h
index b4fd26708..566704a8d 100644
--- a/src/auditordb/pg_get_refreshes_hanging.h
+++ b/src/auditordb/pg_get_refreshes_hanging.h
@@ -24,8 +24,8 @@
  * Get information about hanging refreshes from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_refreshes_hanging (
   TALER_AUDITORDB_RefreshesHangingCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_REFRESHES_HANGING_H
+#endif
diff --git a/src/auditordb/pg_get_reserve_balance_insufficient_inconsistency.h b/src/auditordb/pg_get_reserve_balance_insufficient_inconsistency.h
index d2e0fa3ed..e9a4dceb5 100644
--- a/src/auditordb/pg_get_reserve_balance_insufficient_inconsistency.h
+++ b/src/auditordb/pg_get_reserve_balance_insufficient_inconsistency.h
@@ -24,8 +24,8 @@
  * Get information about reserve balance insufficient inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -40,4 +40,4 @@ TAH_PG_get_reserve_balance_insufficient_inconsistency (
   TALER_AUDITORDB_ReserveBalanceInsufficientInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_RESERVE_BALANCE_INSUFFICIENT_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_reserve_balance_summary_wrong_inconsistency.h b/src/auditordb/pg_get_reserve_balance_summary_wrong_inconsistency.h
index 8cafd4f44..69f36af75 100644
--- a/src/auditordb/pg_get_reserve_balance_summary_wrong_inconsistency.h
+++ b/src/auditordb/pg_get_reserve_balance_summary_wrong_inconsistency.h
@@ -26,8 +26,8 @@
  * Get information about reserve-balance-summary-wrong-inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_reserve_balance_summary_wrong_inconsistency (
   TALER_AUDITORDB_ReserveBalanceSummaryWrongInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_RESERVE_BALANCE_SUMMARY_WRONG_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_reserve_in_inconsistency.h b/src/auditordb/pg_get_reserve_in_inconsistency.h
index 26244f67c..335b067af 100644
--- a/src/auditordb/pg_get_reserve_in_inconsistency.h
+++ b/src/auditordb/pg_get_reserve_in_inconsistency.h
@@ -26,8 +26,8 @@
  * Get information about reserve-in-inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_reserve_in_inconsistency (
   TALER_AUDITORDB_ReserveInInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_RESERVE_IN_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_reserve_not_closed_inconsistency.h b/src/auditordb/pg_get_reserve_not_closed_inconsistency.h
index 623c98b89..2ef001d3b 100644
--- a/src/auditordb/pg_get_reserve_not_closed_inconsistency.h
+++ b/src/auditordb/pg_get_reserve_not_closed_inconsistency.h
@@ -26,8 +26,8 @@
  * Get information about reserve-not-closed-inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_reserve_not_closed_inconsistency (
   TALER_AUDITORDB_ReserveNotClosedInconsistencyCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_RESERVE_NOT_CLOSED_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_reserves.h b/src/auditordb/pg_get_reserves.h
index 1af347a3e..6c07233b3 100644
--- a/src/auditordb/pg_get_reserves.h
+++ b/src/auditordb/pg_get_reserves.h
@@ -26,8 +26,8 @@
  * Get information about reserves from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_reserves (
   TALER_AUDITORDB_ReservesCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_RESERVES_H
+#endif
diff --git a/src/auditordb/pg_get_row_inconsistency.h b/src/auditordb/pg_get_row_inconsistency.h
index 4aa13e36d..cef52b114 100644
--- a/src/auditordb/pg_get_row_inconsistency.h
+++ b/src/auditordb/pg_get_row_inconsistency.h
@@ -24,8 +24,8 @@
  * Get information about deposit confirmations from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -41,4 +41,4 @@ TAH_PG_get_row_inconsistency (
   void *cb_cls);
 
 
-#endif // SRC_PG_GET_ROW_INCONSISTENCY_H
+#endif
diff --git a/src/auditordb/pg_get_row_minor_inconsistencies.h b/src/auditordb/pg_get_row_minor_inconsistencies.h
index 0fee08db2..18928ad8d 100644
--- a/src/auditordb/pg_get_row_minor_inconsistencies.h
+++ b/src/auditordb/pg_get_row_minor_inconsistencies.h
@@ -26,8 +26,8 @@
  * Get information about row-minor-inconsistencies from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
@@ -42,4 +42,4 @@ TAH_PG_get_row_minor_inconsistencies (
   TALER_AUDITORDB_RowMinorInconsistenciesCallback cb,
   void *cb_cls);
 
-#endif // SRC_PG_GET_ROW_MINOR_INCONSISTENCIES_H
+#endif
diff --git a/src/auditordb/pg_get_wire_format_inconsistency.h b/src/auditordb/pg_get_wire_format_inconsistency.h
index 87ba9d14b..321d562f0 100644
--- a/src/auditordb/pg_get_wire_format_inconsistency.h
+++ b/src/auditordb/pg_get_wire_format_inconsistency.h
@@ -26,8 +26,8 @@
  * Get information about wire-format-inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb
diff --git a/src/auditordb/pg_get_wire_out_inconsistency.h b/src/auditordb/pg_get_wire_out_inconsistency.h
index 619f755a1..2bbc2c3c5 100644
--- a/src/auditordb/pg_get_wire_out_inconsistency.h
+++ b/src/auditordb/pg_get_wire_out_inconsistency.h
@@ -26,8 +26,8 @@
  * Get information about wire-out-inconsistency from the database.
  *
  * @param cls the @e cls of this struct with the plugin-specific state
- * @param start_id row/serial ID where to start the iteration (0 from
- *                  the start, exclusive, i.e. serial_ids must start from 1)
+ * @param limit number of records to return, negative for descending
+ * @param offset table row to start from, exclusive, direction determined by @a limit
  * @param return_suppressed should suppressed rows be returned anyway?
  * @param cb function to call with results
  * @param cb_cls closure for @a cb