Update revision history

docs/source/basics.rst

@@ -122,6 +122,8 @@ explains how to download and install mypy.
    the Python interpreter to run mypy. The mypy tool is an ordinary
    mypy (and so also Python) program.
 
+.. _library-stubs:
+
 Library stubs
 *************
 

docs/source/kinds_of_types.rst

@@ -118,6 +118,8 @@ narrow down the type to a specific type:
    f('x')  # OK
    f(1.1)  # Error
 
+.. _optional:
+
 The type of None and optional types
 ***********************************
 
@@ -225,6 +227,8 @@ string-literal types with non-string-literal types freely:
 
 String literal types are never needed in ``# type:`` comments.
 
+.. _type-aliases:
+
 Type aliases
 ************
 
@@ -251,6 +255,8 @@ A type alias does not create a new type. It's just a shorthand notation
 for another type -- it's equivalent to the target type. Type aliases
 can be imported from modules like any names.
 
+.. _named-tuples:
+
 Named tuples
 ************
 

docs/source/revision_history.rst

@@ -3,14 +3,46 @@ Revision history
 
 List of major changes to this document:
 
-- Oct 26 2014: Major restructuring. Split the HTML documentation into
-  multiple pages.
+.. note::
 
-- Sep 15 2014: Migrated docs to Sphinx.
+   Some of the latest changes are not yet supported by the mypy
+   version on PyPI. Use the
+   `development version on GitHub <https://github.com/JukkaL/mypy>`_ to get
+   them.
 
-- Aug 25 2014: Don't discuss native semantics. There is only Python
-  semantics.
+- Mar 2015
+    Update documentation to reflect PEP 484.
+    Add :ref:`named-tuples` and :ref:`optional`.
+    Do not mention type application syntax (for
+    example, ``List[int]()``), as it's no longer supported,
+    due to PEP 484 compatibility. Rename ``typevar`` to
+    ``TypeVar``.
 
-- Jul 2 2013: Rewrite to use new syntax. Shift focus to discussing
-  Python semantics. Add more content, including short discussions of
-  :ref:`generic-functions` and :ref:`union-types`.
+- Jan 2015
+    Mypy moves closer to PEP 484.
+    Add :ref:`type-aliases`. Update discussion of
+    overloading -- it's now only supported in stubs.
+    Rename ``Function[...]`` to ``Callable[...]``.
+
+- Dec 2014
+    Publish mypy version 0.1.0 on PyPI.
+
+- Nov 2014
+    Add :ref:`library-stubs`.
+
+- Oct 2014
+    Major restructuring.
+    Split the HTML documentation into
+    multiple pages.
+
+- Sep 2014
+    Migrated docs to Sphinx.
+
+- Aug 2014
+    Don't discuss native semantics. There is only Python
+    semantics.
+
+- Jul 2013
+    Rewrite to use new syntax. Shift focus to discussing
+    Python semantics. Add more content, including short discussions of
+    :ref:`generic-functions` and :ref:`union-types`.