modernise setup.py example in OpenMP docs

1 files changed, 16 insertions, 27 deletions

diff --git a/docs/src/userguide/parallelism.rst b/docs/src/userguide/parallelism.rst
index 075fead40..e8fe1bfdf 100644
--- a/docs/src/userguide/parallelism.rst
+++ b/docs/src/userguide/parallelism.rst
@@ -160,48 +160,37 @@ It currently supports OpenMP, but later on more backends might be supported.
     Returns the id of the thread. For n threads, the ids will range from 0 to
     n-1.
 
+
 Compiling
 =========
+
 To actually use the OpenMP support, you need to tell the C or C++ compiler to
-enable OpenMP. For gcc this can be done as follows in a setup.py::
+enable OpenMP.  For gcc this can be done as follows in a setup.py::
 
     from distutils.core import setup
     from distutils.extension import Extension
-    from Cython.Distutils import build_ext
+    from Cython.Build import cythonize
 
-    ext_module = Extension(
-        "hello",
-        ["hello.pyx"],
-        extra_compile_args=['-fopenmp'],
-        extra_link_args=['-fopenmp'],
-    )
+    ext_modules = [
+        Extension(
+            "hello",
+            ["hello.pyx"],
+            extra_compile_args=['-fopenmp'],
+            extra_link_args=['-fopenmp'],
+        )
+    ]
 
     setup(
-        name = 'Hello world app',
-        cmdclass = {'build_ext': build_ext},
-        ext_modules = [ext_module],
+        name='hello-parallel-world',
+        ext_modules=cythonize(ext_modules),
     )
 
-For Microsoft Visual C++ compiler::
+For Microsoft Visual C++ compiler, use ``'/openmp'`` instead of ``'-fopenmp'``.
 
-    from distutils.core import setup
-    from distutils.extension import Extension
-    from Cython.Distutils import build_ext
-
-    ext_module = Extension(
-        "hello",
-        ["hello.pyx"],
-        extra_compile_args=['/openmp'],
-    )
-
-    setup(
-        name = 'Hello world app',
-        cmdclass = {'build_ext': build_ext},
-        ext_modules = [ext_module],
-    )
 
 Breaking out of loops
 =====================
+
 The parallel with and prange blocks support the statements break, continue and
 return in nogil mode. Additionally, it is valid to use a ``with gil`` block
 inside these blocks, and have exceptions propagate from them.