From 2392c70e2bbab422a3192b190a2b7ae2fad4c35f Mon Sep 17 00:00:00 2001
From: Leo Yuriev <leo@yuriev.ru>
Date: Wed, 14 Jun 2017 19:36:32 +0300
Subject: [PATCH] mdbx: refine MDBX_oom_func description.

---
 mdbx.h | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/mdbx.h b/mdbx.h
index 4fe0d908..f5731988 100644
--- a/mdbx.h
+++ b/mdbx.h
@@ -1534,9 +1534,9 @@ LIBMDBX_API int mdbx_txn_straggler(MDBX_txn *txn, int *percent);
  * [in] retry   A retry number, less that zero for notify end of OOM-loop.
  *
  * Returns -1 on failure (reader is not killed),
- *  0 on a race condition (no such reader),
- *  1 on success (reader was killed),
- *  >1 on success (reader was SURE killed). */
+ *  0 should wait or retry,
+ *  1 drop reader txn-lock (reading-txn was aborted),
+ *  >1 drop reader registration (reader process was killed). */
 typedef int(MDBX_oom_func)(MDBX_env *env, int pid, mdbx_tid_t tid, uint64_t txn,
                            unsigned gap, int retry);