Example of using package_data for pxd files.

1 files changed, 14 insertions, 0 deletions

diff --git a/docs/src/reference/compilation.rst b/docs/src/reference/compilation.rst
index 837506249..5637d0ec5 100644
--- a/docs/src/reference/compilation.rst
+++ b/docs/src/reference/compilation.rst
@@ -222,6 +222,20 @@ list in the Extensions when not using Cython::
             extension.sources[:] = sources
         return extensions
 
+If you want to expose the C-level interface of your library for other
+libraries to cimport from, use package_data to install the ``.pxd`` files,
+e.g.::
+
+    setup(
+        package_data = {
+            'my_package': ['*.pxd'],
+            'my_package/sub_package': ['*.pxd'],
+        },
+        ...
+    )
+
+These ``.pxd`` files need not correspond have corresponding ``.pyx``
+modules if they contain purely declarations of external libraries.
 
 Compiling with ``pyximport``
 =============================