[pypy-commit] cffi cffi-1.0: point inside the doc

[arigo]

Author: Armin Rigo <arigo at tunes.org>
Branch: cffi-1.0
Changeset: r2025:22a01db33b77
Date: 2015-05-17 11:04 +0200
http://bitbucket.org/cffi/cffi/changeset/22a01db33b77/

Log:	point inside the doc

diff --git a/doc/source/cdef.rst b/doc/source/cdef.rst
--- a/doc/source/cdef.rst
+++ b/doc/source/cdef.rst
@@ -15,6 +15,8 @@
 
     # use ffi and lib here
 
+.. _out-of-line-abi:
+
 * The **"out-of-line",** but still **"ABI mode",** useful to organize
   the code and reduce the import time::
 
@@ -36,6 +38,8 @@
 
     # use ffi and lib here
 
+.. _out-of-line-api:
+
 * The **"out-of-line", "API mode"** gives you the most flexibility to
   access a C library at the level of C, instead of at the binary
   level::
@@ -60,6 +64,8 @@
 
     # use ffi and lib here
 
+.. _distutils-setuptools:
+
 * Finally, you can (but don't have to) use CFFI's **Distutils** or
   **Setuptools integration** when writing a ``setup.py``.  For
   Distutils (only in out-of-line API mode)::
@@ -631,11 +637,11 @@
     lib = ffi.dlopen("libpath")
 
 and *if* the "stuff" part is big enough that import time is a concern,
-then rewrite it as described in `Out-of-line example (ABI level,
-out-of-line)`__ in the overview_.
+then rewrite it as described in `the out-of-line but still ABI mode`__
+above.  Optionally, see also the `setuptools integration`__ paragraph.
 
-.. __: overview.html#out-of-line-abi
-.. _overview: overview.html
+.. __: out-of-line-abi_
+.. __: distutils-setuptools_
 
 
 **API mode:** if your CFFI project uses::
@@ -646,11 +652,13 @@
     ffi.cdef("stuff")
     lib = ffi.verify("real C code")
 
-then you should really rewrite it as described in `Real example (API
-level, out-of-line)`_ in the overview_.  It avoids a number of issues
-that have caused ``ffi.verify()`` to grow a number of extra arguments
-over time.  Also, remember to remove the ``ext_package=".."`` from
-your ``setup.py``, which was needed with ``verify()`` but is just
-creating confusion with ``set_source()``.
+then you should really rewrite it as described in `the out-of-line,
+API mode`__ above.  It avoids a number of issues that have caused
+``ffi.verify()`` to grow a number of extra arguments over time.  Then
+see the `distutils or setuptools`__ paragraph.  Also, remember to
+remove the ``ext_package=".."`` from your ``setup.py``, which was
+needed with ``verify()`` but is just creating confusion with
+``set_source()``.
 
-.. __: overview.html#real-example
+.. __: out-of-line-api_
+.. __: distutils-setuptools_