Mercurial > public > src > rhodecode
changeset 2111: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