PR6694: Deprecate Latin-1 string manipulation functions.

Also, add documentation for the US-ASCII variants.

From: Peter Zotov <whitequark@whitequark.org>

git-svn-id: http://caml.inria.fr/svn/ocaml/trunk@15729 f963ae5c-01c2-4b8c-9fe0-0dff7051ff02

1 files changed, 16 insertions, 5 deletions

diff --git a/stdlib/char.mli b/stdlib/char.mli
index 88094bd2bd..f70ab5ea52 100644
--- a/stdlib/char.mli
+++ b/stdlib/char.mli
@@ -27,10 +27,24 @@ val escaped : char -> string
    of OCaml. *)
 
 val lowercase : char -> char
-(** Convert the given character to its equivalent lowercase character. *)
+  [@@ocaml.deprecated "Use Char.lowercase_ascii instead."]
+(** Convert the given character to its equivalent lowercase character,
+   using the ISO Latin-1 (8859-1) character set.
+   @deprecated Functions operating on Latin-1 character set are deprecated. *)
 
 val uppercase : char -> char
-(** Convert the given character to its equivalent uppercase character. *)
+  [@@ocaml.deprecated "Use Char.uppercase_ascii instead."]
+(** Convert the given character to its equivalent uppercase character,
+   using the ISO Latin-1 (8859-1) character set.
+   @deprecated Functions operating on Latin-1 character set are deprecated. *)
+
+val lowercase_ascii : char -> char
+(** Convert the given character to its equivalent lowercase character,
+   using the US-ASCII character set. *)
+
+val uppercase_ascii : char -> char
+(** Convert the given character to its equivalent uppercase character,
+   using the US-ASCII character set. *)
 
 type t = char
 (** An alias for the type of characters. *)
@@ -47,9 +61,6 @@ val equal: t -> t -> bool
 
 (**/**)
 
-val lowercase_ascii : char -> char
-val uppercase_ascii : char -> char
-
 (* The following is for system use only. Do not call directly. *)
 
 external unsafe_chr : int -> char = "%identity"