[pypy-commit] cffi default: Add a mostly empty "whatsnew.rst"

[arigo]

Author: Armin Rigo <arigo at tunes.org>
Branch: 
Changeset: r2050:4c7e3300ea09
Date: 2015-05-18 18:32 +0200
http://bitbucket.org/cffi/cffi/changeset/4c7e3300ea09/

Log:	Add a mostly empty "whatsnew.rst"

diff --git a/doc/source/index.rst b/doc/source/index.rst
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -9,6 +9,7 @@
 .. toctree::
    :maxdepth: 2
 
+   whatsnew
    installation
    overview
    using
diff --git a/doc/source/overview.rst b/doc/source/overview.rst
--- a/doc/source/overview.rst
+++ b/doc/source/overview.rst
@@ -41,6 +41,8 @@
 there, %s!\n"``.  In general it is ``somestring.encode(myencoding)``.
 
 
+.. _out-of-line-abi-level:
+
 Out-of-line example (ABI level, out-of-line)
 --------------------------------------------
 
@@ -49,7 +51,7 @@
 massively reduces the import times, because it is slow to parse a
 large C header.  It also allows you to do more detailed checkings
 during build-time without worrying about performance (e.g. calling
-``cdef()`` several times with small pieces of declarations, based
+``cdef()`` many times with small pieces of declarations, based
 on the version of libraries detected on the system).
 
 .. code-block:: python
@@ -93,6 +95,7 @@
     )
 
 
+.. _out-of-line-api-level:
 .. _real-example:
 
 Real example (API level, out-of-line)
diff --git a/doc/source/whatsnew.rst b/doc/source/whatsnew.rst
new file mode 100644
--- /dev/null
+++ b/doc/source/whatsnew.rst
@@ -0,0 +1,19 @@
+======================
+What's New
+======================
+
+
+1.0.0
+=====
+
+* The main news item is out-of-line module generation:
+
+  * `for ABI level`_, with ``ffi.dlopen()``
+
+  * `for API level`_, which used to be with ``ffi.verify()``, now deprecated
+
+* (this page will list what is new from all versions from 1.0.0
+  forward.)
+
+.. _`for ABI level`: overview.html#out-of-line-abi-level
+.. _`for API level`: overview.html#out-of-line-api-level