gpgme/doc
Justus Winter de708e5934
core: Fix expiration time handling when creating keys.
* NEWS: Update.
* doc/gpgme.texi (gpgme_op_createkey): Clarify the meaning of the
'expire' parameter.
(GPGME_CREATE_NOEXPIRE): Document new flag.
(gpgme_op_createsubkey): Clarify the meaning of the 'expire'
parameter.
* src/engine-gpg.c (gpg_add_algo_usage_expire): Fix handling of the
expiration time.
* src/gpgme.h.in (GPGME_CREATE_NOEXPIRE): New macro.
--

Previously, the documentation stated that the expiration time was an
absolute timestamp.  However, this value was passed using the
'seconds=N' syntax to GnuPG which specifies the expiration time in
seconds relative to the creation time.  Fix the documentation.

Furthermore, the documentation stated that using 0 results in keys
that do not expire.  This was communicated to GnuPG by using the
implicit default.  However, as of GnuPG 2.1.17, the default was
changed to create keys that expire within a reasonable timespan.

Fix this discrepancy by aligning the behavior with recent GnuPG
versions: 0 means use a reasonable default, and introduce a flag that
can be used to create keys that do not expire.  Communicate this
explicitly to GnuPG.

Signed-off-by: Justus Winter <justus@g10code.com>
2017-02-15 16:45:45 +01:00
..
examples Updated the example. 2008-06-20 10:40:52 +00:00
.gitignore .gitignore: flesh out rules and add subdirectory-.gitignores. 2012-04-20 16:05:11 +02:00
ChangeLog-2011 move some file encodings to UTF-8 2016-09-23 16:08:33 +02:00
DCO Add DCO file 2012-09-25 19:21:00 +02:00
gpgme.texi core: Fix expiration time handling when creating keys. 2017-02-15 16:45:45 +01:00
gpl.texi doc: Replace http: by https: in core source files. 2016-11-16 13:27:00 +01:00
HACKING Release 1.6.0 2015-08-26 10:06:00 +02:00
lesser.texi Release 1.6.0 2015-08-26 10:06:00 +02:00
Makefile.am doc: Get rid of version.texi 2016-08-10 16:33:20 +02:00
mdate-sh Update automake scripts. 2008-07-04 15:46:01 +00:00
mkdefsinc.c doc: Get rid of version.texi 2016-08-10 16:33:20 +02:00
module-overview.sk Add a module overview diagram. 2008-07-17 17:09:39 +00:00
texinfo.tex doc: Replace http: by https: in core source files. 2016-11-16 13:27:00 +01:00
uiserver.texi core: Enable extraction of session keys. 2016-11-15 08:52:06 +01:00