moved gtk-doc inline as is better on so many points; also added schema

fragments to published doc

1 files changed, 24 insertions, 0 deletions

diff --git a/lasso/xml/lib_authn_request.h b/lasso/xml/lib_authn_request.h
index b76034ad..63d55f41 100644
--- a/lasso/xml/lib_authn_request.h
+++ b/lasso/xml/lib_authn_request.h
@@ -48,6 +48,30 @@ extern "C" {
 typedef struct _LassoLibAuthnRequest LassoLibAuthnRequest;
 typedef struct _LassoLibAuthnRequestClass LassoLibAuthnRequestClass;
 
+/**
+ * LassoLibAuthnRequest:
+ *
+ * @ProviderID isthe service provider identifier, this field will often be
+ * filled with lasso_login_init_authn_request()
+ *
+ * @nameIDPolicy tells the identity provider about the policy to use for
+ * federation; it must be one of #LASSO_LIB_NAMEID_POLICY_TYPE_NONE,
+ * #LASSO_LIB_NAMEID_POLICY_TYPE_ONE_TIME,
+ * #LASSO_LIB_NAMEID_POLICY_TYPE_FEDERATED or
+ * #LASSO_LIB_NAMEID_POLICY_TYPE_ANY.
+ *
+ * @IsPassive; if %TRUE (default) it tells the identity provider not to
+ * interact with the user.
+ *
+ * @ForceAuthn; only used if @IsPassive is %FALSE, it tells the identity
+ * provider to force authentication of the user even when already
+ * authenticated.
+ *
+ * @ProtocolProfile is the Single Sign-On and Federation profile to adopt;
+ * either #LASSO_LIB_PROTOCOL_PROFILE_BRWS_ART (which is the default value)
+ * or #LASSO_LIB_PROTOCOL_PROFILE_BRWS_POST.
+ *
+ */
 struct _LassoLibAuthnRequest {
 	LassoSamlpRequestAbstract parent;