Started organizing Lasso Reference Manual; documenting LassoProvider.

5 files changed, 252 insertions, 62 deletions

diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am
index 4cc87582..c78cd5ea 100644
--- a/docs/reference/Makefile.am
+++ b/docs/reference/Makefile.am
@@ -1,7 +1,8 @@
 EXTRA_DIST = \
 	lasso-sections.txt \
 	lasso.sgml \
-	lasso.types 
+	lasso.types \
+	version.xml.in
 
 # We need to pre-process original source files
 # because gtkdoc does not understand some C features
@@ -36,7 +37,7 @@ sgml: templates
 		    --tmpl-dir=../tmpl/ \
 		    --source-dir=../$(DOC_SOURCE_DIR)/lasso \
 		    --output-dir=../sgml/
-	cp $(srcdir)/lasso.sgml build/
+	cp $(srcdir)/*.sgml $(srcdir)/version.xml build/
 	(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' | \
diff --git a/docs/reference/lasso-sections.txt b/docs/reference/lasso-sections.txt
index 75c819b1..1e0c8bd7 100644
--- a/docs/reference/lasso-sections.txt
+++ b/docs/reference/lasso-sections.txt
@@ -1,3 +1,34 @@
+<INCLUDE>lasso/lasso.h</INCLUDE>
+
+<SECTION>
+<FILE>provider</FILE>
+<TITLE>LassoProvider</TITLE>
+LassoProvider
+LassoProviderRole
+lassoHttpMethod
+lassoMdProtocolType
+lasso_provider_new
+lasso_provider_get_metadata_one
+lasso_provider_get_metadata_list
+lasso_provider_load_metadata
+lasso_provider_new_from_dump
+lasso_provider_verify_signature
+lasso_provider_get_first_http_method
+lasso_provider_accept_http_method
+lasso_provider_has_protocol_profile
+lasso_provider_get_base64_succint_id
+<SUBSECTION Standard>
+LASSO_PROVIDER
+LASSO_IS_PROVIDER
+LASSO_TYPE_PROVIDER
+lasso_provider_get_type
+LASSO_PROVIDER_CLASS
+LASSO_IS_PROVIDER_CLASS
+LASSO_PROVIDER_GET_CLASS
+</SECTION>
+
+
+
 <SECTION>
 <FILE>lib_assertion</FILE>
 <TITLE>LassoLibAssertion</TITLE>
@@ -1187,49 +1218,6 @@ LASSO_NAME_IDENTIFIER_MAPPING_RESPONSE_GET_CLASS
 </SECTION>
 
 <SECTION>
-<FILE>provider</FILE>
-LASSO_PROVIDER_NODE
-LASSO_PROVIDER_PUBLIC_KEY_NODE
-LASSO_PROVIDER_CA_CERTIFICATE_NODE
-LassoProviderPrivate
-<TITLE>LassoProvider</TITLE>
-LassoProvider
-LassoProviderClass
-lasso_provider_new
-lasso_provider_new_from_metadata_node
-lasso_provider_new_metadata_filename
-lasso_provider_copy
-lasso_provider_destroy
-lasso_provider_dump
-lasso_provider_get_assertionConsumerServiceURL
-lasso_provider_get_authnRequestsSigned
-lasso_provider_get_federationTerminationNotificationProtocolProfile
-lasso_provider_get_federationTerminationServiceReturnURL
-lasso_provider_get_federationTerminationServiceURL
-lasso_provider_get_nameIdentifierMappingProtocolProfile
-lasso_provider_get_providerID
-lasso_provider_get_registerNameIdentifierProtocolProfile
-lasso_provider_get_registerNameIdentifierServiceURL
-lasso_provider_get_registerNameIdentifierServiceReturnURL
-lasso_provider_get_singleSignOnProtocolProfile
-lasso_provider_get_singleSignOnServiceURL
-lasso_provider_get_singleLogoutProtocolProfile
-lasso_provider_get_singleLogoutServiceURL
-lasso_provider_get_singleLogoutServiceReturnURL
-lasso_provider_get_soapEndpoint
-lasso_provider_set_public_key
-lasso_provider_set_ca_certificate
-<SUBSECTION Standard>
-LASSO_PROVIDER
-LASSO_IS_PROVIDER
-LASSO_TYPE_PROVIDER
-lasso_provider_get_type
-LASSO_PROVIDER_CLASS
-LASSO_IS_PROVIDER_CLASS
-LASSO_PROVIDER_GET_CLASS
-</SECTION>
-
-<SECTION>
 <FILE>register_name_identifier_request</FILE>
 <TITLE>LassoRegisterNameIdentifierRequest</TITLE>
 LassoRegisterNameIdentifierRequest
@@ -1407,7 +1395,6 @@ LASSO_LOGOUT_GET_CLASS
 <SECTION>
 <FILE>profile</FILE>
 LassoProfilePrivate
-lassoHttpMethod
 lassoProviderType
 lassoMessageType
 lasso_profile_get_request_type_from_soap_msg
diff --git a/docs/reference/lasso.sgml b/docs/reference/lasso.sgml
index 6e8569ef..042189a2 100644
--- a/docs/reference/lasso.sgml
+++ b/docs/reference/lasso.sgml
@@ -53,15 +53,58 @@
 <!ENTITY LassoProfile SYSTEM "sgml/profile.sgml">
 <!ENTITY LassoServer SYSTEM "sgml/server.sgml">
 <!ENTITY LassoSession SYSTEM "sgml/session.sgml">
-<!ENTITY lasso-tools SYSTEM "sgml/tools.sgml">
+
+<!ENTITY lasso-Liberty-Alliance "liberty-alliance.sgml">
+<!ENTITY version SYSTEM "version.xml">
 ]>
 <book id="index">
   <bookinfo>
-    <title>Lasso API Reference</title>
+    <title>Lasso Reference Manual</title>
+    <releaseinfo>for Lasso &version;</releaseinfo>
   </bookinfo>
 
-  <chapter>
-    <title>Lasso</title>
+  <chapter id="lasso">
+    <title>Lasso Overview</title>
+    <para>
+Lasso is a library which provides all the necessary functions for sites to
+implement Liberty Alliance specifications.
+    </para>
+
+  </chapter>
+
+  
+  <chapter id="architecture">
+    <title>Lasso Architecture</title>
+    &LassoProvider;
+    &LassoServer;
+    &LassoIdentity;
+    &LassoSession;
+  </chapter>
+    
+  <chapter id="idff">
+    <title>Identity Federation Framework</title>
+
+    &LassoProfile;
+    &LassoLogin;
+    &LassoFederation;
+    &LassoLecp;
+    &LassoLogout;
+    &LassoDefederation;
+
+  </chapter>
+
+  <chapter id="idwsf">
+    <title>Identity Web Services Framework</title>
+
+    <para>
+    </para>
+
+  </chapter>
+
+  <chapter id="xml">
+    <title>Schemas</title>
+
+    &LassoNode;
     &LassoLibAssertion;
     &LassoLibAuthnRequest;
     &lasso-LassoLibAuthnRequestEnvelope;
@@ -90,7 +133,6 @@
     &LassoSamlpResponseAbstract;
     &LassoSamlpStatus;
     &LassoSamlpStatusCode;
-    &LassoNode;
     &LassoLibLogoutRequest;
     &LassoLibFederationTerminationNotification;
     &LassoLibLogoutResponse;
@@ -106,16 +148,5 @@
     &lasso-export;
     &lasso-lasso;
     &lasso-version;
-    &LassoFederation;
-    &LassoLecp;
-    &LassoProvider;
-    &LassoDefederation;
-    &LassoIdentity;
-    &LassoLogin;
-    &LassoLogout;
-    &LassoProfile;
-    &LassoServer;
-    &LassoSession;
-    &lasso-tools;
   </chapter>
 </book>
diff --git a/docs/reference/tmpl/provider.sgml b/docs/reference/tmpl/provider.sgml
new file mode 100644
index 00000000..647442ec
--- /dev/null
+++ b/docs/reference/tmpl/provider.sgml
@@ -0,0 +1,170 @@
+<!-- ##### SECTION Title ##### -->
+LassoProvider
+
+<!-- ##### SECTION Short_Description ##### -->
+Representation of a provider
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT LassoProvider ##### -->
+<para>
+
+</para>
+
+@ProviderID: 
+@role: 
+@public_key: 
+@ca_cert_chain: 
+
+<!-- ##### ENUM LassoProviderRole ##### -->
+<para>
+
+</para>
+
+@LASSO_PROVIDER_ROLE_NONE: 
+@LASSO_PROVIDER_ROLE_SP: Acts as service provider
+@LASSO_PROVIDER_ROLE_IDP: Acts as identity provider
+
+<!-- ##### ENUM lassoHttpMethod ##### -->
+<para>
+
+</para>
+
+@LASSO_HTTP_METHOD_NONE: 
+@LASSO_HTTP_METHOD_ANY: Any method will do, select one automatically
+@LASSO_HTTP_METHOD_IDP_INITIATED: 
+@LASSO_HTTP_METHOD_GET: HTTP-GET implementation (for image tags in Single Logout)
+@LASSO_HTTP_METHOD_POST: use an HTML form to post message between service and
+  identity providers
+@LASSO_HTTP_METHOD_REDIRECT: use HTTP 302 redirects to post message between
+  service and identity providers
+@LASSO_HTTP_METHOD_SOAP: use a SOAP call to post message between service and
+  identity providers
+
+<!-- ##### ENUM lassoMdProtocolType ##### -->
+<para>
+
+</para>
+
+@LASSO_MD_PROTOCOL_TYPE_FEDERATION_TERMINATION: Federation Termination
+  Notification
+@LASSO_MD_PROTOCOL_TYPE_NAME_IDENTIFIER_MAPPING: Name Identifier Mapping
+@LASSO_MD_PROTOCOL_TYPE_REGISTER_NAME_IDENTIFIER: Name Registration
+@LASSO_MD_PROTOCOL_TYPE_SINGLE_LOGOUT: Single Logout
+@LASSO_MD_PROTOCOL_TYPE_SINGLE_SIGN_ON: Single Sign-On and Federation
+
+<!-- ##### FUNCTION lasso_provider_new ##### -->
+<para>
+
+</para>
+
+@role: 
+@metadata: 
+@public_key: 
+@ca_cert_chain: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_get_metadata_one ##### -->
+<para>
+
+</para>
+
+@provider: 
+@name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_get_metadata_list ##### -->
+<para>
+
+</para>
+
+@provider: 
+@name: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_load_metadata ##### -->
+<para>
+
+</para>
+
+@provider: 
+@metadata: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_new_from_dump ##### -->
+<para>
+
+</para>
+
+@dump: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_verify_signature ##### -->
+<para>
+
+</para>
+
+@provider: 
+@message: 
+@id_attr_name: 
+@format: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_get_first_http_method ##### -->
+<para>
+
+</para>
+
+@provider: 
+@remote_provider: 
+@protocol_type: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_accept_http_method ##### -->
+<para>
+
+</para>
+
+@provider: 
+@remote_provider: 
+@protocol_type: 
+@http_method: 
+@initiate_profile: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_has_protocol_profile ##### -->
+<para>
+
+</para>
+
+@provider: 
+@protocol_type: 
+@protocol_profile: 
+@Returns: 
+
+
+<!-- ##### FUNCTION lasso_provider_get_base64_succint_id ##### -->
+<para>
+
+</para>
+
+@provider: 
+@Returns: 
+
+
diff --git a/docs/reference/version.xml.in b/docs/reference/version.xml.in
new file mode 100644
index 00000000..d78bda93
--- /dev/null
+++ b/docs/reference/version.xml.in
@@ -0,0 +1 @@
+@VERSION@