From owner-svn-src-head@freebsd.org  Fri Aug 14 01:27:31 2015
Return-Path: <owner-svn-src-head@freebsd.org>
Delivered-To: svn-src-head@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 3DDB799F0C1;
 Fri, 14 Aug 2015 01:27:31 +0000 (UTC)
 (envelope-from araujo@FreeBSD.org)
Received: from repo.freebsd.org (repo.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mx1.freebsd.org (Postfix) with ESMTPS id 2E35C1C4C;
 Fri, 14 Aug 2015 01:27:31 +0000 (UTC)
 (envelope-from araujo@FreeBSD.org)
Received: from repo.freebsd.org ([127.0.1.70])
 by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id t7E1RVoj054569;
 Fri, 14 Aug 2015 01:27:31 GMT (envelope-from araujo@FreeBSD.org)
Received: (from araujo@localhost)
 by repo.freebsd.org (8.15.2/8.15.2/Submit) id t7E1RVet054568;
 Fri, 14 Aug 2015 01:27:31 GMT (envelope-from araujo@FreeBSD.org)
Message-Id: <201508140127.t7E1RVet054568@repo.freebsd.org>
X-Authentication-Warning: repo.freebsd.org: araujo set sender to
 araujo@FreeBSD.org using -f
From: Marcelo Araujo <araujo@FreeBSD.org>
Date: Fri, 14 Aug 2015 01:27:31 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
Subject: svn commit: r286757 - head/lib/libc/string
X-SVN-Group: head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.20
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
 <svn-src-head.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head/>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 14 Aug 2015 01:27:31 -0000

Author: araujo
Date: Fri Aug 14 01:27:30 2015
New Revision: 286757
URL: https://svnweb.freebsd.org/changeset/base/286757

Log:
  Make clear the bcopy(3) manpage regards when it was marked as LEGACY
  as well as when it was removed from POSIX specification.
  
  Reviewed by:		theraven, wblock, bapt, rodrigc
  Approved by:		bapt, rodrigc (mentor)
  Differential Revision:	D3374

Modified:
  head/lib/libc/string/bcopy.3

Modified: head/lib/libc/string/bcopy.3
==============================================================================
--- head/lib/libc/string/bcopy.3	Fri Aug 14 00:19:09 2015	(r286756)
+++ head/lib/libc/string/bcopy.3	Fri Aug 14 01:27:30 2015	(r286757)
@@ -31,7 +31,7 @@
 .\"     @(#)bcopy.3	8.1 (Berkeley) 6/4/93
 .\" $FreeBSD$
 .\"
-.Dd August 13, 2015
+.Dd August 14, 2015
 .Dt BCOPY 3
 .Os
 .Sh NAME
@@ -57,18 +57,6 @@ The two strings may overlap.
 If
 .Fa len
 is zero, no bytes are copied.
-.Pp
-This function is obsolete (marked as LEGACY in
-POSIX.1-2001): please use
-.Xr memmove 3
-in new programs.
-Note that
-.Fn bcopy
-takes its src and dst arguments in the opposite
-order from
-.Xr memmove 3 .
-POSIX.1-2008 removes the specification of
-.Fn bcopy .
 .Sh SEE ALSO
 .Xr memccpy 3 ,
 .Xr memcpy 3 ,
@@ -87,3 +75,25 @@ before it was moved to
 for
 .St -p1003.1-2001
 compliance.
+.Pp
+The
+.St -p1003.1-2008
+removes the specification of
+.Fn bcopy
+and it is marked as LEGACY in
+.St -p1003.1-2004 .
+New programs should use
+.Xr memmove 3 .
+If the input and output buffer do not overlap, then
+.Xr memcpy 3
+is more efficient.
+Note that
+.Fn bcopy
+takes
+.Ar src
+and
+.Ar dst
+in the opposite order from
+.Fn memmove
+and
+.Fn memcpy .