summaryrefslogtreecommitdiff
path: root/lib/libc
diff options
context:
space:
mode:
authorTim J. Robbins <tjr@FreeBSD.org>2002-09-18 06:19:12 +0000
committerTim J. Robbins <tjr@FreeBSD.org>2002-09-18 06:19:12 +0000
commit530bb9225d7a47f3fdf6193dff2eab8b87b51712 (patch)
treefd05efea3d01b460fc934c6a5df04a8398476728 /lib/libc
parent7948cae0d2cc563107bc7d601dcfeca3f7d1b3b8 (diff)
Notes
Diffstat (limited to 'lib/libc')
-rw-r--r--lib/libc/locale/frune.c3
-rw-r--r--lib/libc/locale/rune.319
2 files changed, 22 insertions, 0 deletions
diff --git a/lib/libc/locale/frune.c b/lib/libc/locale/frune.c
index 79559bf009b5..b36cee65498c 100644
--- a/lib/libc/locale/frune.c
+++ b/lib/libc/locale/frune.c
@@ -45,6 +45,7 @@ __FBSDID("$FreeBSD$");
#include <stddef.h>
#include <stdio.h>
+__warn_references(fgetrune, "warning: fgetrune() is deprecated. See fgetrune(3).");
long
fgetrune(fp)
FILE *fp;
@@ -72,6 +73,7 @@ fgetrune(fp)
return (_INVALID_RUNE);
}
+__warn_references(fungetrune, "warning: fungetrune() is deprecated. See fungetrune(3).");
int
fungetrune(r, fp)
rune_t r;
@@ -87,6 +89,7 @@ fungetrune(r, fp)
return (0);
}
+__warn_references(fputrune, "warning: fputrune() is deprecated. See fputrune(3).");
int
fputrune(r, fp)
rune_t r;
diff --git a/lib/libc/locale/rune.3 b/lib/libc/locale/rune.3
index 7c37c40b91ff..92763cdfdedf 100644
--- a/lib/libc/locale/rune.3
+++ b/lib/libc/locale/rune.3
@@ -69,6 +69,25 @@
.Ft int
.Fn fputrune "rune_t rune" "FILE *stream"
.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 using
+.Xr setlocale 3 ,
+.Xr mbrtowc 3 ,
+.Xr wcrtomb 3 ,
+.Xr fgetwc 3 ,
+.Xr ungetwc 3 ,
+and
+.Xr fputwc 3
+instead.
+.Pp
The
.Fn setrunelocale
controls the type of encoding used to represent runes as multibyte strings