Fixed and extended the example; the original example contained some

bogus code.

diff --git a/Doc/lib/liblocale.tex b/Doc/lib/liblocale.tex
index c4c5506569494735ed1940043290440f1da44e2e..6425797d437e2e8a0cdcd152bb14d0dd2c9e825e 100644 (file)
--- a/Doc/lib/liblocale.tex
+++ b/Doc/lib/liblocale.tex
@@ -184,9 +184,12 @@ Example:
 
 \begin{verbatim}
 >>> import locale
->>> locale.open(locale.LC_ALL,"de") #setting locale to German
->>> locale.strcoll("f\344n","foo")  #comparing a string containing an umlaut 
->>> can.close()
+>>> loc = locale.setlocale(locale.LC_ALL) # get current locale
+>>> locale.setlocale(locale.LC_ALL, "de") # use German locale
+>>> locale.strcoll("f\344n", "foo") # compare a string containing an umlaut 
+>>> locale.setlocale(locale.LC_ALL, "") # use user's preferred locale
+>>> locale.setlocale(locale.LC_ALL, "C") # use default (C) locale
+>>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale
 \end{verbatim}
 
 \subsection{Background, details, hints, tips and caveats}

diff --git a/Doc/liblocale.tex b/Doc/liblocale.tex
index c4c5506569494735ed1940043290440f1da44e2e..6425797d437e2e8a0cdcd152bb14d0dd2c9e825e 100644 (file)
--- a/Doc/liblocale.tex
+++ b/Doc/liblocale.tex
@@ -184,9 +184,12 @@ Example:
 
 \begin{verbatim}
 >>> import locale
->>> locale.open(locale.LC_ALL,"de") #setting locale to German
->>> locale.strcoll("f\344n","foo")  #comparing a string containing an umlaut 
->>> can.close()
+>>> loc = locale.setlocale(locale.LC_ALL) # get current locale
+>>> locale.setlocale(locale.LC_ALL, "de") # use German locale
+>>> locale.strcoll("f\344n", "foo") # compare a string containing an umlaut 
+>>> locale.setlocale(locale.LC_ALL, "") # use user's preferred locale
+>>> locale.setlocale(locale.LC_ALL, "C") # use default (C) locale
+>>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale
 \end{verbatim}
 
 \subsection{Background, details, hints, tips and caveats}