Add note on using keyword arguments with OrderedDict.

diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index ec0ae4b42fb4efa912a889668adbaa7977b3b7c8..d5702289c3eec564d76fb59b98939ada87bb28e0 100644 (file)
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -875,6 +875,10 @@ Equality tests between :class:`OrderedDict` objects and other
 This allows :class:`OrderedDict` objects to be substituted anywhere a
 regular dictionary is used.
 
+The :class:`OrderedDict` constructor and :meth:`update` method both accept
+keyword arguments, but their order is lost because Python's function call
+semantics pass-in keyword arguments using a regular unordered dictionary.
+
 .. seealso::
 
    `Equivalent OrderedDict recipe <http://code.activestate.com/recipes/576693/>`_