From owner-svn-doc-head@FreeBSD.ORG Wed Apr 16 20:45:16 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 8BA106DD; Wed, 16 Apr 2014 20:45:16 +0000 (UTC) Received: from svn.freebsd.org (svn.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 6A5F81E50; Wed, 16 Apr 2014 20:45:16 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s3GKjGZi029865; Wed, 16 Apr 2014 20:45:16 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s3GKjGDY029864; Wed, 16 Apr 2014 20:45:16 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201404162045.s3GKjGDY029864@svn.freebsd.org> From: Dru Lavigne Date: Wed, 16 Apr 2014 20:45:16 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44589 - 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.17 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: Wed, 16 Apr 2014 20:45:16 -0000 Author: dru Date: Wed Apr 16 20:45:15 2014 New Revision: 44589 URL: http://svnweb.freebsd.org/changeset/doc/44589 Log: Begin editorial review of Subversion chapter. Move mirrors into this chapter and rename rsync chapter to match the rest of the ToC for this section. Add an introductory paragraph on what this chapter covers. More commits to come. Sponsored by: iXsystems 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 Apr 16 20:32:20 2014 (r44588) +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Wed Apr 16 20:45:15 2014 (r44589) @@ -422,35 +422,28 @@ Comment out for now until these can be v Introduction - As of July 2012, &os; uses Subversion - (svn) as the primary version control + As of July 2012, &os; uses + Subversion + as the primary version control system for storing all of &os;'s source code, documentation, and the Ports Collection. - Subversion is generally a developer tool. Most users - should use FreeBSD - Update to update the &os; base system, and Portsnap to + Subversion is generally a developer tool. Most users + should use freebsd-update () to update + the &os; base system, and portsnap ( to update the &os; Ports Collection. - In Subversion, URLs are used to - designate a repository, taking the form of - protocol://hostname/path. Mirrors - may support different protocols as specified below. The first - component of the path is the &os; repository to access. There - are three different repositories, base for - the &os; base system source code, ports for - the Ports Collection, and doc for - documentation. For example, the URL - svn://svn0.us-east.FreeBSD.org/ports/head/ - specifies the main branch of the ports repository on the - svn0.us-east.FreeBSD.org - mirror, using the svn protocol. + This chapter demonstrates how to install + Subversion on a &os; system and then + use it to create a local copy of a &os; repository. It + includes a list of the available &os; + Subversion mirrors and resources to + additional information on how to use + Subversion. @@ -495,6 +488,21 @@ Comment out for now until these can be v repository. + Subversion uses + URLs to designate a repository, taking the form of + protocol://hostname/path. Mirrors + may support different protocols as specified below. The first + component of the path is the &os; repository to access. There + are three different repositories, base for + the &os; base system source code, ports for + the Ports Collection, and doc for + documentation. For example, the URL + svn://svn0.us-east.FreeBSD.org/ports/head/ + specifies the main branch of the ports repository on the + svn0.us-east.FreeBSD.org + mirror, using the svn protocol. + A checkout from a given repository is performed with a command like this: @@ -586,20 +594,7 @@ Comment out for now until these can be v &prompt.root; make update SVN_UPDATE=yes - - For More Information - - For other information about using - Subversion, please see the - Subversion Book, titled - Version - Control with Subversion, or the Subversion - Documentation. - - - - + <application>Subversion</application> Mirror Sites @@ -730,10 +725,23 @@ Certificate information: or other problems, svn is the next choice, with slightly faster transfers. When neither can be used, use http. + + + + For More Information + + For other information about using + Subversion, please see the + Subversion Book, titled + Version + Control with Subversion, or the Subversion + Documentation. + - <application>rsync</application> Sites + Using <application>rsync</application> The following sites make &os; available through the rsync protocol. The rsync utility works in