Update documentation to align with current practices.

Update doc to discourage the use of `automatic_soa'.

Use Python 'code blocks' for coding examples.

Update some more files.

Mention that 'analyze_modules' is the way to go.

Update syntax.

Update docs according to Ali.
Merge remote-tracking branch 'upstream/master' into upstream-1

Conflicts:
	docs/library.rst