bcmp.3, memcmp.3, strcasecmp.3, strcmp.3, strcoll.3, strxfrm.3: Deprecate bcmp(3)

It is identical to memcmp(3).  Use that.

Signed-off-by: Alejandro Colomar <alx@kernel.org>

diff --git a/man3/bcmp.3 b/man3/bcmp.3
index e7f43e8f55902e33fa92420d9d984d78d232b0f5..7bad3387f0f55bb0fb05067ab56d2413eda1264b 100644 (file)
--- a/man3/bcmp.3
+++ b/man3/bcmp.3
@@ -1,14 +1,7 @@
-'\" t
-.\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
+.\" Copyright 2022 Alejandro Colomar <alx@kernel.org>
 .\"
 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
-.\" References consulted:
-.\"     Linux libc source code
-.\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
-.\"     386BSD man pages
-.\" Modified Sat Jul 24 21:36:50 1993 by Rik Faith <faith@cs.unc.edu>
-.\" Modified Tue Oct 22 23:47:36 1996 by Eric S. Raymond <esr@thyrsus.com>
 .TH bcmp 3 (date) "Linux man-pages (unreleased)"
 .SH NAME
 bcmp \- compare byte sequences
@@ -23,55 +16,14 @@ Standard C library
 size_t " n );
 .fi
 .SH DESCRIPTION
-The
 .BR bcmp ()
-function compares the two byte sequences
-.I s1
-and
-.I s2
-of length
-.I n
-each.
-If they are equal, and in particular if
-.I n
-is zero,
-.BR bcmp ()
-returns 0.
-Otherwise, it returns a nonzero result.
-.SH RETURN VALUE
-The
-.BR bcmp ()
-function returns 0 if the byte sequences are equal,
-otherwise a nonzero result is returned.
-.SH ATTRIBUTES
-For an explanation of the terms used in this section, see
-.BR attributes (7).
-.ad l
-.nh
-.TS
-allbox;
-lbx lb lb
-l l l.
-Interface      Attribute       Value
-T{
-.BR bcmp ()
-T}     Thread safety   MT-Safe
-.TE
-.hy
-.ad
-.sp 1
+is identical to
+.BR memcmp (3);
+use it instead.
 .SH STANDARDS
 4.3BSD.
-This function is deprecated (marked as LEGACY in POSIX.1-2001): use
-.BR memcmp (3)
-in new programs.
+This function is deprecated (marked as LEGACY in POSIX.1-2001);
 POSIX.1-2008 removes the specification of
 .BR bcmp ().
 .SH SEE ALSO
-.BR bstring (3),
-.BR memcmp (3),
-.BR strcasecmp (3),
-.BR strcmp (3),
-.BR strcoll (3),
-.BR strncasecmp (3),
-.BR strncmp (3)
+.BR memcmp (3)

diff --git a/man3/memcmp.3 b/man3/memcmp.3
index 16d5b4f398f268019b7dc4aab0537c66b4caec77..c2427a00ac129918a87e0104cb5e067aa8861e2a 100644 (file)
--- a/man3/memcmp.3
+++ b/man3/memcmp.3
@@ -75,7 +75,6 @@ Some operating systems provide such a function (e.g., NetBSD's
 but no such function is specified in POSIX.
 On Linux, it may be necessary to implement such a function oneself.
 .SH SEE ALSO
-.BR bcmp (3),
 .BR bstring (3),
 .BR strcasecmp (3),
 .BR strcmp (3),

diff --git a/man3/strcasecmp.3 b/man3/strcasecmp.3
index 1c469d9dea2d1b92c5c806232fd470d1a01cfa03..146ecfcbe9ef056ad1fe81047b6283a99d22b82f 100644 (file)
--- a/man3/strcasecmp.3
+++ b/man3/strcasecmp.3
@@ -104,7 +104,6 @@ to lowercase and then a byte comparison performed.
 Otherwise, the results are unspecified.
 .RE
 .SH SEE ALSO
-.BR bcmp (3),
 .BR memcmp (3),
 .BR strcmp (3),
 .BR strcoll (3),

diff --git a/man3/strcmp.3 b/man3/strcmp.3
index 58507d4bc44e632c07a39053e9a6df09ae20107e..c94da499056350882d6ce3fcf09309560d0cfbc4 100644 (file)
--- a/man3/strcmp.3
+++ b/man3/strcmp.3
@@ -198,7 +198,6 @@ main(int argc, char *argv[])
 .EE
 .\" SRC END
 .SH SEE ALSO
-.BR bcmp (3),
 .BR memcmp (3),
 .BR strcasecmp (3),
 .BR strcoll (3),

diff --git a/man3/strcoll.3 b/man3/strcoll.3
index 20321e0063df76c6442727282d4ed461650df5ef..e43468bb57dd759bfbfdf7274cb854e1fcaab1c0 100644 (file)
--- a/man3/strcoll.3
+++ b/man3/strcoll.3
@@ -79,7 +79,6 @@ locales
 is equivalent to
 .BR strcmp (3).
 .SH SEE ALSO
-.BR bcmp (3),
 .BR memcmp (3),
 .BR setlocale (3),
 .BR strcasecmp (3),

diff --git a/man3/strxfrm.3 b/man3/strxfrm.3
index ebcfca82506242be04b49ae7be8b3d635d21443a..804ffbba9dc764a3149fe2324bed75ba735de9c7 100644 (file)
--- a/man3/strxfrm.3
+++ b/man3/strxfrm.3
@@ -79,7 +79,6 @@ T}    Thread safety   MT-Safe locale
 .SH STANDARDS
 POSIX.1-2001, POSIX.1-2008, C99, SVr4, 4.3BSD.
 .SH SEE ALSO
-.BR bcmp (3),
 .BR memcmp (3),
 .BR setlocale (3),
 .BR strcasecmp (3),