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

1 files changed, 2 insertions, 2 deletions

diff --git a/lasso/id-wsf/data_service.c b/lasso/id-wsf/data_service.c
index c54089b5..1d5804d7 100644
--- a/lasso/id-wsf/data_service.c
+++ b/lasso/id-wsf/data_service.c
@@ -401,7 +401,7 @@ cleanup:
  * lasso_data_service_get_answers_by_select:
  * @service: a #LassoDataService
  * @select: resource selection string (typically a XPath query)
- * @output: a GList** to store a GList* containing the result, it must be freed.
+ * @output: (allow-none) (element-type xmlNode): a GList** to store a GList* containing the result, it must be freed.
  *
  * Returns the answers for the specified @select request.
  *
@@ -493,7 +493,7 @@ cleanup:
  * lasso_data_service_get_answer_for_item_id:
  * @service: a #LassoDataService
  * @item_id: query item identifier
- * @output: a GList** to store a GList* containing the result, it must be freed.
+ * @output: (allow-none) (element-type xmlNode): a GList** to store a GList* containing the result, it must be freed.
  *
  * Returns the answers for the specified @itemID request.
  *