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, 14 insertions, 0 deletions

diff --git a/lasso/id-wsf-2.0/server.c b/lasso/id-wsf-2.0/server.c
index ce460041..16fa3038 100644
--- a/lasso/id-wsf-2.0/server.c
+++ b/lasso/id-wsf-2.0/server.c
@@ -44,6 +44,12 @@ lasso_server_add_svc_metadata(LassoServer *server, LassoIdWsf2DiscoSvcMetadata *
 }
 
 
+/**
+ * lasso_server_get_svc_metadatas:
+ * @server: a #LassoServer object
+ *
+ * Return value: (element-type LassoIdWsf2DiscoSvcMetadata) (transfer none): a list of #LassoIdWsf2DiscoSvcMetadata
+ */
 const GList *
 lasso_server_get_svc_metadatas(LassoServer *server)
 {
@@ -53,6 +59,14 @@ lasso_server_get_svc_metadatas(LassoServer *server)
 }
 
 
+/**
+ * lasso_server_get_svc_metadatas_with_id_and_type:
+ * @server: a #LassoServer object
+ * @svcMDIDS: a list of service metadata IDs
+ * @service_type: a service type identifier
+ *
+ * Return value: (element-type LassoIdWsf2DiscoSvcMetadata) (transfer none): a list of #LassoIdWsf2DiscoSvcMetadata
+ */
 GList *
 lasso_server_get_svc_metadatas_with_id_and_type(LassoServer *server, GList *svcMDIDs,
 	const gchar *service_type)