Mesa (master): mesa: Document an odd side-effect of hash_table_insert
Ian Romanick
idr at kemper.freedesktop.org
Fri Sep 30 23:25:19 UTC 2011
Module: Mesa
Branch: master
Commit: 16f7bdf5556e739d5a0b6c4c2e2a30bb731f8fc9
URL: http://cgit.freedesktop.org/mesa/mesa/commit/?id=16f7bdf5556e739d5a0b6c4c2e2a30bb731f8fc9
Author: Ian Romanick <ian.d.romanick at intel.com>
Date: Wed Aug 17 11:43:11 2011 -0700
mesa: Document an odd side-effect of hash_table_insert
Signed-off-by: Ian Romanick <ian.d.romanick at intel.com>
Reviewed-by: Kenneth Graunke <kenneth at whitecape.org>
---
src/mesa/program/hash_table.h | 5 +++++
1 files changed, 5 insertions(+), 0 deletions(-)
diff --git a/src/mesa/program/hash_table.h b/src/mesa/program/hash_table.h
index e715bb1..746939c 100644
--- a/src/mesa/program/hash_table.h
+++ b/src/mesa/program/hash_table.h
@@ -88,6 +88,11 @@ extern void *hash_table_find(struct hash_table *ht, const void *key);
/**
* Add an element to a hash table
+ *
+ * \warning
+ * If \c key is already in the hash table, it will be added again. Future
+ * calls to \c hash_table_find and \c hash_table_remove will return or remove,
+ * repsectively, the most recently added instance of \c key.
*/
extern void hash_table_insert(struct hash_table *ht, void *data,
const void *key);
More information about the mesa-commit
mailing list