* gc.h (gc_hash_buffer): Add doc.

diff --git a/lib/ChangeLog b/lib/ChangeLog
index 9b0ed2c6aa2a7c4a2dbc1f6bcdc77b3b55cc0974..ec98e7d5517d3e5c4effbd1e3aa6b52bb9940f97 100644 (file)
--- a/lib/ChangeLog
+++ b/lib/ChangeLog
@@ -1,3 +1,7 @@
+2005-10-11  Simon Josefsson  <jas@extundo.com>
+
+       * gc.h (gc_hash_buffer): Add doc.
+
 2005-10-11  Bruno Haible  <bruno@clisp.org>
 
        * strcasecmp.c: Include limits.h.

diff --git a/lib/gc.h b/lib/gc.h
index f9b66d1bffb765309f7d43a8a605dd3a92b29c99..9932770d83787cf2dd15f5c7c5ae901d14789a74 100644 (file)
--- a/lib/gc.h
+++ b/lib/gc.h
@@ -63,6 +63,12 @@ extern void gc_set_allocators (gc_malloc_t func_malloc,
                               gc_free_t func_free);
 
 /* Hashes. */
+
+/* Compute a hash value over buffer IN of INLEN bytes size using the
+   algorithm HASH, placing the result in the pre-allocated buffer OUT.
+   The required size of OUT depends on HASH, and is generally
+   GC_<HASH>_DIGEST_SIZE.  For example, for GC_MD5 the output buffer
+   must be 16 bytes. */
 extern int
 gc_hash_buffer (int hash, const void *in, size_t inlen, char *out);