From c764e3e197d09ed10f1edc1be150f553c693f34c Mon Sep 17 00:00:00 2001 From: Jean-Marc Martins Date: Mon, 2 Sep 2013 10:00:37 +0200 Subject: [PATCH 1/2] Added the doc for the git support in Radicale --- pages/user_documentation.rst | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index 5971d98e..804e9235 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -705,6 +705,38 @@ Some authentication methods need additional modules, see `Python Versions and OS Support`_ for further information. +Git Support +----------- + +.. note:: + If the project doesn't comply with the requirements to use Git, Radicale will still work. + Your collections will run fine but without the versionning system. + +Git is now automatically supported on Radicale. It depends on `dulwich `_. + + +Configure Radicale +~~~~~~~~~~~~~~~~~~ + +Radicale automatically detects the *.git* folder in the path you configured for +the filesystem_folder variable in the ``[storage]`` section of your configuration file. +Make sure a repository is created at this location or create one (using *git init +.* for instance) else it won't work. + +To summarize :  + +- Configure your Git installation +- Get Radicale and dulwich +- Create the repository where your collections are stored +- Run Radicale and it should work + +How it works +~~~~~~~~~~~~ + +Radicale will automatically commit any changes on your collections. It +will use your git config to find parameters such as the committer and that's all. + + Rights Management ----------------- From 9a8bdbbc4a7f597bd06544aa0efad0c1a9a3ffa3 Mon Sep 17 00:00:00 2001 From: Jean-Marc Martins Date: Mon, 2 Sep 2013 10:14:05 +0200 Subject: [PATCH 2/2] =?UTF-8?q?Adds=20explanations=20about=20Python=203?= =?UTF-8?q?=C2=A0not=20supported=20yet?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- pages/user_documentation.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/pages/user_documentation.rst b/pages/user_documentation.rst index 804e9235..d94c3849 100644 --- a/pages/user_documentation.rst +++ b/pages/user_documentation.rst @@ -737,6 +737,15 @@ Radicale will automatically commit any changes on your collections. It will use your git config to find parameters such as the committer and that's all. +Issues +~~~~~~ + +A dulwich project ported on Python 3 exists but it seems that it doesn't follow the +current api (committer is mandatory and not retrieved from the git config by +default). Until this problem isn't fixed, the Git support for Radicale on +Python 3 will not be ensured. + + Rights Management -----------------