Libc-583.tar.gz

[apple/libc.git] / locale / mbrune.3

diff --git a/locale/mbrune.3 b/locale/mbrune.3
index e6b6432902589c63554e809f9916a54dba7a658e..47fe0061d27cdf8eff9b684e0d714075d37716ba 100644 (file)
--- a/locale/mbrune.3
+++ b/locale/mbrune.3
@@ -33,7 +33,7 @@
 .\" SUCH DAMAGE.
 .\"
 .\"    @(#)mbrune.3    8.2 (Berkeley) 4/19/94
-.\" $FreeBSD: src/lib/libc/locale/mbrune.3,v 1.6.2.4 2001/12/14 18:33:54 ru Exp $
+.\" $FreeBSD: src/lib/libc/locale/mbrune.3,v 1.15 2003/02/06 11:04:46 charnier Exp $
 .\"
 .Dd April 19, 1994
 .Dt MBRUNE 3
@@ -54,6 +54,22 @@
 .Ft char *
 .Fn mbmb "const char *string" "char *pattern"
 .Sh DESCRIPTION
+.Bf Em
+The
+.Bx 4.4
+.Dq rune
+functions have been deprecated in favour of the
+.Tn ISO
+C99 extended multibyte and wide character facilities
+and should not be used in new applications.
+.Ef
+Consider working with wide characters instead, and using
+.Xr wcschr 3 ,
+.Xr wcsrchr 3 ,
+and
+.Xr wcsstr 3
+instead of these functions.
+.Pp
 These routines provide the corresponding functionality of
 .Fn strchr ,
 .Fn strrchr
@@ -66,7 +82,7 @@ The
 function locates the first occurrence of
 .Fn rune
 in the string pointed to by
-.Ar string .
+.Fa string .
 The terminating
 .Dv NUL
 character is considered part of the string.
@@ -140,12 +156,12 @@ or
 if the
 .Fa pattern
 does not appear in the string.
-.Sh "SEE ALSO
-.Xr mbrune 3 ,
+.Sh SEE ALSO
 .Xr rune 3 ,
 .Xr setlocale 3 ,
 .Xr euc 4 ,
-.Xr utf2 4
+.Xr utf2 4 ,
+.Xr utf8 5
 .Sh HISTORY
 The
 .Fn mbrune ,