better into to clibraries tutorial
authorStefan Behnel <scoder@users.berlios.de>
Tue, 18 Jan 2011 17:51:56 +0000 (18:51 +0100)
committerStefan Behnel <scoder@users.berlios.de>
Tue, 18 Jan 2011 17:51:56 +0000 (18:51 +0100)
src/tutorial/clibraries.rst

index b917123522abaa0ca612a862b8f346d7ce5696df..5cc71be1431ba416792dcfa3661836595955673e 100644 (file)
@@ -4,8 +4,11 @@ Using C libraries
 Apart from writing fast code, one of the main use cases of Cython is
 to call external C libraries from Python code.  As Cython code
 compiles down to C code itself, it is actually trivial to call C
-functions directly in the code.  The following describes what needs to
-be done to use an external C library in Cython code.
+functions directly in the code.  You may have already seen this in the
+simple tutorial on calling C functions.  The following gives a
+complete example for using (and wrapping) an external C library in
+Cython code, including appropriate error handling and considerations
+about designing a suitable API for Python and Cython code.
 
 Imagine you need an efficient way to store integer values in a FIFO
 queue.  Since memory really matters, and the values are actually