From 1733c696e56d53be21bf02c67c34258eb0bb714a Mon Sep 17 00:00:00 2001
From: Fabien LOISON <fabien.loison@kozea.fr>
Date: Thu, 4 Aug 2011 17:00:45 +0200
Subject: [PATCH] Apache2 mod_wsgi section added in the user documentation

---
 pages/user_documentation.rst | 40 ++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)

diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst
index a8c04494..5221d095 100644
--- a/pages/user_documentation.rst
+++ b/pages/user_documentation.rst
@@ -340,6 +340,46 @@ options. These options are available by typing::
   radicale --help
 
 
+Use Radicale with Apache2 and mod_wsgi
+--------------------------------------
+
+For using Radicale with Apache's ``mod_wsgi``, you first have to write
+your ``.wsgi`` file (in ``/var/www`` for example):
+
+.. code-block:: python
+
+  import radicale
+  application = radicale.Application()
+
+.. note::
+   We assume that Radicale is installed in your Python path.
+
+Next you have to create the apache virtual host (adapt the configuration
+to your environment):
+
+.. code-block:: apache
+
+  <VirtualHost *:80>
+      ServerName cal.yourdomaine.org
+
+      WSGIDaemonProcess radicale user=www-data group=www-data threads=1
+      WSGIScriptAlias / /var/www/radicale.wsgi
+
+      <Directory /var/www>
+          WSGIProcessGroup radicale
+          WSGIApplicationGroup %{GLOBAL}
+          AllowOverride None
+          Order allow,deny
+          allow from all
+      </Directory>
+  </VirtualHost>
+
+.. note::
+  You should use the root of the (sub)domain (``WSGIScriptAlias /``), else
+  some CalDAV features will not work.
+  
+
+
 Authentication and URLs
 -----------------------