Fix formatting blooper introduced in https://github.com/matrix-org/synapse/pull/1672 :/

Signed-off-by: Johannes Löthberg <johannes@kyriasis.com>

When 546ec1a5 was merged into develop, I accidentally overwrote the change
introduced in debbea5b (pr #1657). Reintroduce it.

Signed-off-by: William Leuschner <wel2138@rit.edu>

Signed-off-by: William Leuschner <wel2138@rit.edu>

Signed-off-by: William Leuschner <wel2138@rit.edu>

Minor updates post-review

The demo client isn't really fit for purpose, so stop encouraging people to use
it.

Add some syntax highlighting

- remove redundant "where's the spec" section: this would belong in "About
matrix", but it's already there.

- E2E is in beta rather than dev

Fix a couple of broken links

Move some bits of the README around. No words were changed in the making of
this commit.

this is rst so name it accordingly

Pip can install multiple dependencies at the same time, so there is no need to
use xargs -n1. It's significantly slower with -n1, so let's not do it with no
reason.

Signed-off-by: Fabian Niepelt <fniepelt@takios.de>

A user on #matrix:matrix.org was confused by the phrasing of the first
sentence in the paragraph and couldn't tell whether it was saying that
the homeserver stored the data or the clients did. This change splits it
into two sentences to make the subject of each sentence clear.

Replace the bash/perl gen_password script with a python one, and write a note
on how to use it.

Signed-off-by: Florent VIOLLEAU <floviolleau@gmail.com>

Add FreeBSD installation instructions for both Ports and Packages now that matrix-synapse has landed [1] in the tree.

[1] https://svnweb.freebsd.org/changeset/ports/405527