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.
This commit is contained in:
Marcus Brinkmann 2004-06-08 17:26:48 +00:00
parent 8d2e1e7f61
commit 5236702f6f
2 changed files with 22 additions and 6 deletions

View File

@ -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> 2004-05-21 Marcus Brinkmann <marcus@g10code.de>
* gpgme.text (Verify): Document GPG_ERR_CERT_REVOKED status. * gpgme.text (Verify): Document GPG_ERR_CERT_REVOKED status.

View File

@ -3738,12 +3738,16 @@ verification was attempted.
@deftypefun gpgme_verify_result_t gpgme_op_verify_result (@w{gpgme_ctx_t @var{ctx}}) @deftypefun gpgme_verify_result_t gpgme_op_verify_result (@w{gpgme_ctx_t @var{ctx}})
The function @code{gpgme_op_verify_result} returns a The function @code{gpgme_op_verify_result} returns a
@code{gpgme_verify_result_t} pointer to a structure holding the result of @code{gpgme_verify_result_t} pointer to a structure holding the result
a @code{gpgme_op_verify} operation. The pointer is only valid if the of a @code{gpgme_op_verify} operation. The pointer is only valid if
last operation on the context was a @code{gpgme_op_verify} or the last operation on the context was a @code{gpgme_op_verify},
@code{gpgme_op_verify_start} operation, and if this operation finished @code{gpgme_op_verify_start}, @code{gpgme_op_decrypt_verify} or
successfully. The returned pointer is only valid until the next @code{gpgme_op_decrypt_verify_start} operation, and if this operation
operation is started on the context. 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 @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 @code{gpgme_op_verify_result} can be used to retrieve more information
about the signatures. 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 The function returns the error code @code{GPG_ERR_NO_ERROR} if the
ciphertext could be decrypted successfully, @code{GPG_ERR_INV_VALUE} ciphertext could be decrypted successfully, @code{GPG_ERR_INV_VALUE}
if @var{ctx}, @var{cipher} or @var{plain} is not a valid pointer, if @var{ctx}, @var{cipher} or @var{plain} is not a valid pointer,