docs updates on git support

--HG--
branch : beta
rename : docs/usage/enable_git.rst => docs/usage/git_support.rst

3 files changed, 43 insertions, 25 deletions

diff --git a/docs/index.rst b/docs/index.rst
index 3f101e7f..486a5f9a 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -20,7 +20,7 @@ Users Guide
    :maxdepth: 1
 
    usage/general
-   usage/enable_git
+   usage/git_support
    usage/statistics
    usage/backup
    
diff --git a/docs/usage/enable_git.rst b/docs/usage/enable_git.rst
deleted file mode 100644
index 2f5bb899..00000000
--- a/docs/usage/enable_git.rst
+++ /dev/null
@@ -1,24 +0,0 @@
-.. _enable_git:
-
-Enabling GIT support (beta)
-===========================
-
-
-Git support in RhodeCode 1.1 was disabled due to current instability issues. 
-However,if you would like to test git support please feel free to re-enable it. 
-To re-enable GIT support just uncomment the git line in the 
-file **rhodecode/__init__.py**
-
-.. code-block:: python
- 
-   BACKENDS = {
-       'hg': 'Mercurial repository',
-       #'git': 'Git repository',
-   }
-
-.. note::
-   Please note that the git support provided by RhodeCode is not yet fully
-   stable and RhodeCode might crash while using git repositories. (That is why
-   it is currently disabled.) Thus be careful about enabling git support, and
-   certainly don't use it in a production setting!
-   
\ No newline at end of file
diff --git a/docs/usage/git_support.rst b/docs/usage/git_support.rst
new file mode 100644
index 00000000..f76becef
--- /dev/null
+++ b/docs/usage/git_support.rst
@@ -0,0 +1,42 @@
+.. _git_support:
+
+GIT support
+===========
+
+
+Git support in RhodeCode 1.3 was enabled by default. 
+Although There are some limitations on git usage.
+
+- No hooks are runned for git push/pull actions.
+- logs in action journals don't have git operations
+- large pushes needs http server with chunked encoding support.
+ 
+if you plan to use git you need to run RhodeCode with some
+http server that supports chunked encoding which git http protocol uses, 
+i recommend using waitress_ or gunicorn_ (linux only) for `paste` wsgi app 
+replacement.
+
+To use waitress simply change::
+
+    use = egg:Paste#main
+
+To::
+    
+    use = egg:waitress#main
+
+In you .ini file, then you can simply run `paster serve` as usual.
+
+
+  
+You can always disable git/hg support by editing a 
+file **rhodecode/__init__.py** and commenting out backends
+
+.. code-block:: python
+ 
+   BACKENDS = {
+       'hg': 'Mercurial repository',
+       #'git': 'Git repository',
+   }
+
+.. _waitress: http://pypi.python.org/pypi/waitress
+.. _gunicorn: http://pypi.python.org/pypi/gunicorn
\ No newline at end of file