From cb8e7d06f9313206dd8f95511c80979158f6be11 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Martin=20v=2E=20L=C3=B6wis?= <martin@v.loewis.de>
Date: Thu, 3 Jun 2004 09:48:25 +0000
Subject: [PATCH] Document which string methods are locale-dependent. Fixes
 #935749.

---
 Doc/lib/libstdtypes.tex | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/Doc/lib/libstdtypes.tex b/Doc/lib/libstdtypes.tex
index f5a70bbf06b2..a50eb12f1e19 100644
--- a/Doc/lib/libstdtypes.tex
+++ b/Doc/lib/libstdtypes.tex
@@ -544,6 +544,8 @@ objects support:
 
 \begin{methoddesc}[string]{capitalize}{}
 Return a copy of the string with only its first character capitalized.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{center}{width}
@@ -605,26 +607,36 @@ substring is not found.
 \begin{methoddesc}[string]{isalnum}{}
 Return true if all characters in the string are alphanumeric and there
 is at least one character, false otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{isalpha}{}
 Return true if all characters in the string are alphabetic and there
 is at least one character, false otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{isdigit}{}
 Return true if all characters in the string are digits and there
 is at least one character, false otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{islower}{}
 Return true if all cased characters in the string are lowercase and
 there is at least one cased character, false otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{isspace}{}
 Return true if there are only whitespace characters in the string and
 there is at least one character, false otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{istitle}{}
@@ -632,11 +644,15 @@ Return true if the string is a titlecased string and there is at least one
 character, i.e. uppercase characters may only follow uncased
 characters and lowercase characters only cased ones.  Return false
 otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{isupper}{}
 Return true if all cased characters in the string are uppercase and
 there is at least one cased character, false otherwise.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{join}{seq}
@@ -653,6 +669,8 @@ Padding is done using spaces.  The original string is returned if
 
 \begin{methoddesc}[string]{lower}{}
 Return a copy of the string converted to lowercase.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{lstrip}{\optional{chars}}
@@ -731,11 +749,15 @@ the both ends of the string this method is called on.
 \begin{methoddesc}[string]{swapcase}{}
 Return a copy of the string with uppercase characters converted to
 lowercase and vice versa.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{title}{}
 Return a titlecased version of the string: words start with uppercase
 characters, all remaining cased characters are lowercase.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{translate}{table\optional{, deletechars}}
@@ -757,6 +779,8 @@ character mapping codec using the \refmodule{codecs} module (see
 
 \begin{methoddesc}[string]{upper}{}
 Return a copy of the string converted to uppercase.
+
+For 8-bit strings, this method is locale-dependent.
 \end{methoddesc}
 
 \begin{methoddesc}[string]{zfill}{width}
-- 
2.47.3