diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/gpgme.info | 228 | ||||
-rw-r--r-- | doc/gpgme.info-1 | 22 | ||||
-rw-r--r-- | doc/gpgme.info-2 | 12 | ||||
-rw-r--r-- | doc/gpgme.texi | 22 | ||||
-rw-r--r-- | doc/stamp-vti | 8 | ||||
-rw-r--r-- | doc/version.texi | 8 |
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 |