[src/trunk]: src/bin/cp From patch by Bug Hunting:

[wiz <wiz%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/692f34672923
branches:  trunk
changeset: 778431:692f34672923
user:      wiz <wiz%NetBSD.org@localhost>
date:      Sun Mar 25 22:37:08 2012 +0000

description:
>From patch by Bug Hunting:
- bump the manpage's date (because of the next change);
- note that cp(1) does not preserve hard links (even with `-R'),
  and refer to pax(1) there as well as in the `SEE ALSO' section
  for such functionality (this change is based upon a similar note
  in FreeBSD's version of the manpage);
- change a wording, for more overall consistency.

diffstat:

 bin/cp/cp.1 |  14 +++++++++++---
 1 files changed, 11 insertions(+), 3 deletions(-)

diffs (43 lines):

diff -r 96b8569dd8ba -r 692f34672923 bin/cp/cp.1
--- a/bin/cp/cp.1       Sun Mar 25 19:53:41 2012 +0000
+++ b/bin/cp/cp.1       Sun Mar 25 22:37:08 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: cp.1,v 1.41 2011/08/03 15:44:15 dholland Exp $
+.\"    $NetBSD: cp.1,v 1.42 2012/03/25 22:37:08 wiz Exp $
 .\"
 .\" Copyright (c) 1989, 1990, 1993, 1994
 .\"    The Regents of the University of California.  All rights reserved.
@@ -32,7 +32,7 @@
 .\"
 .\"    @(#)cp.1        8.3 (Berkeley) 4/18/94
 .\"
-.Dd August 3, 2011
+.Dd March 25, 2012
 .Dt CP 1
 .Os
 .Sh NAME
@@ -151,8 +151,15 @@
 to create special files rather than copying them as normal files.
 Created directories have the same mode as the corresponding source
 directory, unmodified by the process's umask.
+.Pp
+Note that
+.Nm
+copies hard linked files as separate files.
+If you need to preserve hard links, consider using a utility like
+.Xr pax 1
+instead.
 .It Fl v
-Cause
+Causes
 .Nm
 to be verbose, showing files as they are copied.
 .El
@@ -219,6 +226,7 @@
 or fifo's.
 .Sh SEE ALSO
 .Xr mv 1 ,
+.Xr pax 1 ,
 .Xr rcp 1 ,
 .Xr umask 2 ,
 .Xr fts 3 ,