From owner-svn-doc-head@FreeBSD.ORG Thu Jan 17 22:37:36 2013 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 6B522285; Thu, 17 Jan 2013 22:37:36 +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 43F8F988; Thu, 17 Jan 2013 22:37:36 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.5/8.14.5) with ESMTP id r0HMbadl026852; Thu, 17 Jan 2013 22:37:36 GMT (envelope-from wblock@svn.freebsd.org) Received: (from wblock@localhost) by svn.freebsd.org (8.14.5/8.14.5/Submit) id r0HMbaR9026851; Thu, 17 Jan 2013 22:37:36 GMT (envelope-from wblock@svn.freebsd.org) Message-Id: <201301172237.r0HMbaR9026851@svn.freebsd.org> From: Warren Block Date: Thu, 17 Jan 2013 22:37:36 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r40674 - 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-head@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 17 Jan 2013 22:37:36 -0000 Author: wblock Date: Thu Jan 17 22:37:35 2013 New Revision: 40674 URL: http://svnweb.freebsd.org/changeset/doc/40674 Log: Clarify the Using SVN section. Change the example mirror used, modify the checkout example to point to the SVN mirrors section. Modify terms to be more consistent. Reviewed by: simon (earlier version), pgj 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 Thu Jan 17 12:47:38 2013 (r40673) +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Thu Jan 17 22:37:35 2013 (r40674) @@ -596,7 +596,9 @@ Running <application>Subversion</application> The svn command is used to fetch a - clean copy of the sources into a local directory. + clean copy of the sources into a local directory. The files + in this directory are called a local working + copy. If the local directory already exists but was not created by svn, rename or delete it @@ -606,14 +608,21 @@ repository. - Check out from a given repository by typing: + A checkout from a given repository is performed with a + command like this: - &prompt.root; svn checkout svn://svn.FreeBSD.org/repository/branch root + &prompt.root; svn checkout svn-mirror/repository/branch lwcdir where: + svn-mirror is a URL for one + of the Subversion mirror + sites. + + + repository is one of the Project repositories, i.e., base, ports, or doc. @@ -634,7 +643,7 @@ - root is the target directory + lwcdir is the target directory where the contents of the specified branch should be placed. This is usually /usr/ports for @@ -646,21 +655,45 @@ - Note that the initial download of the sources may take a - while. Let it run until it completes. - - Future updates of the downloaded sources may be fetched by - running: - - &prompt.root; svn update root - - After checking out the sources, an alternative way of - updating the documentation is supported by the - Makefile of the root - directory by running: + This example checks out the Ports Collection from the + western US repository using the HTTPS protocol, placing the + local working copy in + /usr/ports. If + /usr/ports is already + present but was not created by svn, + remember to rename or delete it before the checkout. + + &prompt.root; svn checkout https://svn0.us-west.FreeBSD.org/head/ports /usr/ports + + Because the initial checkout has to download the full + branch of the remote repository, it can take a while. Please + be patient. + + After the initial checkout, the local working copy can be + updated by running: + + &prompt.root; svn update lwcdir + + To update + /usr/ports created in + the example above, use: + + &prompt.root; svn update /usr/ports + + The update is much quicker than a checkout, only + transferring files that have changed. + + An alternate way of + updating the local working copy after checkout is provided by the + Makefile in the /usr/ports, + /usr/src, and + /usr/doc directories. + Set SVN_UPDATE and use the + update target. For example, to + update /usr/src: - &prompt.root; cd root + &prompt.root; cd /usr/src &prompt.root; make update SVN_UPDATE=yes