From a7ad7fcef32eadcacc046538dcde7be2fcbf3dcf Mon Sep 17 00:00:00 2001 From: Imran Zaman Date: Thu, 13 Jun 2013 12:00:42 +0300 Subject: [PATCH] fixed errors and warnings report by gtk-doc tests --- docs/reference/libgsignon-glib-docs.xml | 1 + docs/reference/libgsignon-glib-sections.txt | 11 +++++++++++ libgsignon-glib/signon-auth-service.c | 3 +++ libgsignon-glib/signon-auth-service.h | 11 +++++++++++ libgsignon-glib/signon-errors.h | 6 +++--- libgsignon-glib/signon-security-context.c | 4 ++-- 6 files changed, 31 insertions(+), 5 deletions(-) diff --git a/docs/reference/libgsignon-glib-docs.xml b/docs/reference/libgsignon-glib-docs.xml index fb8bc6f..cb83094 100644 --- a/docs/reference/libgsignon-glib-docs.xml +++ b/docs/reference/libgsignon-glib-docs.xml @@ -39,6 +39,7 @@ + diff --git a/docs/reference/libgsignon-glib-sections.txt b/docs/reference/libgsignon-glib-sections.txt index 0986e27..eb6938f 100644 --- a/docs/reference/libgsignon-glib-sections.txt +++ b/docs/reference/libgsignon-glib-sections.txt @@ -79,6 +79,8 @@ signon_error_get_type signon-identity SignonIdentity SignonIdentity +SignonIdentityFilter +SignonIdentityList SignonIdentityInfoCb SignonIdentityReferenceAddedCb SignonIdentityReferenceRemovedCb @@ -87,6 +89,7 @@ SignonIdentitySignedOutCb SignonIdentityStoreCredentialsCb SignonIdentityVerifyCb SignonIdentityVoidCb +SignonIdentitySessionReadyCb signon_identity_add_reference signon_identity_create_session signon_identity_get_last_error @@ -99,6 +102,12 @@ signon_identity_signout signon_identity_store_credentials_with_args signon_identity_store_credentials_with_info signon_identity_verify_secret +signon_identity_get_auth_session +signon_identity_info_access_control_list_append +signon_identity_info_get_owner +signon_identity_info_set_methods +signon_identity_info_set_owner +signon_identity_info_set_owner_from_values SignonIdentityClass SignonIdentityPrivate @@ -161,4 +170,6 @@ signon_security_context_list_build_variant signon_security_context_list_deconstruct_variant signon_security_context_list_copy signon_security_context_list_free + +signon_security_context_get_type diff --git a/libgsignon-glib/signon-auth-service.c b/libgsignon-glib/signon-auth-service.c index 5da7ca8..cfd569b 100644 --- a/libgsignon-glib/signon-auth-service.c +++ b/libgsignon-glib/signon-auth-service.c @@ -308,6 +308,7 @@ auth_query_identities_cb (GObject *object, GAsyncResult *res, * SignonQueryIdentitiesCb: * @auth_service: the #SignonAuthService. * @identities: (transfer full): #GList based list of #SignonIdentityInfo. + * @error: a #GError if an error occurred, %NULL otherwise. * @user_data: the user data that was passed when installing this callback. * * Callback to be passed to signon_auth_service_query_identities(). @@ -320,6 +321,8 @@ auth_query_identities_cb (GObject *object, GAsyncResult *res, * @application_context: application security context, can be %NULL. * @cb: (scope async): callback to be invoked. * @user_data: user data. + * + * Query identities. */ void signon_auth_service_query_identities (SignonAuthService *auth_service, diff --git a/libgsignon-glib/signon-auth-service.h b/libgsignon-glib/signon-auth-service.h index 9240dc8..946e172 100644 --- a/libgsignon-glib/signon-auth-service.h +++ b/libgsignon-glib/signon-auth-service.h @@ -74,7 +74,18 @@ typedef void (*SignonQueryMechanismCb) (SignonAuthService *auth_service, const GError *error, gpointer user_data); +/** + * SignonIdentityList: + * + * GList of #SignonIdentity items. + */ typedef GList SignonIdentityList; + +/** + * SignonIdentityFilter: + * + * #GHashTable based filter variant dictionary. + */ typedef GHashTable SignonIdentityFilter; typedef void (*SignonQueryIdentitiesCb) (SignonAuthService *auth_service, diff --git a/libgsignon-glib/signon-errors.h b/libgsignon-glib/signon-errors.h index 4683e51..423d667 100644 --- a/libgsignon-glib/signon-errors.h +++ b/libgsignon-glib/signon-errors.h @@ -35,7 +35,7 @@ * SignonError: * @SIGNON_ERROR_UNKNOWN: Catch-all for errors not distinguished by another code. * @SIGNON_ERROR_INTERNAL_SERVER: Signon daemon internal error. - * @SIGNON_ERROR_INTERNAL_COMMUNICATION: Error communicating with Sigon daemon. + * @SIGNON_ERROR_INTERNAL_COMMUNICATION: Error communicating with Signon daemon. * @SIGNON_ERROR_PERMISSION_DENIED: The operation cannot be performed due to * insufficient client permissions. * @SIGNON_ERROR_METHOD_NOT_KNOWN: The method with this name was not found. @@ -53,7 +53,7 @@ * @SIGNON_ERROR_REFERENCE_NOT_FOUND: Trying to remove non-existent reference. * @SIGNON_ERROR_MECHANISM_NOT_AVAILABLE: The requested mechanism in not * available. - * @SIGNON_ERROR_MISSING_DATA: The #SessionData does not contain the necessary + * @SIGNON_ERROR_MISSING_DATA: The SessionData does not contain the necessary * information. * @SIGNON_ERROR_INVALID_CREDENTIALS: The supplied credentials are invalid for * the mechanism implementation. @@ -65,7 +65,7 @@ * @SIGNON_ERROR_NO_CONNECTION: No network connection. * @SIGNON_ERROR_NETWORK: Network connection failed. * @SIGNON_ERROR_SSL: SSL connection failed. - * @SIGNON_ERROR_RUNTIME: Casting #SessionData into subclass failed. + * @SIGNON_ERROR_RUNTIME: Casting SessionData into subclass failed. * @SIGNON_ERROR_SESSION_CANCELED: Challenge was canceled. * @SIGNON_ERROR_TIMED_OUT: Challenge timed out. * @SIGNON_ERROR_USER_INTERACTION: User interaction dialog failed. diff --git a/libgsignon-glib/signon-security-context.c b/libgsignon-glib/signon-security-context.c index 8d7b022..2999cb9 100644 --- a/libgsignon-glib/signon-security-context.c +++ b/libgsignon-glib/signon-security-context.c @@ -28,7 +28,7 @@ * @short_description: Representation of a security context. * * The #SignonSecurityContext represents a security context within - * sytem and also within application. + * system and also within application. */ #include "signon-security-context.h" @@ -97,7 +97,7 @@ signon_security_context_new_from_values (const gchar *system_context, * * Copy a security context item. * - * Returns: (transfer full) a copy of the #SignonSecurityContex item. + * Returns: (transfer full) a copy of the #SignonSecurityContext item. */ SignonSecurityContext * signon_security_context_copy (const SignonSecurityContext *src_ctx) -- 2.34.1