Note MDB_CURRENT/MDB_DUPSORT requirement
* <li>#MDB_CURRENT - overwrite the data of the key/data pair to which
* the cursor refers with the specified data item. The \b key
* parameter is not used for positioning the cursor, but should
- * still be provided.
+ * still be provided. If using sorted duplicates (#MDB_DUPSORT)
+ * the data item must still sort into the same place.
* <li>#MDB_NODUPDATA - enter the new key/data pair only if it does not
* already appear in the database. This flag may only be specified
* if the database was opened with #MDB_DUPSORT. The function will