From 6353b145f90bbfe980b308949165953d6eae9747 Mon Sep 17 00:00:00 2001
From: Christoph Groth <christoph.groth@cea.fr>
Date: Tue, 8 Dec 2015 16:50:20 +0100
Subject: [PATCH] provide whatsnew file
---
doc/source/pre/whatsnew/1.2.rst | 28 ++++++++++++++++++++++++++++
doc/source/pre/whatsnew/index.rst | 1 +
2 files changed, 29 insertions(+)
create mode 100644 doc/source/pre/whatsnew/1.2.rst
diff --git a/doc/source/pre/whatsnew/1.2.rst b/doc/source/pre/whatsnew/1.2.rst
new file mode 100644
index 00000000..38751b83
--- /dev/null
+++ b/doc/source/pre/whatsnew/1.2.rst
@@ -0,0 +1,28 @@
+What's new in Kwant 1.2
+=======================
+
+This article explains the user-visible changes in Kwant 1.2, released on 9
+December 2015. Please consult the `full list of changes in Kwant
+<https://gitlab.kwant-project.org/kwant/kwant/compare/v1.2.2...stable>`_ for
+all the changes up to the most recent bugfix release.
+
+Kwant 1.2 is identical to Kwant 1.1 except that it has been updated to run on
+Python 3.4 and above. Bugfix releases for the 1.1 and 1.2 series will mirror
+each other, i.e. 1.1.3 and 1.2.3 will fix the same bugs.
+
+Starting with Kwant 1.2, all Kwant development will target Python 3. We plan,
+however, to maintain Python 2 support with the 1.1 series for several years.
+
+
+How to upgrade Kwant scripts to Python 3
+----------------------------------------
+Even though the interface and functionality of Kwant remain unchanged between
+versions 1.1 and 1.2, scripts using Kwant need to be updated to Python 3.
+This can be done by running the `automatic conversion tool
+<https://docs.python.org/3/library/2to3.html>`_ on the command line::
+
+ 2to3 -w example.py
+
+(The above command will rename the original file to ``example.py.bak``.) The
+necessary changes are typically only superficial, as described in `What’s New
+In Python 3.0 <https://docs.python.org/3/whatsnew/3.0.html>`_.
diff --git a/doc/source/pre/whatsnew/index.rst b/doc/source/pre/whatsnew/index.rst
index b97a4f12..141ac251 100644
--- a/doc/source/pre/whatsnew/index.rst
+++ b/doc/source/pre/whatsnew/index.rst
@@ -2,6 +2,7 @@ What's new in Kwant
===================
.. toctree::
+ 1.2
1.1
1.0
0.2
--
GitLab