2004-06-08 Marcus Brinkmann <marcus@g10code.de>

	* gpgme.texi (Decrypt and Verify): Document the NO_DATA error
	code.
	(Verify): Document the relationship between gpgme_op_verify_result
	and the decrypt and verify operations.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 0643e79eead45ba2c9b1ad0c63235884fb17de5f..d21275e405f6de546fb5ccf8bc3d981578fffd2c 100644 (file)
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,10 @@
+2004-06-08  Marcus Brinkmann  <marcus@g10code.de>
+
+       * gpgme.texi (Decrypt and Verify): Document the NO_DATA error
+       code.
+       (Verify): Document the relationship between gpgme_op_verify_result
+       and the decrypt and verify operations.
+
 2004-05-21  Marcus Brinkmann  <marcus@g10code.de>
 
        * gpgme.text (Verify): Document GPG_ERR_CERT_REVOKED status.

diff --git a/doc/gpgme.texi b/doc/gpgme.texi
index 6ce7d683a87511fc3e910521d02c918d47521f14..c1f9e61c58e340d1b60b004fb0acf7a20147407c 100644 (file)
--- a/doc/gpgme.texi
+++ b/doc/gpgme.texi
@@ -3738,12 +3738,16 @@ verification was attempted.
 
 @deftypefun gpgme_verify_result_t gpgme_op_verify_result (@w{gpgme_ctx_t @var{ctx}})
 The function @code{gpgme_op_verify_result} returns a
-@code{gpgme_verify_result_t} pointer to a structure holding the result of
-a @code{gpgme_op_verify} operation.  The pointer is only valid if the
-last operation on the context was a @code{gpgme_op_verify} or
-@code{gpgme_op_verify_start} operation, and if this operation finished
-successfully.  The returned pointer is only valid until the next
-operation is started on the context.
+@code{gpgme_verify_result_t} pointer to a structure holding the result
+of a @code{gpgme_op_verify} operation.  The pointer is only valid if
+the last operation on the context was a @code{gpgme_op_verify},
+@code{gpgme_op_verify_start}, @code{gpgme_op_decrypt_verify} or
+@code{gpgme_op_decrypt_verify_start} operation, and if this operation
+finished successfully (for @code{gpgme_op_decrypt_verify} and
+@code{gpgme_op_decrypt_verify_start}, the error code
+@code{GPG_ERR_NO_DATA} counts as successful in this context).  The
+returned pointer is only valid until the next operation is started on
+the context.
 @end deftypefun
 
 
@@ -3996,6 +4000,11 @@ After the operation completed, @code{gpgme_op_decrypt_result} and
 @code{gpgme_op_verify_result} can be used to retrieve more information
 about the signatures.
 
+If the error code @code{GPG_ERR_NO_DATA} is returned, @var{cipher}
+does not contain any data to decrypt.  However, it might still be
+signed.  The information about detected signatures is available with
+@code{gpgme_op_verify_result} in this case.
+
 The function returns the error code @code{GPG_ERR_NO_ERROR} if the
 ciphertext could be decrypted successfully, @code{GPG_ERR_INV_VALUE}
 if @var{ctx}, @var{cipher} or @var{plain} is not a valid pointer,