Add note on using keyword arguments with OrderedDict.
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index 2e6a537..e27d89a 100644
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -852,6 +852,10 @@
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/>`_