diff -r df5da1a46683 Doc/library/locale.rst
--- a/Doc/library/locale.rst	Tue Jun 24 19:47:34 2014 +0100
+++ b/Doc/library/locale.rst	Thu Jun 26 00:36:57 2014 +0100
@@ -269,6 +269,11 @@
 
 .. function:: getdefaultlocale([envvars])
 
+.. note::
+
+   This function exists for backwards compatibility only.  For new code we
+   recommend using :func:`getpreferredencoding`.
+
    Tries to determine the default locale settings and returns them as a tuple of
    the form ``(language code, encoding)``.