From: Georg Brandl <georg@python.org>
Date: Sat, 19 Jan 2008 10:16:09 +0000 (+0000)
Subject: Amend curses docs by info how to write non-ascii characters.
X-Git-Tag: v2.6a1~549
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=a7d70fd4389f321ab3e34df08a61ec0d9ab262b2;p=python

Amend curses docs by info how to write non-ascii characters.
Thanks to Jeroen Ruigrok van der Werven.
---

diff --git a/Doc/library/curses.rst b/Doc/library/curses.rst
index 22cb62628c..93a57ba521 100644
--- a/Doc/library/curses.rst
+++ b/Doc/library/curses.rst
@@ -19,6 +19,19 @@ for DOS, OS/2, and possibly other systems as well.  This extension module is
 designed to match the API of ncurses, an open-source curses library hosted on
 Linux and the BSD variants of Unix.
 
+.. note::
+
+   Since version 5.4, the ncurses library decides how to interpret non-ASCII data
+   using the ``nl_langinfo`` function.  That means that you have to call
+   :func:`locale.setlocale` in the application and use one of the system's
+   available encodings to encode Unicode strings with it.  This example uses the
+   system's default encoding::
+
+      import locale
+      locale.setlocale(locale.LC_ALL, '')
+      code = locale.getpreferredencoding()
+
+   Then use *code* as the encoding for :meth:`str.encode` calls.
 
 .. seealso::