Deprecate 'value' with a warning.

2 files changed, 12 insertions, 2 deletions

diff --git a/setup.py b/setup.py
index 51d3d5c..527a1b3 100644
--- a/setup.py
+++ b/setup.py
@@ -98,6 +98,7 @@ setup(
         'setuptools',
         'python-gettext',
         'pytz',
+        'zope.deprecation',
         'zope.schema',
         'zope.i18nmessageid',
         'zope.component',
diff --git a/src/zope/i18n/locales/inheritance.py b/src/zope/i18n/locales/inheritance.py
index 8489d7d..eee6bf6 100644
--- a/src/zope/i18n/locales/inheritance.py
+++ b/src/zope/i18n/locales/inheritance.py
@@ -20,6 +20,8 @@ locale inheritance is not inheritance in the programming sense.
 """
 __docformat__ = 'restructuredtext'
 
+from zope.deprecation import deprecate
+
 from zope.interface import implementer
 from zope.i18n.interfaces.locales import \
      ILocaleInheritance, IAttributeInheritance, IDictionaryInheritance
@@ -183,6 +185,14 @@ class InheritingDictionary(Inheritance, dict):
 
       >>> sorted(locale.data.values())
       ['eins', 'three', 'two']
+
+    Historically, ``value`` was a synonym of this method; it is still
+    available, but is deprecated::
+
+      >>> from zope.deprecation import Suppressor
+      >>> with Suppressor():
+      ...     sorted(locale.data.value())
+      ['eins', 'three', 'two']
     """
 
 
@@ -228,5 +238,4 @@ class InheritingDictionary(Inheritance, dict):
     def values(self):
         return list(self._make_reified_inherited_dict().values())
 
-    # Preserve the old name for compatibility
-    value = values
+    value = deprecate("`value` is an old synonym for `values`")(values)