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
 .\" 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
 .\"
 .Dd April 19, 1994
 .Dt MBRUNE 3


@@ -54,6 +54,22 @@
 .Ft char *
 .Fn mbmb "const char *string" "char *pattern"
 .Sh DESCRIPTION
 .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
 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
 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.
 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.
 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 rune 3 ,
 .Xr setlocale 3 ,
 .Xr euc 4 ,

-.Xr utf2 4
+.Xr utf2 4 ,
+.Xr utf8 5

 .Sh HISTORY
 The
 .Fn mbrune ,
 .Sh HISTORY
 The
 .Fn mbrune ,