summaryrefslogtreecommitdiff
path: root/docs/src/quickstart/build.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/src/quickstart/build.rst')
-rw-r--r--docs/src/quickstart/build.rst4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/src/quickstart/build.rst b/docs/src/quickstart/build.rst
index 5d9e8a307..3cbcfa087 100644
--- a/docs/src/quickstart/build.rst
+++ b/docs/src/quickstart/build.rst
@@ -18,6 +18,10 @@ one may want to read more about
There are several ways to build Cython code:
- Write a setuptools ``setup.py``. This is the normal and recommended way.
+ - Run the ``cythonize`` command-line utility. This is a good approach for
+ compiling a single Cython source file directly to an extension.
+ A source file can be built "in place" (so that the extension module is created
+ next to the source file, ready to be imported) with ``cythonize -i filename.pyx``.
- Use :ref:`Pyximport<pyximport>`, importing Cython ``.pyx`` files as if they
were ``.py`` files (using setuptools to compile and build in the background).
This method is easier than writing a ``setup.py``, but is not very flexible.