From owner-svn-doc-all@freebsd.org Thu Aug 6 21:18:33 2015 Return-Path: Delivered-To: svn-doc-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 7EA9A9B567E; Thu, 6 Aug 2015 21:18:33 +0000 (UTC) (envelope-from peter@FreeBSD.org) Received: from repo.freebsd.org (repo.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 62B99130; Thu, 6 Aug 2015 21:18:33 +0000 (UTC) (envelope-from peter@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.70]) by repo.freebsd.org (8.14.9/8.14.9) with ESMTP id t76LIXds035176; Thu, 6 Aug 2015 21:18:33 GMT (envelope-from peter@FreeBSD.org) Received: (from peter@localhost) by repo.freebsd.org (8.14.9/8.14.9/Submit) id t76LIXj1035175; Thu, 6 Aug 2015 21:18:33 GMT (envelope-from peter@FreeBSD.org) Message-Id: <201508062118.t76LIXj1035175@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: peter set sender to peter@FreeBSD.org using -f From: Peter Wemm Date: Thu, 6 Aug 2015 21:18:33 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47170 - 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.20 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 06 Aug 2015 21:18:33 -0000 Author: peter (src committer) Date: Thu Aug 6 21:18:32 2015 New Revision: 47170 URL: https://svnweb.freebsd.org/changeset/doc/47170 Log: Mention that svnlite may be present and usable. Adjust some wording to try to not scare people away from using svn. Mention the importance of ca_root_nss and add it to the examples. Use short package names in examples. Untangle some leftovers from having a mirror list. Build tested by: gjb 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 Aug 6 20:55:47 2015 (r47169) +++ head/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml Thu Aug 6 21:18:32 2015 (r47170) @@ -436,13 +436,13 @@ Comment out for now until these can be v Introduction As of July 2012, &os; uses - Subversion as the primary version + Subversion as the only 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 + developer tool. Users may prefer to use freebsd-update () to update the &os; base system, and portsnap (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 + includes additional information on how to use Subversion. + + Svnlite + + A fully functional but light weight version of + Subversion may be already installed + on your &os; system as svnlite. You do not + have to install a separate copy if svnlite + is sufficient for your needs. + + If you wish to access HTTPS servers with + svnlite then a root certificate bundle + should be installed: + + &prompt.root; pkg install ca_root_nss + + Installing a certificate bundle allows + svnlite to verify that it is securely + communicating with the repository server without tampering. + + If you are using svnlite then you should + adjust the examples below. + + Installation - Subversion must be installed - before it can be used to check out the contents of any of the - repositories. If a copy of the ports tree is already present, + If the svnlite is unavailable or you wish to + use the full version of Subversion then + it must be installed. + + If a copy of the ports tree is already present, one can install Subversion like this: &prompt.root; cd /usr/ports/devel/subversion +&prompt.root; make install clean +&prompt.root; cd /usr/ports/security/ca_root_nss &prompt.root; make install clean - If the ports tree is not available, - Subversion can be installed as a - package: + Subversion can easily be + installed as a package: - &prompt.root; pkg install devel/subversion + &prompt.root; pkg install subversion +&prompt.root; pkg install ca_root_nss @@ -561,7 +586,7 @@ Comment out for now until these can be v This example checks out the Ports Collection from the - western US repository using the HTTPS + &os; repository using the HTTPS protocol, placing the local working copy in /usr/ports. If /usr/ports is already