Mercurial > kallithea
changeset 6748:29e9cb56f26f
docs: recommend --upgrade for all pip installations in a virtualenv
As suggested by Mads Kiilerich.
Don't recommend this practice when no virtualenv is used, i.e. root
installation or --user installation: in this case upgrading existing packages
may be too disruptive. The user can still add it manually if he so chooses.
| author | Thomas De Schampheleire <thomas.de.schampheleire@gmail.com> |
|---|---|
| date | Thu, 06 Jul 2017 19:47:42 +0200 |
| parents | b39b9bb4a754 |
| children | 84d8cff41282 |
| files | docs/contributing.rst docs/installation.rst docs/upgrade.rst |
| diffstat | 3 files changed, 8 insertions(+), 8 deletions(-) [+] |
line wrap: on
line diff
--- a/docs/contributing.rst Sun Jul 09 15:20:56 2017 +0200 +++ b/docs/contributing.rst Thu Jul 06 19:47:42 2017 +0200 @@ -35,8 +35,8 @@ virtualenv ../kallithea-venv source ../kallithea-venv/bin/activate pip install --upgrade pip setuptools - pip install -e . - pip install -r dev_requirements.txt + pip install --upgrade -e . + pip install --upgrade -r dev_requirements.txt gearbox make-config my.ini gearbox setup-db -c my.ini --user=user --email=user@example.com --password=password --repos=/tmp gearbox serve -c my.ini --reload &
--- a/docs/installation.rst Sun Jul 09 15:20:56 2017 +0200 +++ b/docs/installation.rst Thu Jul 06 19:47:42 2017 +0200 @@ -56,7 +56,7 @@ virtualenv ../kallithea-venv . ../kallithea-venv/bin/activate pip install --upgrade pip setuptools - pip install -e . + pip install --upgrade -e . python2 setup.py compile_catalog # for translation of the UI You can now proceed to :ref:`setup`. @@ -91,8 +91,8 @@ .. note:: Some dependencies are optional. If you need them, install them in the virtualenv too:: - pip install psycopg2 - pip install python-ldap + pip install --upgrade psycopg2 + pip install --upgrade python-ldap This might require installation of development packages using your distribution's package manager. @@ -104,12 +104,12 @@ - Go into the created directory and run this command to install Kallithea:: - pip install kallithea + pip install --upgrade kallithea Alternatively, download a .tar.gz from http://pypi.python.org/pypi/Kallithea, extract it and run:: - pip install . + pip install --upgrade . - This will install Kallithea together with all other required Python libraries into the activated virtualenv.