bpo-30662: fixed OrderedDict.__init__ docstring re PEP 468 (#2179)

* fixed OrderedDict.__init__ docstring re PEP 468

* tightened comment and mirrored to C impl

* added space after period per marco-buttu

* preserved substituted for stable

* drop references to Python 3.6 and PEP 468

Lib/collections/__init__.py

@@ -85,9 +85,7 @@ class OrderedDict(dict):
 
     def __init__(*args, **kwds):
         '''Initialize an ordered dictionary.  The signature is the same as
-        regular dictionaries, but keyword arguments are not recommended because
+        regular dictionaries.  Keyword argument order is preserved.
-        their insertion order is arbitrary.
-
         '''
         if not args:
             raise TypeError("descriptor '__init__' of 'OrderedDict' object "

Objects/odictobject.c

@@ -882,8 +882,7 @@ odict_eq(PyObject *a, PyObject *b)
 
 PyDoc_STRVAR(odict_init__doc__,
 "Initialize an ordered dictionary.  The signature is the same as\n\
-        regular dictionaries, but keyword arguments are not recommended because\n\
+        regular dictionaries.  Keyword argument order is preserved.\n\
-        their insertion order is arbitrary.\n\
 \n\
         ");