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, 1 insertions, 2 deletions

diff --git a/lasso/id-ff/session.c b/lasso/id-ff/session.c
index 441214c9..5fab1ec6 100644
--- a/lasso/id-ff/session.c
+++ b/lasso/id-ff/session.c
@@ -209,8 +209,7 @@ add_assertion_to_list(G_GNUC_UNUSED gchar *key, LassoLibAssertion *value, GList
  *
  * Gets the assertions for the given @provider_id.
  *
- * Return value: a GList* of #LassoSamlAssertion.  Caller must free the GList
- *     but NOT the assertions it contains.
+ * Return value: (transfer container) (element-type LassoSamlAssertion): a list of #LassoSamlAssertion.
  **/
 GList*
 lasso_session_get_assertions(LassoSession *session, const char *provider_id)