]> mj.ucw.cz Git - libucw.git/commitdiff
ucw docs: hashfunc reflects the syntax change
authorMichal Vaner <vorner@ucw.cz>
Sun, 14 Sep 2008 14:02:00 +0000 (16:02 +0200)
committerMichal Vaner <vorner@ucw.cz>
Sun, 14 Sep 2008 14:02:00 +0000 (16:02 +0200)
ucw/hashfunc.h
ucw/md5.h
ucw/sha1.h

index 2e045b274e6c8f813e21d7fdc5b08e011e2cb91c..7250119a6723d199d2a3db0fb248634e72eb3dcb 100644 (file)
 /*** === String hashes [[strhash]] ***/
 
 /* The following functions need str to be aligned to sizeof(uns).  */
-uns str_len_aligned(const char *str) PURE; /** Get the string length (not a really useful hash function, but there is no better place for it). The string must be aligned to sizeof(uns). For unaligned see str_len(). **/
-uns hash_string_aligned(const char *str) PURE; /** Hash the string. The string must be aligned to sizeof(uns). For unaligned see hash_string(). **/
-uns hash_block_aligned(const byte *str, uns len) PURE; /** Hash arbitrary data. They must be aligned to sizeof(uns). For unaligned see hash_block(). **/
+uns str_len_aligned(const char *str) PURE; /** Get the string length (not a really useful hash function, but there is no better place for it). The string must be aligned to sizeof(uns). For unaligned see @str_len(). **/
+uns hash_string_aligned(const char *str) PURE; /** Hash the string. The string must be aligned to sizeof(uns). For unaligned see @hash_string(). **/
+uns hash_block_aligned(const byte *str, uns len) PURE; /** Hash arbitrary data. They must be aligned to sizeof(uns). For unaligned see @hash_block(). **/
 
 #ifdef CPU_ALLOW_UNALIGNED
 #define        str_len(str)            str_len_aligned(str)
 #define        hash_string(str)        hash_string_aligned(str)
 #define        hash_block(str, len)    hash_block_aligned(str, len)
 #else
-uns str_len(const char *str) PURE; /** Get the string length. If you know it is aligned to sizeof(uns), you can use faster str_len_aligned(). **/
-uns hash_string(const char *str) PURE; /** Hash the string. If it is aligned to sizeof(uns), you can use faster hash_string_aligned(). **/
-uns hash_block(const byte *str, uns len) PURE; /** Hash arbitrary data. If they are aligned to sizeof(uns), use faster hash_block_aligned(). **/
+uns str_len(const char *str) PURE; /** Get the string length. If you know it is aligned to sizeof(uns), you can use faster @str_len_aligned(). **/
+uns hash_string(const char *str) PURE; /** Hash the string. If it is aligned to sizeof(uns), you can use faster @hash_string_aligned(). **/
+uns hash_block(const byte *str, uns len) PURE; /** Hash arbitrary data. If they are aligned to sizeof(uns), use faster @hash_block_aligned(). **/
 #endif
 
 uns hash_string_nocase(const char *str) PURE; /** Hash the string in a case insensitive way. Works only with ASCII characters. **/
index 6980a1f9cd26fb02e33e0c6dc619e08a4209661d..75966cac6f75b82241b624074ff596e8315ab5e4 100644 (file)
--- a/ucw/md5.h
+++ b/ucw/md5.h
@@ -27,7 +27,7 @@ void md5_init(md5_context *context); /** Initialize the MD5 hashing algorithm in
  */
 void md5_update(md5_context *context, const byte *buf, uns len);
 /**
- * Call this after the last md5_update(). It will terminate the
+ * Call this after the last @md5_update(). It will terminate the
  * algorithm and return a pointer to the result.
  *
  * Note that the data it points to are stored inside the @context, so
index 55809ee00c3ec631ebcca2adb9d3bddca538cfcf..2527e09a72f5e5204bef389aca83d1dda956428f 100644 (file)
@@ -30,12 +30,12 @@ void sha1_init(sha1_context *hd); /** Initialize new algorithm run in the @hd co
  * Push another @inlen bytes of data pointed to by @inbuf onto the
  * SHA1 hash currently in @hd. You can call this any times you want on
  * the same hash (and you do not need to reinitialize it by
- * sha1_init()). It has the same effect as concatenating all the data
+ * @sha1_init()). It has the same effect as concatenating all the data
  * together and passing them at once.
  */
 void sha1_update(sha1_context *hd, const byte *inbuf, uns inlen);
 /**
- * No more sha1_update() calls will be done. This terminates the hash
+ * No more @sha1_update() calls will be done. This terminates the hash
  * and returns a pointer to it.
  *
  * Note that the pointer points into data in the @hd context. If it ceases