comparison docs/usage/vcs_support.rst @ 4970:601282d36c06

docs/usage: generalize 'git support' into 'version control systems support' Rename and rework the 'git support' page such that it can hold information about Mercurial as well.
author Thomas De Schampheleire <thomas.de.schampheleire@gmail.com>
date Sun, 05 Apr 2015 20:46:21 +0200
parents docs/usage/git_support.rst@4e6dfdb3fa01
children 9cef5a168b88
comparison
equal deleted inserted replaced
4969:e5ab200892e3 4970:601282d36c06
1 .. _vcs_support:
2
3 ===============================
4 Version control systems support
5 ===============================
6
7 Kallithea supports Git and Mercurial repositories out-of-the-box.
8 For Git, you do need the ``git`` command line client installed on the server.
9
10 You can always disable Git or Mercurial support by editing the
11 file ``kallithea/__init__.py`` and commenting out the backend.
12
13 .. code-block:: python
14
15 BACKENDS = {
16 'hg': 'Mercurial repository',
17 #'git': 'Git repository',
18 }
19
20 Git support
21 -----------
22
23 Web server with chunked encoding
24 ````````````````````````````````
25 Large Git pushes require an HTTP server with support for
26 chunked encoding for POST. The Python web servers waitress_ and
27 gunicorn_ (Linux only) can be used. By default, Kallithea uses
28 waitress_ for `paster serve` instead of the built-in `paste` WSGI
29 server.
30
31 The default paste server is controlled in the .ini file::
32
33 use = egg:waitress#main
34
35 or::
36
37 use = egg:gunicorn#main
38
39
40 Also make sure to comment out the following options::
41
42 threadpool_workers =
43 threadpool_max_requests =
44 use_threadpool =
45
46
47
48 .. _waitress: http://pypi.python.org/pypi/waitress
49 .. _gunicorn: http://pypi.python.org/pypi/gunicorn