moved gtk-doc inline as is better on so many points; also added schema

fragments to published doc

1 files changed, 18 insertions, 11 deletions

diff --git a/lasso/xml/lib_assertion.c b/lasso/xml/lib_assertion.c
index 99eea68c..da5ae9b6 100644
--- a/lasso/xml/lib_assertion.c
+++ b/lasso/xml/lib_assertion.c
@@ -24,21 +24,26 @@
 
 #include <lasso/xml/lib_assertion.h>
 
-/*
- * Authentication assertions provided in an <AuthnResponse> element MUST be of
+/**
+ * SECTION:lib_assertion
+ * @short_description: &lt;lib:Assertion&gt;
+ *
+ * <blockquote>
+ * Authentication assertions provided in an AuthnResponse element MUST be of
  * type AssertionType, which is an extension of saml:AssertionType, so that the
- * RequestID attribute from the original <AuthnRequest> MAY be included in the
- * InResponseTo attribute in the <Assertion> element. This is done because it is
- * not required that the <AuthnResponse> element itself be signed. Instead, the
- * individual <Assertion> elements contained MUST each be signed. Note that it is
+ * RequestID attribute from the original AuthnRequest MAY be included in the
+ * InResponseTo attribute in the Assertion element. This is done because it is
+ * not required that the AuthnResponse element itself be signed. Instead, the
+ * individual Assertion elements contained MUST each be signed. Note that it is
  * optional for the InResponseTo to be present. Its absence indicates that the
- * <AuthnResponse> has been unilaterally sent by the identity provider without a
- * corresponding <AuthnRequest> message from the service provider. If the
+ * AuthnResponse has been unilaterally sent by the identity provider without a
+ * corresponding AuthnRequest message from the service provider. If the
  * attribute is present, it MUST be set to the RequestID of the original
- * <AuthnRequest>.
+ * AuthnRequest.
+ * </blockquote>
  *
- * The schema fragment is as follows:
-
+ * <figure><title>Schema fragment for lib:Assertion</title>
+ * <programlisting><![CDATA[
  * <xs:element name="Assertion" type="AssertionType" substitutionGroup="saml:Assertion" />
  * <xs:complexType name="AssertionType">
  *   <xs:complexContent>
@@ -47,6 +52,8 @@
  *     </xs:extension>
  *   </xs:complexContent>
  * </xs:complexType>
+ * ]]></programlisting>
+ * </figure>
  */
 
 /*****************************************************************************/