diff options
| -rw-r--r-- | lib/libc/locale/frune.c | 3 | ||||
| -rw-r--r-- | lib/libc/locale/rune.3 | 19 |
2 files changed, 22 insertions, 0 deletions
diff --git a/lib/libc/locale/frune.c b/lib/libc/locale/frune.c index 79559bf..b36cee6 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 7c37c40..92763cd 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 |
