Author: Armin Rigo <ar...@tunes.org>
Branch:
Changeset: r1161:c2d972f7e64a
Date: 2013-02-20 21:19 +0100
http://bitbucket.org/cffi/cffi/changeset/c2d972f7e64a/
Log: Small documentation fixes.
diff --git a/doc/source/index.rst b/doc/source/index.rst
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -1050,7 +1050,13 @@
defined in another part for its own usage. Note that the include()
method has no effect on functions, constants and global variables, which
must anyway be accessed directly from the ``lib`` object returned by the
-original FFI instance. *New in version 0.5.*
+original FFI instance. *Note that you should only use one ffi object
+per library; the intended usage of ffi.include() is if you want to
+interface with several inter-dependent libraries.* For only one
+library, make one ``ffi`` object. (If the source becomes too large,
+split it up e.g. by collecting the cdef/verify strings from multiple
+Python modules, as long as you call ``ffi.verify()`` only once.) *New
+in version 0.5.*
.. "versionadded:: 0.5" --- inlined in the previous paragraph
@@ -1216,10 +1222,11 @@
Enum types follow the GCC rules: they are defined as the first of
``unsigned int``, ``int``, ``unsigned long`` or ``long`` that fits
all numeric values. Note that the first choice is unsigned. In CFFI
- 0.5 and before, it was always ``int``. *Unimplemented: if the very
- large values are not declared, the enum size will be incorrectly
- deduced! Work around this by making sure that you name the largest
- value and/or any negative value in the cdef.*
+ 0.5 and before, enums were always ``int``. *Unimplemented: if the enum
+ has very large values in C not declared in CFFI, the enum will incorrectly
+ be considered as an int even though it is really a long! Work around
+ this by naming the largest value. A similar but less important problem
+ involves negative values.*
Debugging dlopen'ed C libraries
_______________________________________________
pypy-commit mailing list
pypy-commit@python.org
http://mail.python.org/mailman/listinfo/pypy-commit
