changeset 2023:c45fb78969a3 beta

docs updates on git support
author Marcin Kuzminski <marcin@python-works.com>
date Thu, 23 Feb 2012 02:34:58 +0200
parents b43a121f3137
children 370e995e46c2
files docs/index.rst docs/usage/enable_git.rst docs/usage/git_support.rst
diffstat 3 files changed, 43 insertions(+), 25 deletions(-) [+]
line wrap: on
line diff
--- a/docs/index.rst	Wed Feb 22 21:26:08 2012 +0200
+++ b/docs/index.rst	Thu Feb 23 02:34:58 2012 +0200
@@ -20,7 +20,7 @@
    :maxdepth: 1
 
    usage/general
-   usage/enable_git
+   usage/git_support
    usage/statistics
    usage/backup
    
--- a/docs/usage/enable_git.rst	Wed Feb 22 21:26:08 2012 +0200
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -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
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/usage/git_support.rst	Thu Feb 23 02:34:58 2012 +0200
@@ -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