Package: manpages-dev
Version: 3.27-1
Severity: minor
Tags: patch

btowc(3) says:

  This function should never be used.  It does not work for encodings
  which have state, and unnecessarily treats single bytes differently
  from multibyte sequences.  Use the function mbtowc() instead.

but mbtowc(3) says:

  The function mbrtowc(3) provides a better interface to the same
  functionality.

Obviously, btowc(3) should not suggest a non-optimal interface; it
should instead suggest mbrtowc.  This is also true for the pair wctob(3)
and wctomb(3).  A patch is attached to fix both manpages to suggest the
preferable functions.

-- System Information:
Debian Release: squeeze/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.37-rc5-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages manpages-dev depends on:
ii  manpages                      3.27-1     Manual pages about using a GNU/Lin

manpages-dev recommends no packages.

Versions of packages manpages-dev suggests:
ii  konqueror [man-browser]       4:4.4.5-1  advanced file manager, web browser
ii  man-db [man-browser]          2.5.7-7    on-line manual pager

-- no debconf information

-- 
brian m. carlson / brian with sandals: Houston, Texas, US
+1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only
OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187
--- btowc.3.old	2010-12-12 20:30:53.000000000 +0000
+++ btowc.3	2010-12-12 20:33:04.000000000 +0000
@@ -59,11 +59,11 @@
 state, and unnecessarily treats single bytes differently from multibyte
 sequences.
 Use the function
-.BR mbtowc ()
+.BR mbrtowc ()
 instead.
 .SH "SEE ALSO"
 .BR wctob (3),
-.BR mbtowc (3)
+.BR mbrtowc (3)
 .SH COLOPHON
 This page is part of release 3.27 of the Linux
 .I man-pages
--- wctob.3.old	2010-12-12 20:33:20.000000000 +0000
+++ wctob.3	2010-12-12 20:33:47.000000000 +0000
@@ -54,11 +54,11 @@
 Internationalized programs must never
 distinguish single-byte and multibyte characters.
 Use the function
-.BR wctomb (3)
+.BR wcrtomb (3)
 instead.
 .SH "SEE ALSO"
 .BR btowc (3),
-.BR wctomb (3)
+.BR wcrtomb (3)
 .SH COLOPHON
 This page is part of release 3.27 of the Linux
 .I man-pages

Attachment: signature.asc
Description: Digital signature

Reply via email to