Docs: change the doc production and lot of other fixes

 * lasso/Makefile.am:
   distribute extract_sections.py
 * docs/references/lasso/lasso.types.in: add missing class (mainly SAML2
   and ID-WSF 1.0/2.0) from docs/references/lasso.types.in

 * lasso/xml/strings.h:
   add lots of documentation, or at least documentation template to
   strings constants.
 * id-ff/login.h:
 * saml-2.0/assertion_query.h:
 * xml/xml.h:
   document undocumented enumerations.
 * lasso/errors.h:
   add proper documentation about error codes.
 * lasso/errors.c:
   new version of the lasso_strerror function
 * lasso/build_strerror.py:
   update the script that generater lasso_strerror from the
   documentation comments.

   Remove usage of OFTYPE

 * lasso/id-ff/session.c:
 * lasso/id-ff/session.h:
   remove usage of oftype, prefer gtk-introspection annotations instead.
 * lasso/id-wsf/data_service.h:
 * lasso/id-wsf/data_service.c:
   do the same.

   Add a script to build lasso-sections.txt

 * lasso/extract_sections.py:
   this script parses header files and generated lasso-sections.txt
   content for GObject class descriptions.

   Add a template file for the lasso-section.txt file

 * docs/references/lasso-sections.txt.in:
   this file serves as a base for the generation of lasso-sections.txt

   Update docs/references/Makefile.am for generating lasso-sections.txt

 * docs/references/Makefile.am:
   always rebuild template, using out of source build directory is too
   weird without it.
   call new script extract_sections.py to regenerate lasso-sections.txt
   if header files changed.

   Update lasso.sgml file with all missing sections

 * docs/reference/lasso.sgml:
   add all missing sections, mainly objects from XML schemas.

 * docs/reference/lasso-sections.txt: update it

 * *.c: add section documentation to some files.
 * lasso/xml/strings.h: fix bad usage or docbook markup

3 files changed, 11 insertions, 8 deletions

diff --git a/lasso/saml-2.0/assertion_query.c b/lasso/saml-2.0/assertion_query.c
index dc31a51d..466d9fa8 100644
--- a/lasso/saml-2.0/assertion_query.c
+++ b/lasso/saml-2.0/assertion_query.c
@@ -148,7 +148,7 @@ lasso_assertion_query_init_request(LassoAssertionQuery *assertion_query,
  * lasso_assertion_query_build_request_msg:
  * @assertion_query: a #LassoAssertionQuery
  *
- * Builds the Name Id Management request message.
+ * Build an Assertion Query profile request message.
  *
  * Return value: 0 on success; or a negative value otherwise.
  **/
diff --git a/lasso/saml-2.0/assertion_query.h b/lasso/saml-2.0/assertion_query.h
index d8aeb4a5..4f9674eb 100644
--- a/lasso/saml-2.0/assertion_query.h
+++ b/lasso/saml-2.0/assertion_query.h
@@ -53,13 +53,16 @@ typedef struct _LassoAssertionQueryPrivate LassoAssertionQueryPrivate;
 
 /**
  * LassoAssertionQueryRequestType::
- * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_UNSET:
- * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_ASSERTION_ID:
- * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_AUTHN:
- * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_ATTRIBUTE:
- * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_AUTHZ_DECISION:
+ * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_UNSET: the unknown value
+ * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_ASSERTION_ID: an AssertionID request, to retrieve an
+ * assertion by its ID.
+ * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_AUTHN: an AuthnQuery request, which is used to request existing authentication assertions about a given subject from an Authentication Authority
+ * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_ATTRIBUTE: an AttributeQuery, which is used to retrieve
+ * attribute an a principal.
+ * @LASSO_ASSERTION_QUERY_REQUEST_TYPE_AUTHZ_DECISION: an AuthzDecisionQuery, which is used to
+ * request authorisation to let a principal access a certain resource.
  *
- * Assertion Query or Request Type.
+ * Enumerate the existing kind of AssertionQuery requests.
  **/
 typedef enum {
 	LASSO_ASSERTION_QUERY_REQUEST_TYPE_UNSET = 0,
diff --git a/lasso/saml-2.0/login.c b/lasso/saml-2.0/login.c
index a4ee5b15..76ef4e0f 100644
--- a/lasso/saml-2.0/login.c
+++ b/lasso/saml-2.0/login.c
@@ -674,7 +674,7 @@ lasso_saml20_login_build_assertion(LassoLogin *login,
 		lasso_assign_string(assertion->Subject->SubjectConfirmation->SubjectConfirmationData->InResponseTo,
 				request_abstract->ID);
 		if (request_abstract->ID) {
-			/**
+			/*
 			 * It MUST NOT contain a NotBefore attribute. If
 			 * the containing message is in response to an <AuthnRequest>,
 			 * then the InResponseTo attribute MUST match the request's ID.