Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 17 Oct 2017 17:43:45 +0000 (UTC)
From:      =?UTF-8?Q?Romain_Tarti=c3=a8re?= <romain@FreeBSD.org>
To:        doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org
Subject:   svn commit: r51127 - head/en_US.ISO8859-1/articles/committers-guide
Message-ID:  <201710171743.v9HHhj0Q057642@repo.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: romain (ports committer)
Date: Tue Oct 17 17:43:45 2017
New Revision: 51127
URL: https://svnweb.freebsd.org/changeset/doc/51127

Log:
  The documentation incorrectly states that
  
  % svn copy foo.c bar.c
  
  and
  
  % cp foo.c bar.c
  % svn add bar.c
  
  are equivalent. However, the first one keeps foo.c history and the second gets
  rid of it.
  
  Fix this and explain the difference.
  
  Reviewed by:	brd, allanjude
  Approved by:	allanjude
  Differential Revision:	https://reviews.freebsd.org/D12678

Modified:
  head/en_US.ISO8859-1/articles/committers-guide/article.xml

Modified: head/en_US.ISO8859-1/articles/committers-guide/article.xml
==============================================================================
--- head/en_US.ISO8859-1/articles/committers-guide/article.xml	Sun Oct 15 18:24:58 2017	(r51126)
+++ head/en_US.ISO8859-1/articles/committers-guide/article.xml	Tue Oct 17 17:43:45 2017	(r51127)
@@ -960,14 +960,15 @@ You need a Passphrase to protect your secret key.</scr
 
 	<para>This command creates a copy of
 	  <filename>foo.c</filename> named <filename>bar.c</filename>,
-	  with the new file also under version control:</para>
+	  with the new file also under version control and with the full
+	  history of <filename>foo.c</filename>:</para>
 
 	<screen>&prompt.user; <userinput>svn copy <replaceable>foo.c</replaceable> <replaceable>bar.c</replaceable></userinput></screen>
 
-	<para>The example above is equivalent to:</para>
-
-	<screen>&prompt.user; <userinput>cp foo.c bar.c</userinput>
-&prompt.user; <userinput>svn add bar.c</userinput></screen>
+	<para>This is usually preferred to copying the file with
+	  <command>cp</command> and adding it to the repository with
+	  <command>svn add</command> because this way the new file does not
+	  inherit the original one's history.</para>
 
 	<para>To move and rename a file:</para>
 



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201710171743.v9HHhj0Q057642>