summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/gpgme.info228
-rw-r--r--doc/gpgme.info-122
-rw-r--r--doc/gpgme.info-212
-rw-r--r--doc/gpgme.texi22
-rw-r--r--doc/stamp-vti8
-rw-r--r--doc/version.texi8
6 files changed, 161 insertions, 139 deletions
diff --git a/doc/gpgme.info b/doc/gpgme.info
index 3465aa6..b7fc85b 100644
--- a/doc/gpgme.info
+++ b/doc/gpgme.info
@@ -22,8 +22,8 @@ General Public License for more details.
This file documents the GPGME library.
- This is Edition 1.5.0, last updated 8 May 2014, of `The `GnuPG Made
-Easy' Reference Manual', for Version 1.5.0.
+ This is Edition 1.5.1, last updated 30 July 2014, of `The `GnuPG
+Made Easy' Reference Manual', for Version 1.5.1.
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2012,
2013, 2014 g10 Code GmbH.
@@ -41,120 +41,120 @@ General Public License for more details.

Indirect:
-gpgme.info-1: 1767
-gpgme.info-2: 289212
+gpgme.info-1: 1769
+gpgme.info-2: 289901

Tag Table:
(Indirect)
-Node: Top1767
-Node: Introduction8876
-Node: Getting Started9663
-Node: Features10788
-Node: Overview11938
-Node: Preparation13047
-Node: Header14044
-Node: Building the Source14743
-Node: Largefile Support (LFS)16852
-Node: Using Automake22163
-Node: Using Libtool23799
-Node: Library Version Check24149
-Node: Signal Handling29167
-Node: Multi Threading30383
-Ref: Multi Threading-Footnote-132565
-Node: Protocols and Engines32979
-Node: Engine Version Check35414
-Node: Engine Information36981
-Node: Engine Configuration40753
-Node: OpenPGP42015
-Node: Cryptographic Message Syntax42351
-Node: Algorithms42645
-Ref: Algorithms-Footnote-143124
-Node: Public Key Algorithms43252
-Node: Hash Algorithms45173
-Node: Error Handling46294
-Node: Error Values48156
-Node: Error Sources53234
-Node: Error Codes55561
-Node: Error Strings60200
-Node: Exchanging Data61979
-Node: Creating Data Buffers63808
-Node: Memory Based Data Buffers64324
-Node: File Based Data Buffers67678
-Node: Callback Based Data Buffers69849
-Node: Destroying Data Buffers75405
-Node: Manipulating Data Buffers76764
-Node: Data Buffer I/O Operations77256
-Node: Data Buffer Meta-Data79959
-Node: Data Buffer Convenience83341
-Node: Contexts85277
-Node: Creating Contexts86459
-Node: Destroying Contexts87270
-Node: Result Management87605
-Node: Context Attributes89011
-Node: Protocol Selection89791
-Node: Crypto Engine90803
-Node: ASCII Armor92624
-Node: Text Mode93236
-Node: Included Certificates94167
-Node: Key Listing Mode95542
-Node: Passphrase Callback98899
-Node: Progress Meter Callback102037
-Node: Locale103961
-Node: Key Management105500
-Node: Listing Keys115688
-Node: Information About Keys122950
-Node: Key Signatures130948
-Node: Manipulating Keys134960
-Node: Generating Keys135802
-Node: Exporting Keys140409
-Node: Importing Keys146308
-Ref: Importing Keys-Footnote-1153471
-Node: Deleting Keys153599
-Node: Changing Passphrases154996
-Node: Advanced Key Editing156257
-Node: Trust Item Management159361
-Node: Listing Trust Items160431
-Node: Information About Trust Items162729
-Node: Manipulating Trust Items164611
-Node: Crypto Operations165572
-Node: Decrypt166818
-Node: Verify170564
-Node: Decrypt and Verify188503
-Node: Sign190507
-Node: Selecting Signers191071
-Node: Creating a Signature192223
-Node: Signature Notation Data196834
-Node: Encrypt199018
-Node: Encrypting a Plaintext199374
-Node: Miscellaneous205873
-Node: Running other Programs206161
-Node: Run Control208138
-Node: Waiting For Completion208881
-Node: Using External Event Loops210927
-Node: I/O Callback Interface212894
-Node: Registering I/O Callbacks218006
-Node: I/O Callback Example219991
-Node: I/O Callback Example GTK+226208
-Node: I/O Callback Example GDK227997
-Node: I/O Callback Example Qt229639
-Node: Cancellation231927
-Node: UI Server Protocol234180
-Ref: UI Server Protocol-Footnote-1235611
-Node: UI Server Encrypt235730
-Node: UI Server Sign240990
-Node: UI Server Decrypt243298
-Node: UI Server Verify244736
-Node: UI Server Set Input Files248238
-Node: UI Server Sign/Encrypt Files249038
-Node: UI Server Verify/Decrypt Files250807
-Node: UI Server Import/Export Keys252653
-Node: UI Server Checksum Files253686
-Node: Miscellaneous UI Server Commands255852
-Ref: command SENDER257764
-Node: Debugging259440
-Node: Library Copying261095
-Node: Copying289212
-Node: Function and Data Index326843
-Node: Concept Index353007
+Node: Top1769
+Node: Introduction8880
+Node: Getting Started9667
+Node: Features10792
+Node: Overview11942
+Node: Preparation13051
+Node: Header14048
+Node: Building the Source14747
+Node: Largefile Support (LFS)16856
+Node: Using Automake22167
+Node: Using Libtool23803
+Node: Library Version Check24153
+Node: Signal Handling29171
+Node: Multi Threading30387
+Ref: Multi Threading-Footnote-132569
+Node: Protocols and Engines32983
+Node: Engine Version Check35418
+Node: Engine Information36985
+Node: Engine Configuration40757
+Node: OpenPGP42019
+Node: Cryptographic Message Syntax42355
+Node: Algorithms42649
+Ref: Algorithms-Footnote-143128
+Node: Public Key Algorithms43256
+Node: Hash Algorithms45177
+Node: Error Handling46298
+Node: Error Values48160
+Node: Error Sources53238
+Node: Error Codes55565
+Node: Error Strings60204
+Node: Exchanging Data61983
+Node: Creating Data Buffers63812
+Node: Memory Based Data Buffers64328
+Node: File Based Data Buffers67682
+Node: Callback Based Data Buffers69853
+Node: Destroying Data Buffers75409
+Node: Manipulating Data Buffers76768
+Node: Data Buffer I/O Operations77260
+Node: Data Buffer Meta-Data79963
+Node: Data Buffer Convenience83345
+Node: Contexts85281
+Node: Creating Contexts86463
+Node: Destroying Contexts87274
+Node: Result Management87609
+Node: Context Attributes89015
+Node: Protocol Selection89795
+Node: Crypto Engine90807
+Node: ASCII Armor92628
+Node: Text Mode93240
+Node: Included Certificates94171
+Node: Key Listing Mode95546
+Node: Passphrase Callback99319
+Node: Progress Meter Callback102457
+Node: Locale104381
+Node: Key Management105920
+Node: Listing Keys116377
+Node: Information About Keys123639
+Node: Key Signatures131637
+Node: Manipulating Keys135649
+Node: Generating Keys136491
+Node: Exporting Keys141098
+Node: Importing Keys146997
+Ref: Importing Keys-Footnote-1154160
+Node: Deleting Keys154288
+Node: Changing Passphrases155685
+Node: Advanced Key Editing156946
+Node: Trust Item Management160050
+Node: Listing Trust Items161120
+Node: Information About Trust Items163418
+Node: Manipulating Trust Items165300
+Node: Crypto Operations166261
+Node: Decrypt167507
+Node: Verify171253
+Node: Decrypt and Verify189192
+Node: Sign191196
+Node: Selecting Signers191760
+Node: Creating a Signature192912
+Node: Signature Notation Data197523
+Node: Encrypt199707
+Node: Encrypting a Plaintext200063
+Node: Miscellaneous206562
+Node: Running other Programs206850
+Node: Run Control208827
+Node: Waiting For Completion209570
+Node: Using External Event Loops211616
+Node: I/O Callback Interface213583
+Node: Registering I/O Callbacks218695
+Node: I/O Callback Example220680
+Node: I/O Callback Example GTK+226897
+Node: I/O Callback Example GDK228686
+Node: I/O Callback Example Qt230328
+Node: Cancellation232616
+Node: UI Server Protocol234869
+Ref: UI Server Protocol-Footnote-1236300
+Node: UI Server Encrypt236419
+Node: UI Server Sign241679
+Node: UI Server Decrypt243987
+Node: UI Server Verify245425
+Node: UI Server Set Input Files248927
+Node: UI Server Sign/Encrypt Files249727
+Node: UI Server Verify/Decrypt Files251496
+Node: UI Server Import/Export Keys253342
+Node: UI Server Checksum Files254375
+Node: Miscellaneous UI Server Commands256541
+Ref: command SENDER258453
+Node: Debugging260129
+Node: Library Copying261784
+Node: Copying289901
+Node: Function and Data Index327532
+Node: Concept Index353696

End Tag Table
diff --git a/doc/gpgme.info-1 b/doc/gpgme.info-1
index 9ce1bc9..bdfd347 100644
--- a/doc/gpgme.info-1
+++ b/doc/gpgme.info-1
@@ -22,8 +22,8 @@ General Public License for more details.
This file documents the GPGME library.
- This is Edition 1.5.0, last updated 8 May 2014, of `The `GnuPG Made
-Easy' Reference Manual', for Version 1.5.0.
+ This is Edition 1.5.1, last updated 30 July 2014, of `The `GnuPG
+Made Easy' Reference Manual', for Version 1.5.1.
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2012,
2013, 2014 g10 Code GmbH.
@@ -45,8 +45,8 @@ File: gpgme.info, Node: Top, Next: Introduction, Up: (dir)
Main Menu
*********
-This is Edition 1.5.0, last updated 8 May 2014, of `The `GnuPG Made
-Easy' Reference Manual', for Version 1.5.0 of the GPGME library.
+This is Edition 1.5.1, last updated 30 July 2014, of `The `GnuPG Made
+Easy' Reference Manual', for Version 1.5.1 of the GPGME library.
* Menu:
@@ -2348,6 +2348,14 @@ File: gpgme.info, Node: Key Listing Mode, Next: Passphrase Callback, Prev: In
in the listed keys. This only works if
`GPGME_KEYLIST_MODE_SIGS' is also enabled.
+ `GPGME_KEYLIST_MODE_WITH_SECRET'
+ The `GPGME_KEYLIST_MODE_WITH_SECRET' returns information about
+ the presence of a corresponding secret key in a public key
+ listing. A public key listing with this mode is slower than
+ a standard listing but can be used instead of a second run to
+ list the secret keys. This is only supported for GnuPG
+ versions >= 2.1.
+
`GPGME_KEYLIST_MODE_EPHEMERAL'
The `GPGME_KEYLIST_MODE_EPHEMERAL' symbol specifies that keys
flagged as ephemeral are included in the listing.
@@ -2586,6 +2594,8 @@ how such keys can be selected and manipulated.
This is true if the subkey is a secret key. Note that it
will be false if the key is actually a stub key; i.e. a
secret key operation is currently not possible (offline-key).
+ This is only set if a listing of secret keys has been
+ requested or if `GPGME_KEYLIST_MODE_WITH_SECRET' is active.
`gpgme_pubkey_algo_t pubkey_algo'
This is the public key algorithm supported by this subkey.
@@ -2771,7 +2781,9 @@ how such keys can be selected and manipulated.
`unsigned int secret : 1'
This is true if the key is a secret key. Note, that this
will always be true even if the corresponding subkey flag may
- be false (offline/stub keys).
+ be false (offline/stub keys). This is only set if a listing
+ of secret keys has been requested or if
+ `GPGME_KEYLIST_MODE_WITH_SECRET' is active.
`gpgme_protocol_t protocol'
This is the protocol supported by this key.
diff --git a/doc/gpgme.info-2 b/doc/gpgme.info-2
index bb166e3..68be411 100644
--- a/doc/gpgme.info-2
+++ b/doc/gpgme.info-2
@@ -22,8 +22,8 @@ General Public License for more details.
This file documents the GPGME library.
- This is Edition 1.5.0, last updated 8 May 2014, of `The `GnuPG Made
-Easy' Reference Manual', for Version 1.5.0.
+ This is Edition 1.5.1, last updated 30 July 2014, of `The `GnuPG
+Made Easy' Reference Manual', for Version 1.5.1.
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2010, 2012,
2013, 2014 g10 Code GmbH.
@@ -905,7 +905,7 @@ Function and Data Index
* gpgme_get_io_cbs: Registering I/O Callbacks.
(line 46)
* gpgme_get_key: Listing Keys. (line 149)
-* gpgme_get_keylist_mode: Key Listing Mode. (line 64)
+* gpgme_get_keylist_mode: Key Listing Mode. (line 72)
* gpgme_get_passphrase_cb: Passphrase Callback. (line 55)
* gpgme_get_progress_cb: Progress Meter Callback.
(line 33)
@@ -932,8 +932,8 @@ Function and Data Index
* gpgme_key_release: Manipulating Keys. (line 20)
* gpgme_key_sig_get_string_attr: Key Signatures. (line 78)
* gpgme_key_sig_get_ulong_attr: Key Signatures. (line 92)
-* gpgme_key_sig_t: Key Management. (line 92)
-* gpgme_key_t: Key Management. (line 200)
+* gpgme_key_sig_t: Key Management. (line 94)
+* gpgme_key_t: Key Management. (line 202)
* gpgme_key_unref: Manipulating Keys. (line 11)
* gpgme_keylist_result_t: Listing Keys. (line 125)
* gpgme_new: Creating Contexts. (line 7)
@@ -1070,7 +1070,7 @@ Function and Data Index
(line 9)
* gpgme_trust_item_unref: Manipulating Trust Items.
(line 11)
-* gpgme_user_id_t: Key Management. (line 165)
+* gpgme_user_id_t: Key Management. (line 167)
* gpgme_validity_t: Information About Keys.
(line 10)
* gpgme_verify_result_t: Verify. (line 248)
diff --git a/doc/gpgme.texi b/doc/gpgme.texi
index e326574..1f4a9e1 100644
--- a/doc/gpgme.texi
+++ b/doc/gpgme.texi
@@ -2472,6 +2472,13 @@ signature notations on key signatures should be included in the listed
keys. This only works if @code{GPGME_KEYLIST_MODE_SIGS} is also
enabled.
+@item GPGME_KEYLIST_MODE_WITH_SECRET
+The @code{GPGME_KEYLIST_MODE_WITH_SECRET} returns information about
+the presence of a corresponding secret key in a public key listing. A
+public key listing with this mode is slower than a standard listing
+but can be used instead of a second run to list the secret keys. This
+is only supported for GnuPG versions >= 2.1.
+
@item GPGME_KEYLIST_MODE_EPHEMERAL
The @code{GPGME_KEYLIST_MODE_EPHEMERAL} symbol specifies that keys
flagged as ephemeral are included in the listing.
@@ -2712,9 +2719,11 @@ This is true if the subkey can be used for qualified signatures
according to local government regulations.
@item unsigned int secret : 1
-This is true if the subkey is a secret key. Note that it will be false
-if the key is actually a stub key; i.e. a secret key operation is
-currently not possible (offline-key).
+This is true if the subkey is a secret key. Note that it will be
+false if the key is actually a stub key; i.e. a secret key operation
+is currently not possible (offline-key). This is only set if a
+listing of secret keys has been requested or if
+@code{GPGME_KEYLIST_MODE_WITH_SECRET} is active.
@item gpgme_pubkey_algo_t pubkey_algo
This is the public key algorithm supported by this subkey.
@@ -2905,9 +2914,10 @@ This is true if the key can be used for qualified signatures according
to local government regulations.
@item unsigned int secret : 1
-This is true if the key is a secret key. Note, that this will always be
-true even if the corresponding subkey flag may be false (offline/stub
-keys).
+This is true if the key is a secret key. Note, that this will always
+be true even if the corresponding subkey flag may be false
+(offline/stub keys). This is only set if a listing of secret keys has
+been requested or if @code{GPGME_KEYLIST_MODE_WITH_SECRET} is active.
@item gpgme_protocol_t protocol
This is the protocol supported by this key.
diff --git a/doc/stamp-vti b/doc/stamp-vti
index 66f8204..c3a4de7 100644
--- a/doc/stamp-vti
+++ b/doc/stamp-vti
@@ -1,4 +1,4 @@
-@set UPDATED 8 May 2014
-@set UPDATED-MONTH May 2014
-@set EDITION 1.5.0
-@set VERSION 1.5.0
+@set UPDATED 30 July 2014
+@set UPDATED-MONTH July 2014
+@set EDITION 1.5.1
+@set VERSION 1.5.1
diff --git a/doc/version.texi b/doc/version.texi
index 66f8204..c3a4de7 100644
--- a/doc/version.texi
+++ b/doc/version.texi
@@ -1,4 +1,4 @@
-@set UPDATED 8 May 2014
-@set UPDATED-MONTH May 2014
-@set EDITION 1.5.0
-@set VERSION 1.5.0
+@set UPDATED 30 July 2014
+@set UPDATED-MONTH July 2014
+@set EDITION 1.5.1
+@set VERSION 1.5.1