diff options
author | Rico Tzschichholz <ricotz@ubuntu.com> | 2017-04-10 08:58:21 +0200 |
---|---|---|
committer | Rico Tzschichholz <ricotz@ubuntu.com> | 2017-04-10 08:58:21 +0200 |
commit | 8964b1bab05ecfbd47f2185476ef48c86a6b76c9 (patch) | |
tree | a7ce0fa45cb4323591486b598a76827f2f47c6fc /gir/gio-2.0.c | |
parent | 32d130f1a5829acc5827d43735e15e9198c2971d (diff) | |
download | gobject-introspection-8964b1bab05ecfbd47f2185476ef48c86a6b76c9.tar.gz |
gir: Update annotations from GLib 2.52.1
Diffstat (limited to 'gir/gio-2.0.c')
-rw-r--r-- | gir/gio-2.0.c | 34 |
1 files changed, 28 insertions, 6 deletions
diff --git a/gir/gio-2.0.c b/gir/gio-2.0.c index 105a47c1..78528551 100644 --- a/gir/gio-2.0.c +++ b/gir/gio-2.0.c @@ -12380,6 +12380,10 @@ * * Checks if two #GAppInfos are equal. * + * Note that the check <em>may not</em> compare each individual field, and + * only does an identity check. In case detecting changes in the contents + * is needed, program code must additionally compare relevant fields. + * * Returns: %TRUE if @appinfo1 is equal to @appinfo2. %FALSE otherwise. */ @@ -40012,8 +40016,8 @@ * @cancellable: (nullable): a #GCancellable, or %NULL * @error: (nullable): a #GError, or %NULL * - * Verify's a certificate chain after looking up and adding any missing - * certificates to the chain. + * Determines the validity of a certificate chain after looking up and + * adding any missing certificates to the chain. * * @chain is a chain of #GTlsCertificate objects each pointing to the next * certificate in the chain by its %issuer property. The chain may initially @@ -40034,6 +40038,15 @@ * Currently there are no @flags, and %G_TLS_DATABASE_VERIFY_NONE should be * used. * + * If @chain is found to be valid, then the return value will be 0. If + * @chain is found to be invalid, then the return value will indicate + * the problems found. If the function is unable to determine whether + * @chain is valid or not (eg, because @cancellable is triggered + * before it completes) then the return value will be + * %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set + * accordingly. @error is not set when @chain is successfully analyzed + * but found to be invalid. + * * This function can block, use g_tls_database_verify_chain_async() to perform * the verification operation asynchronously. * @@ -40055,9 +40068,9 @@ * @callback: callback to call when the operation completes * @user_data: the data to pass to the callback function * - * Asynchronously verify's a certificate chain after looking up and adding - * any missing certificates to the chain. See g_tls_database_verify_chain() - * for more information. + * Asynchronously determines the validity of a certificate chain after + * looking up and adding any missing certificates to the chain. See + * g_tls_database_verify_chain() for more information. * * Since: 2.30 */ @@ -40070,7 +40083,16 @@ * @error: a #GError pointer, or %NULL * * Finish an asynchronous verify chain operation. See - * g_tls_database_verify_chain() for more information. * + * g_tls_database_verify_chain() for more information. + * + * If @chain is found to be valid, then the return value will be 0. If + * @chain is found to be invalid, then the return value will indicate + * the problems found. If the function is unable to determine whether + * @chain is valid or not (eg, because @cancellable is triggered + * before it completes) then the return value will be + * %G_TLS_CERTIFICATE_GENERIC_ERROR and @error will be set + * accordingly. @error is not set when @chain is successfully analyzed + * but found to be invalid. * * Returns: the appropriate #GTlsCertificateFlags which represents the * result of verification. |