Moving compilation from the reference guide to the userguide Part 2

Moving compilation from the reference guide to the userguide Part 1

Closes #2494.

Signed-off-by: Stefan Behnel <stefan_ml@behnel.de>

Exclude EOL-ed Py3.3 from list of supported CPython versions (since we cannot test it on travis anymore). Probably not a big deal for anyone out there, given that even LTS distributions tend to have at least 3.4.

Signed-off-by: Stefan Behnel <stefan_ml@behnel.de>

Allow C line in traceback also during module init

See #2186.

fail early if the module is called cython (and not the submodule)

Misc. typos

Found via `codespell -q 3`

Closes #2484.

docs: Fixed tests under windows.

Added the docs for the compiler options.

Added the docs for the compiler options. Used autodata to avoid duplication of the options descriptions in the docs and in the python file.

Removing oudated pages from the table of content in the documenation main page.

Docs: Undo PR #2439 because readthedocs does not behave as expected.