[GNUnet-SVN] r35008 - in gnunet/src: include util

[gnunet]

Author: harsha
Date: 2015-01-26 11:19:01 +0100 (Mon, 26 Jan 2015)
New Revision: 35008

Modified:
   gnunet/src/include/gnunet_crypto_lib.h
   gnunet/src/util/crypto_rsa.c
Log:
- fix docu

Modified: gnunet/src/include/gnunet_crypto_lib.h
===================================================================
--- gnunet/src/include/gnunet_crypto_lib.h      2015-01-26 09:53:34 UTC (rev 
35007)
+++ gnunet/src/include/gnunet_crypto_lib.h      2015-01-26 10:19:01 UTC (rev 
35008)
@@ -1644,8 +1644,7 @@
 
 
 /**
- * Encode the given signature in a format suitable for
- * storing it into a file.
+ * Encode the given signature in a format suitable for storing it into a file.
  *
  * @param sig the signature
  * @param[out] buffer set to a buffer with the encoded key
@@ -1657,8 +1656,8 @@
 
 
 /**
- * Decode the signature from the data-format back
- * to the "normal", internal format.
+ * Decode the signature from the data-format back to the "normal", internal
+ * format.
  *
  * @param buf the buffer where the public key data is stored
  * @param len the length of the data in @a buf
@@ -1670,9 +1669,9 @@
 
 
 /**
- * Unblind a signature made on blinding signature purpose.  The signature
- * purpose should have been generated with #GNUNET_CRYPTO_rsa_sign() using
- * a message that was generated with #GNUNET_CRYPTO_rsa_blind().
+ * Unblind a blind-signed signature.  The signature should have been generated
+ * with #GNUNET_CRYPTO_rsa_sign() using a hash that was blinded with
+ * #GNUNET_CRYPTO_rsa_blind().
  *
  * @param sig the signature made on the blinded signature purpose
  * @param bkey the blinding key used to blind the signature purpose
@@ -1686,7 +1685,8 @@
 
 
 /**
- * Verify signature with the given hash.
+ * Verify whether the given hash corresponds to the given signature and the
+ * signature is valid with respect to the given public key.
  *
  * @param hash the message to verify to match the @a sig
  * @param sig signature that is being validated

Modified: gnunet/src/util/crypto_rsa.c
===================================================================
--- gnunet/src/util/crypto_rsa.c        2015-01-26 09:53:34 UTC (rev 35007)
+++ gnunet/src/util/crypto_rsa.c        2015-01-26 10:19:01 UTC (rev 35008)
@@ -690,9 +690,9 @@
 
 
 /**
- * Unblind a signature made on blinding signature purpose.  The signature
- * purpose should have been generated with #GNUNET_CRYPTO_rsa_sign() using
- * a message that was generated with #GNUNET_CRYPTO_rsa_blind().
+ * Unblind a blind-signed signature.  The signature should have been generated
+ * with #GNUNET_CRYPTO_rsa_sign() using a hash that was blinded with
+ * #GNUNET_CRYPTO_rsa_blind().
  *
  * @param sig the signature made on the blinded signature purpose
  * @param bkey the blinding key used to blind the signature purpose
@@ -758,7 +758,8 @@
 
 
 /**
- * Verify signature with the given hash.
+ * Verify whether the given hash corresponds to the given signature and the
+ * signature is valid with respect to the given public key.
  *
  * @param hash hash of the message to verify to match the @a sig
  * @param sig signature that is being validated