diff --git a/docs/index.rst b/docs/index.rst --- 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/git_support.rst rename from docs/usage/enable_git.rst rename to docs/usage/git_support.rst --- a/docs/usage/enable_git.rst +++ b/docs/usage/git_support.rst @@ -1,13 +1,35 @@ -.. _enable_git: +.. _git_support: -Enabling GIT support (beta) -=========================== +GIT support +=========== -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** +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 @@ -16,9 +38,5 @@ file **rhodecode/__init__.py** #'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 +.. _waitress: http://pypi.python.org/pypi/waitress +.. _gunicorn: http://pypi.python.org/pypi/gunicorn \ No newline at end of file