1 files changed, 102 insertions, 0 deletions
diff --git a/docs/api/chapters/examples.sgml b/docs/api/chapters/examples.sgml
new file mode 100644
index 00000000..05d972d4
--- /dev/null
+++ b/docs/api/chapters/examples.sgml
@@ -0,0 +1,102 @@
+<chapter id="xmlsec-examples">
+    <title>Examples.</title>
+    <sect1 id="xmlsec-examples-overview" >
+	<title>XML Security Library Examples.</title>
+	<para>This section contains several examples of using XML Security Library
+	to sign, veiryf, encrypt or decrypt XML documents.</para>
+    </sect1>
+	
+    <sect1 id="xmlsec-examples-sign-template-file">
+	<title>Signing a template file.</title>
+	
+	&xmlsec-example-sign1;
+	&xmlsec-example-sign1-tmpl;
+    	&xmlsec-example-sign1-res;
+    </sect1>
+	
+    <sect1 id="xmlsec-examples-sign-dynamimc-template">
+	<title>Signing a dynamicaly created template.</title>
+	
+	&xmlsec-example-sign2;
+	&xmlsec-example-sign2-doc;
+    	&xmlsec-example-sign2-res;
+    </sect1>
+	
+    <sect1 id="xmlsec-examples-sign-x509">
+	<title>Signing with X509 certificate.</title>
+	
+	&xmlsec-example-sign3;
+	&xmlsec-example-sign3-doc;
+    	&xmlsec-example-sign3-res;
+    </sect1>
+	
+    <sect1 id="xmlsec-verify-with-key">	
+	<title>Verifying a signature with a single key.</title>
+            
+	&xmlsec-example-verify1;
+    </sect1>
+	
+    <sect1 id="xmlsec-verify-with-keys-mngr">
+	<title>Verifying a signature with keys manager.</title>
+        
+	&xmlsec-example-verify2;
+    </sect1>
+	
+    <sect1 id="xmlsec-verify-with-x509">
+	<title>Verifying a signature with X509 certificates.</title>
+        
+	&xmlsec-example-verify3;
+    </sect1>
+
+    <sect1 id="xmlsec-verify-with-restrictions">
+	<title>Verifying a signature with additional restrictions.</title>
+        
+	&xmlsec-example-verify4;
+	&xmlsec-example-verify4-tmpl;
+	&xmlsec-example-verify4-res;
+	&xmlsec-example-verify4-bad-tmpl;
+	&xmlsec-example-verify4-bad-res;
+    </sect1>
+	
+    <sect1 id="xmlsec-encrypt-template-file">
+	<title>Encrypting data with a template file.</title>
+	
+	&xmlsec-example-encrypt1;
+	&xmlsec-example-encrypt1-tmpl;
+    	&xmlsec-example-encrypt1-res;
+    </sect1>
+
+    <sect1 id="xmlsec-encrypt-dynamic-template">
+	<title>Encrypting data with a dynamicaly created template.</title>
+	
+	&xmlsec-example-encrypt2;
+    	&xmlsec-example-encrypt2-doc;
+	&xmlsec-example-encrypt2-res;
+    </sect1>
+
+    <sect1 id="xmlsec-encrypt-with-session-key">	
+	<title>Encrypting data with a session key.</title>
+	
+	&xmlsec-example-encrypt3;
+	&xmlsec-example-encrypt3-doc;
+	&xmlsec-example-encrypt3-res;
+    </sect1>
+	
+    <sect1 id="xmlsec-decrypt-with-signle-key">
+	<title>Decrypting data with a single key.</title>
+	
+	&xmlsec-example-decrypt1;
+    </sect1>
+	
+    <sect1 id="xmlsec-decrypt-with-keys-mngr">
+	<title>Decrypting data with keys manager.</title>
+	
+	&xmlsec-example-decrypt2;
+    </sect1>
+	
+    <sect1 id="xmlsec-custom-keys-manager">
+	<title>Writing a custom keys manager.</title>
+        
+	&xmlsec-example-decrypt3;
+    </sect1>
+</chapter>