4 files changed, 228 insertions, 0 deletions
diff --git a/docs/reference/.cvsignore b/docs/reference/.cvsignore
new file mode 100644
index 00000000..282522db
--- /dev/null
+++ b/docs/reference/.cvsignore
@@ -0,0 +1,2 @@
+Makefile
+Makefile.in
diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am
new file mode 100644
index 00000000..0468b52d
--- /dev/null
+++ b/docs/reference/Makefile.am
@@ -0,0 +1,144 @@
+NULL=
+TOP=$(top_srcdir)
+MODULE=lasso
+SOURCE_DIR=$(TOP)/lasso
+INCLUDE_DIR=$(TOP)/lasso
+SGML_CATALOG_FILES=/usr/share/sgml/docbook/sgml-dtd-3.0-1.0-8/catalog:/usr/share/sgml/openjade-1.3.1/catalog:/usr/share/sgml/docbook/dsssl-stylesheets/catalog
+
+EXTRA_DIST = \
+	chapters \
+	images \
+	$(NULL)
+
+# Extra options to pass to gtkdoc-scangobj.
+SCANOBJ_OPTIONS=
+
+#
+# We need to pre-process original source files
+# because gtkdoc does not understand some C features
+#
+DOC_SOURCE_DIR=./code
+DOC_SOURCE_FILES=\
+	$(shell find $(SOURCE_DIR) -name '*.c' -print )  \
+	 $(shell find $(INCLUDE_DIR) -name '*.h' -print )
+
+# do nothing for all
+all:
+
+docs: sgml html clean-sources
+
+html: sgml lasso.sgml lasso-index
+	gtkdoc-mkhtml lasso lasso.sgml
+
+SCANOBJ_FILES = 		 \
+	$(MODULE).hierarchy	\
+	$(MODULE).signals \
+	$(MODULE).interfaces \
+	$(MODULE).prerequisites \
+	$(MODULE).args
+
+#
+# Prepeare sgml files from sources for each library. We are also
+# doing some "magic" here by automatically adding links to XML DSig and 
+# XML Enc specification, we also remove "Ptr" from the end of the link
+# targets to make more references
+#
+sgml: templates
+	-@gtkdoc-mkdb --module=lasso \
+		    --main-sgml-file=lasso.sgml \
+		    --source-dir=$(DOC_SOURCE_DIR)/lasso/base
+	-@(for i in `find sgml -name "*.sgml" -print` ; do \
+	    cat $$i | \
+		sed 's!\(&lt;dsig:\)\([^/]*\)\(\/&gt;\)!<ulink URL=\"http://www.w3.org/TR/xmldsig-core/#sec-\2\">\1\2\3</ulink>!g' | \
+		sed 's!\(&lt;enc:\)\([^/]*\)\(\/&gt;\)!<ulink URL=\"http://www.w3.org/TR/xmlenc-core/#sec-\2\">\1\2\3</ulink>!g' | \
+		sed 's!linkend=\"\(.*\)Ptr\"!linkend=\"\1\"!g' > \
+		$$i.tmp; \
+		mv -f $$i.tmp $$i; \
+	done);
+
+templates: scan
+	-@gtkdoc-mktmpl --module=lasso
+
+# CFLAGS and LDFLAGS for compiling scan program.
+GTKDOC_CFLAGS = 		\
+	@CFLAGS@		\
+	@GLIB_CFLAGS@ 		\
+	@LIBXML_CFLAGS@ 	\
+	@XMLSEC1_CFLAGS@ 	\
+	-I$(top_srcdir)
+
+GTKDOC_LIBS = 				\
+	@LIBS@				\
+	@GLIB_LIBS@ -lgobject-2.0 	\
+	@LIBXML_LIBS@ 			\
+	@XMLSEC1_LIBS@ 			\
+	-L$(top_srcdir)/lasso -llasso
+
+GTKDOC_CC=$(LIBTOOL) --mode=compile $(CC)
+GTKDOC_LD=$(LIBTOOL) --mode=link $(CC)
+
+scan: doc_sources
+	if grep -l '^..*$$' $(MODULE).types > /dev/null ; then \
+	    CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANOBJ_OPTIONS) --module=$(MODULE) --output-dir=$(srcdir) ; \
+	else \
+	    for i in $(SCANOBJ_FILES) ; do \
+               test -f $$i || touch $$i ; \
+	    done \
+	fi
+	-@gtkdoc-scan --module=$(MODULE) \
+		    --source-dir=$(DOC_SOURCE_DIR)/lasso/base
+
+$(MODULE)-decl.txt $(SCANOBJ_FILES): scan
+	@true
+
+#
+# Prepare source files by coping them to "code" folder and 
+# removing LASSO_EXPORT_* stuff that makes gtkdoc crazy
+#
+doc_sources: $(DOC_SOURCE_FILES)
+	@(for i in $(DOC_SOURCE_FILES) ; do \
+	    folder_name=`echo $$i | sed 's#$(TOP)/##' | sed 's#/[^/]*$$##'`; \
+	    file_name=`echo $$i | sed 's#.*/##'`; \
+	    test -d $(DOC_SOURCE_DIR)/$$folder_name || mkdir -p $(DOC_SOURCE_DIR)/$$folder_name; \
+	    cat $$i | \
+		sed 's/#if.*//' | \
+		sed 's/#el.*//' | \
+		sed 's/#end.*//' | \
+		sed 's/LASSO_EXPORT_VAR//' | \
+		sed 's/LASSO_EXPORT//' > \
+		$(DOC_SOURCE_DIR)/$$folder_name/$$file_name; \
+	done);
+	-@mkdir -p $(DOC_SOURCE_DIR)/lasso/base
+	-@mv -f $(DOC_SOURCE_DIR)/lasso/*.c $(DOC_SOURCE_DIR)/lasso/base
+
+#
+# Create index for all functions. For macros and defines need to add -CAPS suffix
+#
+lasso-index: scan 
+	@grep -h '<NAME>.*</NAME>' lasso-*decl.txt | \
+		grep -v '<NAME>extern</NAME>' | \
+		sort -u | \
+		sed 's#_#-#g' | \
+		sed 's#<NAME>\([^-]*\)-\([^<]*\)</NAME>#<listitem><para><link linkend=\"\1-\2-CAPS\">\1-\2</link></para></listitem>#g' | \
+		sed 's#<NAME>\([^<]*\)</NAME>#<listitem><para><link linkend=\"\1\">\1</link></para></listitem>#g' > \
+		lasso-index.sgml
+
+dist-hook:
+	@cp -p $(srcdir)/html/*.html $(srcdir)/images/*.png $(srcdir)/*.sgml $(distdir)
+
+clean: clean-sources clean-local
+	-@rm -rf $(DOC_SOURCE_DIR)
+	-@rm -rf .libs
+	-@rm -rf sgml
+	-@rm -rf tmpl
+	-@rm -f $(SCANOBJ_FILES) *.png index.sgml lasso-index.sgml
+
+clean-sources:
+	-@rm -rf code
+
+clean-local:
+	-@rm -rf  $(SCANOBJ_FILES) *.o *~ *.bak *.stamp
+
+maintainer-clean-local: clean
+	-@rm *.html *.txt
+	-@rm -rf `find sgml -name "*.sgml" -print`
diff --git a/docs/reference/lasso.sgml b/docs/reference/lasso.sgml
new file mode 100644
index 00000000..b2ad7b2a
--- /dev/null
+++ b/docs/reference/lasso.sgml
@@ -0,0 +1,63 @@
+<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+<!ENTITY LibAssertion SYSTEM "sgml/lib_assertion.sgml">
+<!ENTITY LibAuthnRequest SYSTEM "sgml/lib_authn_request.sgml">
+<!ENTITY LibAuthnResponse SYSTEM "sgml/lib_authn_response.sgml">
+<!ENTITY LibIDPEntries SYSTEM "sgml/lib_idp_entries.sgml">
+<!ENTITY LibIDPEntry SYSTEM "sgml/lib_idp_entry.sgml">
+<!ENTITY LibIDPList SYSTEM "sgml/lib_idp_list.sgml">
+<!ENTITY LibRequestAuthnContext SYSTEM "sgml/lib_request_authn_context.sgml">
+<!ENTITY LibScoping SYSTEM "sgml/lib_scoping.sgml">
+<!ENTITY SamlAdvice SYSTEM "sgml/saml_advice.sgml">
+<!ENTITY SamlAssertion SYSTEM "sgml/saml_assertion.sgml">
+<!ENTITY SamlNameIdentifier SYSTEM "sgml/saml_name_identifier.sgml">
+<!ENTITY SamlStatementAbstract SYSTEM "sgml/saml_statement_abstract.sgml">
+<!ENTITY SamlSubject SYSTEM "sgml/saml_subject.sgml">
+<!ENTITY SamlSubjectConfirmation SYSTEM "sgml/saml_subject_confirmation.sgml">
+<!ENTITY SamlSubjectStatementAbstract SYSTEM "sgml/saml_subject_statement_abstract.sgml">
+<!ENTITY SamlpRequestAbstract SYSTEM "sgml/samlp_request_abstract.sgml">
+<!ENTITY SamlpResponse SYSTEM "sgml/samlp_response.sgml">
+<!ENTITY SamlpResponseAbstract SYSTEM "sgml/samlp_response_abstract.sgml">
+<!ENTITY SamlpStatus SYSTEM "sgml/samlp_status.sgml">
+<!ENTITY SamlpStatusCode SYSTEM "sgml/samlp_status_code.sgml">
+<!ENTITY LassoNode SYSTEM "sgml/xml.sgml">
+<!ENTITY lasso-export SYSTEM "sgml/export.sgml">
+<!ENTITY lasso-lasso SYSTEM "sgml/lasso.sgml">
+<!ENTITY lasso-version SYSTEM "sgml/version.sgml">
+]>
+<book id="index">
+  <bookinfo>
+    <title>Lasso Library Reference Manual</title>
+  </bookinfo>
+
+  <chapter>
+    <title>Liberty Alliance</title>
+    &LibAssertion;
+    &LibAuthnRequest;
+    &LibAuthnResponse;
+    &LibIDPEntries;
+    &LibIDPEntry;
+    &LibIDPList;
+    &LibRequestAuthnContext;
+    &LibScoping;
+
+    &LassoNode;
+    &lasso-lasso;
+    &lasso-version;
+  </chapter>
+
+  <chapter>
+    <title>Saml</title>
+    &SamlAdvice;
+    &SamlAssertion;
+    &SamlNameIdentifier;
+    &SamlStatementAbstract;
+    &SamlSubject;
+    &SamlSubjectConfirmation;
+    &SamlSubjectStatementAbstract;
+    &SamlpRequestAbstract;
+    &SamlpResponse;
+    &SamlpResponseAbstract;
+    &SamlpStatus;
+    &SamlpStatusCode;
+  </chapter>
+</book>
diff --git a/docs/reference/lasso.types b/docs/reference/lasso.types
new file mode 100644
index 00000000..eeb48f07
--- /dev/null
+++ b/docs/reference/lasso.types
@@ -0,0 +1,19 @@
+#include <lasso/lasso.h>
+
+lib_assertion_get_type
+lib_authn_request_get_type
+lib_authn_response_get_type
+lib_request_authn_context_get_type
+lib_scoping_get_type
+saml_advice_get_type
+saml_assertion_get_type
+saml_name_identifier_get_type
+saml_statement_abstract_get_type
+saml_subject_get_type
+saml_subject_confirmation_get_type
+saml_subject_statement_abstract_get_type
+samlp_request_abstract_get_type
+samlp_response_get_type
+samlp_response_abstract_get_type
+samlp_status_get_type
+samlp_status_code_get_type