From 86bf31e9a3e394e6109db32f70deba46d745cf16 Mon Sep 17 00:00:00 2001
From: Guillaume Ayoub <guillaume.ayoub@kozea.fr>
Date: Mon, 9 May 2011 00:38:36 +0200
Subject: [PATCH] Add the logging configuration file in the documentation

---
 pages/user_documentation.rst | 72 ++++++++++++++++++++++++++++++++++--
 1 file changed, 69 insertions(+), 3 deletions(-)

diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst
index 70f19eff..0d9e3261 100644
--- a/pages/user_documentation.rst
+++ b/pages/user_documentation.rst
@@ -145,8 +145,8 @@ Then, launching the server can be easily done by typing as a normal user::
 Configuring Server
 ------------------
 
-Configuration File
-~~~~~~~~~~~~~~~~~~
+Main Configuration File
+~~~~~~~~~~~~~~~~~~~~~~~
 
 .. note::
    This section is following the latest git master changes. Please look at the
@@ -185,7 +185,7 @@ main parameters:
   # Value: None | htpasswd | LDAP
   type = None
   # Personal calendars only available for logged in users
-  personal = False
+  personal = True
   # Htpasswd filename
   htpasswd_filename = /etc/radicale/users
   # Htpasswd encryption method
@@ -215,6 +215,72 @@ This configuration file is read each time the server is launched. If some
 values are not given, the default ones are used. If no configuration file is
 available, all the default values are used.
 
+Logging Configuration File
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Radicale uses the default logging facility for Python. The default
+configuration prints the information messages to the standard output. It is
+possible to print debug messages thanks to::
+
+  radicale --debug
+
+Radicale can also be configured to send the messages to the console, logging
+files, syslog, etc. For more information about the syntax of the configuration
+file, see: http://docs.python.org/library/logging.config.html. Here is an
+example of logging configuration file:
+
+.. code-block:: ini
+
+  # Loggers, handlers and formatters keys
+
+  [loggers]
+  # Loggers names, main configuration slots
+  keys = root
+
+  [handlers]
+  # Logging handlers, defining logging output methods
+  keys = console,file
+
+  [formatters]
+  # Logging formatters
+  keys = simple,full
+
+
+  # Loggers
+
+  [logger_root]
+  # Root logger
+  level = DEBUG
+  handlers = console,file
+
+
+  # Handlers
+
+  [handler_console]
+  # Console handler
+  class = StreamHandler
+  level = INFO
+  args = (sys.stdout,)
+  formatter = simple
+
+  [handler_file]
+  # File handler
+  class = FileHandler
+  args = ('/var/log/radicale',)
+  formatter = full
+
+
+  # Formatter
+
+  [formatter_simple]
+  # Simple output format
+  format = %(message)s
+
+  [formatter_full]
+  # Full output format
+  format = %(asctime)s - %(levelname)s: %(message)s
+
+
 Command Line Options
 ~~~~~~~~~~~~~~~~~~~~