summary refs log tree commit diff
path: root/README.rst
diff options
context:
space:
mode:
authorRichard van der Hoff <richard@matrix.org>2016-12-12 11:46:46 +0000
committerRichard van der Hoff <richard@matrix.org>2016-12-12 11:46:46 +0000
commit9240948346b86c5291b90169fea6e493337aab91 (patch)
tree94993bd34deaf7c22b22d089f8c89854f5fea9e1 /README.rst
parentMerge pull request #1620 from matrix-org/erikj/concurrent_room_access (diff)
parentMerge pull request #1685 from matrix-org/rav/update_readme_for_tests (diff)
downloadsynapse-9240948346b86c5291b90169fea6e493337aab91.tar.xz
Merge remote-tracking branch 'origin/master' into develop
Diffstat (limited to 'README.rst')
-rw-r--r--README.rst17
1 files changed, 13 insertions, 4 deletions
diff --git a/README.rst b/README.rst
index 0fb7a66cae..21bd63fd64 100644
--- a/README.rst
+++ b/README.rst
@@ -88,7 +88,12 @@ System requirements:
 - Python 2.7
 - At least 1GB of free RAM if you want to join large public rooms like #matrix:matrix.org
 
-Synapse is written in python but some of the libraries is uses are written in
+Installing from source
+----------------------
+(Prebuilt packages are available for some platforms - see `Platform-Specific
+Instructions`_.)
+
+Synapse is written in python but some of the libraries it uses are written in
 C. So before we can install synapse itself we need a working C compiler and the
 header files for python C extensions.
 
@@ -306,7 +311,7 @@ See https://github.com/vector-im/vector-web/issues/1977 and
 https://developer.github.com/changes/2014-04-25-user-content-security for more details.
 
 
-Platform Specific Instructions
+Platform-Specific Instructions
 ==============================
 
 Debian
@@ -789,6 +794,10 @@ Then update the `users` table in the database::
 Synapse Development
 ===================
 
+Before setting up a development environment for synapse, make sure you have the
+system dependencies (such as the python header files) installed - see
+`Installing from source`_.
+
 To check out a synapse for development, clone the git repo into a working
 directory of your choice::
 
@@ -801,7 +810,7 @@ to install using pip and a virtualenv::
     virtualenv env
     source env/bin/activate
     python synapse/python_dependencies.py | xargs pip install
-    pip install setuptools_trial mock
+    pip install lxml mock
 
 This will run a process of downloading and installing all the needed
 dependencies into a virtual env.
@@ -809,7 +818,7 @@ dependencies into a virtual env.
 Once this is done, you may wish to run Synapse's unit tests, to
 check that everything is installed as it should be::
 
-    python setup.py test
+    PYTHONPATH="." trial tests
 
 This should end with a 'PASSED' result::