Changeset - c45fb78969a3
[Not reviewed]
beta
1 1 1
Marcin Kuzminski - 14 years ago 2012-02-23 01:34:58
marcin@python-works.com
docs updates on git support
2 files changed with 32 insertions and 14 deletions:
0 comments (0 inline, 0 general)
docs/index.rst
Show inline comments
 
.. _index:
 

	
 
.. include:: ./../README.rst
 

	
 
Users Guide
 
-----------
 

	
 
**Installation:**
 

	
 
.. toctree::
 
   :maxdepth: 1
 

	
 
   installation
 
   setup
 
   upgrade
 
   
 
**Usage**
 

	
 
.. toctree::
 
   :maxdepth: 1
 

	
 
   usage/general
 
   usage/enable_git
 
   usage/git_support
 
   usage/statistics
 
   usage/backup
 
   
 
**Develop**
 

	
 
.. toctree::
 
   :maxdepth: 1
 
   
 
   contributing
 
   changelog
 

	
 
**API**
 

	
 
.. toctree::
 
   :maxdepth: 1
 

	
 
   api/api
 
   api/models
 
   
 

	
 
Other topics
 
------------
 

	
 
* :ref:`genindex`
docs/usage/git_support.rst
Show inline comments
 
file renamed from docs/usage/enable_git.rst to docs/usage/git_support.rst
 
.. _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
 
 
 
   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
 
.. _waitress: http://pypi.python.org/pypi/waitress
 
.. _gunicorn: http://pypi.python.org/pypi/gunicorn
 
\ No newline at end of file
0 comments (0 inline, 0 general)