From owner-svn-doc-all@FreeBSD.ORG  Wed Jan 16 17:00:47 2013
Return-Path: <owner-svn-doc-all@FreeBSD.ORG>
Delivered-To: svn-doc-all@freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id 101115D3;
 Wed, 16 Jan 2013 17:00:47 +0000 (UTC)
 (envelope-from wblock@FreeBSD.org)
Received: from svn.freebsd.org (svn.freebsd.org
 [IPv6:2001:1900:2254:2068::e6a:0])
 by mx1.freebsd.org (Postfix) with ESMTP id D32C6AA1;
 Wed, 16 Jan 2013 17:00:46 +0000 (UTC)
Received: from svn.freebsd.org (svn.FreeBSD.org [8.8.178.70])
 by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r0GH0kJO015852;
 Wed, 16 Jan 2013 17:00:46 GMT (envelope-from wblock@svn.freebsd.org)
Received: (from wblock@localhost)
 by svn.freebsd.org (8.14.5/8.14.5/Submit) id r0GH0kCr015842;
 Wed, 16 Jan 2013 17:00:46 GMT (envelope-from wblock@svn.freebsd.org)
Message-Id: <201301161700.r0GH0kCr015842@svn.freebsd.org>
From: Warren Block <wblock@FreeBSD.org>
Date: Wed, 16 Jan 2013 17:00:46 +0000 (UTC)
To: doc-committers@freebsd.org, svn-doc-all@freebsd.org,
 svn-doc-head@freebsd.org
Subject: svn commit: r40658 - head/en_US.ISO8859-1/books/handbook/mirrors
X-SVN-Group: doc-head
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-doc-all@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: "SVN commit messages for the entire doc trees \(except for &quot;
 user&quot; , &quot; projects&quot; , and &quot; translations&quot;
 \)" <svn-doc-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-doc-all>
List-Post: <mailto:svn-doc-all@freebsd.org>
List-Help: <mailto:svn-doc-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/svn-doc-all>,
 <mailto:svn-doc-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 16 Jan 2013 17:00:47 -0000

Author: wblock
Date: Wed Jan 16 17:00:46 2013
New Revision: 40658
URL: http://svnweb.freebsd.org/changeset/doc/40658

Log:
  Add a warning to rename or delete existing directories before an svn
  checkout.  Also fix a missing comma.
  
  Submitted by:	scottro (forums)

Modified:
  head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml	Wed Jan 16 15:32:39 2013	(r40657)
+++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml	Wed Jan 16 17:00:46 2013	(r40658)
@@ -595,9 +595,18 @@
     <sect2 id="svn-usage">
       <title>Running <application>Subversion</application></title>
 
-      <para>The <command>svn</command> command can be used to fetch a
-	clean copy of the sources from a given repository by
-	typing:</para>
+      <para>The <command>svn</command> command is used to fetch a
+	clean copy of the sources into a local directory.</para>
+      <warning>
+	<para>If the local directory already exists but was not
+	  created by <command>svn</command>, rename or delete it
+	  before the checkout.  Checkout over an existing
+	  non-<command>svn</command> directory can cause conflicts
+	  between the existing files and those brought in from the
+	  repository.</para>
+      </warning>
+
+      <para>Check out from a given repository by typing:</para>
 
       <screen>&prompt.root; <userinput>svn checkout <literal>svn://svn.FreeBSD.org/<replaceable>repository</replaceable>/<replaceable>branch</replaceable></literal> <replaceable>root</replaceable></userinput></screen>
 
@@ -606,7 +615,7 @@
       <itemizedlist>
 	<listitem>
 	  <para><replaceable>repository</replaceable> is one of the
-	    Project repositories, i.e.  <literal>base</literal>,
+	    Project repositories, i.e., <literal>base</literal>,
 	    <literal>ports</literal>, or <literal>doc</literal>.</para>
 	</listitem>