Doc tweak - MDB_RESERVE / DUPSORT incompat
authorHoward Chu <hyc@openldap.org>
Sat, 22 Aug 2015 13:00:12 +0000 (14:00 +0100)
committerHoward Chu <hyc@openldap.org>
Sat, 22 Aug 2015 13:00:12 +0000 (14:00 +0100)
For those people who insist on ignoring the obvious.

libraries/liblmdb/lmdb.h

index e3d72dc..e080e76 100644 (file)
@@ -1303,7 +1303,8 @@ int  mdb_get(MDB_txn *txn, MDB_dbi dbi, MDB_val *key, MDB_val *data);
         *              the next update operation or the transaction ends. This saves
         *              an extra memcpy if the data is being generated later.
         *              LMDB does nothing else with this memory, the caller is expected
-        *              to modify all of the space requested.
+        *              to modify all of the space requested. This flag must not be
+        *              specified if the database was opened with #MDB_DUPSORT.
         *      <li>#MDB_APPEND - append the given key/data pair to the end of the
         *              database. This option allows fast bulk loading when keys are
         *              already known to be in the correct order. Loading unsorted keys
@@ -1460,7 +1461,8 @@ int  mdb_cursor_get(MDB_cursor *cursor, MDB_val *key, MDB_val *data,
         *      <li>#MDB_RESERVE - reserve space for data of the given size, but
         *              don't copy the given data. Instead, return a pointer to the
         *              reserved space, which the caller can fill in later. This saves
-        *              an extra memcpy if the data is being generated later.
+        *              an extra memcpy if the data is being generated later. This flag
+        *              must not be specified if the database was opened with #MDB_DUPSORT.
         *      <li>#MDB_APPEND - append the given key/data pair to the end of the
         *              database. No key comparisons are performed. This option allows
         *              fast bulk loading when keys are already known to be in the