doc,tests: Require use of ctx_flag before use of session_key.
authorDaniel Kahn Gillmor <dkg@fifthhorseman.net>
Wed, 16 Nov 2016 05:10:22 +0000 (14:10 +0900)
committerWerner Koch <wk@gnupg.org>
Wed, 16 Nov 2016 09:15:31 +0000 (10:15 +0100)
commit573064742145aa5f9bf04baa88af918c0c4d5e12
treeba14bb77383d839f85ecc6fd30c716ff05e6505c
parentb2c07bd47bd608afa5cc819b60a7b5bb8c9dd96a
doc,tests: Require use of ctx_flag before use of session_key.

* doc/gpgme.texi: Document requirements of verifying that it is OK to
use session_key.
* tests/run-decrypt.c: Ensure that we fail if we're unable to access
the session key, so that we do not violate the guidance above.

Signed-off-by: Daniel Kahn Gillmor <dkg@fifthhorseman.net>
Changed the description

 -@code{gpgme_set_ctx_flag (ctx, "export-session-key")} returns
 -@code{GPG_ERR_NO_ERROR} or @code{gpgme_get_ctx_flag (ctx,
 -"export-session-key")} returns @code{"1"}.
 +@code{gpgme_set_ctx_flag (ctx, "export-session-key")} returns success
 +or @code{gpgme_get_ctx_flag (ctx, "export-session-key")} returns true
 +(non-empty string).

to get gpgme_get_ctx_flag for boolean values in sync with its own
description.

Note that I don't agree with the above suggestion but it does not
really harm to have it in the man page.

Signed-off-by: Werner Koch <wk@gnupg.org>
doc/gpgme.texi
tests/run-decrypt.c