get_global: format key documentation, add warning

diff --git a/babel/core.py b/babel/core.py
index 4088a09f59aade21b8119b0cdb0e0c6c02e14506..4a284e893fbeb73d396938b7a73897cf7655f9cf 100644 (file)
--- a/babel/core.py
+++ b/babel/core.py
@@ -43,10 +43,23 @@ def get_global(key):
     >>> get_global('zone_territories')['Europe/Berlin']
     u'DE'
 
-    The keys available are ``currency_fractions``, ``language_aliases``, ``likely_subtags``,
-    ``parent_exceptions``, ``script_aliases``, ``territory_aliases``, ``territory_currencies``,
-    ``territory_languages``, ``territory_zones``, ``variant_aliases``, ``win_mapping``,
-    ``zone_aliases`` and ``zone_territories``.
+    The keys available are:
+
+    - ``currency_fractions``
+    - ``language_aliases``
+    - ``likely_subtags``
+    - ``parent_exceptions``
+    - ``script_aliases``
+    - ``territory_aliases``
+    - ``territory_currencies``
+    - ``territory_languages``
+    - ``territory_zones``
+    - ``variant_aliases``
+    - ``win_mapping``
+    - ``zone_aliases``
+    - ``zone_territories``
+
+    .. note:: The internal structure of the data may change between versions.
 
     .. versionadded:: 0.9