Add note on using keyword arguments with OrderedDict.

diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index 2e6a537828164cc0e7a7f22189388954e94cf271..e27d89ae84fd2cd336e4bb0d872245ffb81fe96f 100644 (file)
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -852,6 +852,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/>`_