path: root/en_US.ISO8859-1/books/handbook/mirrors
diff options
authorPeter Wemm <peter@FreeBSD.org>2015-08-06 21:18:32 +0000
committerPeter Wemm <peter@FreeBSD.org>2015-08-06 21:18:32 +0000
commit7a5c6d7474daae8f15e754ffceb01a9768263f0c (patch)
tree03e86d2444a1da8a9090da8aa968c00f1f642a6c /en_US.ISO8859-1/books/handbook/mirrors
parentdb36ce3286bdb54c69e7a592163d0dbdba5bd121 (diff)
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
Notes: svn path=/head/; revision=47170
Diffstat (limited to 'en_US.ISO8859-1/books/handbook/mirrors')
1 files changed, 38 insertions, 13 deletions
diff --git a/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml b/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
index 1502219f1c..0db30058ab 100644
--- a/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/mirrors/chapter.xml
@@ -436,13 +436,13 @@ Comment out for now until these can be verified.
<para>As of July 2012, &os; uses
- <application>Subversion</application> as the primary version
+ <application>Subversion</application> as the only version
control system for storing all of &os;'s source code,
documentation, and the Ports Collection.</para>
<para><application>Subversion</application> is generally a
- developer tool. Most users should use
+ developer tool. Users may prefer to use
<command>freebsd-update</command> (<xref
linkend="updating-upgrading-freebsdupdate"/>) to update
the &os; base system, and <command>portsnap</command> (<xref
@@ -453,29 +453,54 @@ Comment out for now until these can be verified.
<para>This chapter demonstrates how to install
<application>Subversion</application> 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;
- <application>Subversion</application> mirrors and resources to
- additional information on how to use
+ includes additional information on how to use
+ <sect2 xml:id="svn-svnlite">
+ <title>Svnlite</title>
+ <para>A fully functional but light weight version of
+ <application>Subversion</application> may be already installed
+ on your &os; system as <command>svnlite</command>. You do not
+ have to install a separate copy if <command>svnlite</command>
+ is sufficient for your needs.</para>
+ <para>If you wish to access <acronym>HTTPS</acronym> servers with
+ <command>svnlite</command> then a root certificate bundle
+ should be installed:</para>
+ <screen>&prompt.root; <userinput>pkg install ca_root_nss</userinput></screen>
+ <para>Installing a certificate bundle allows
+ <command>svnlite</command> to verify that it is securely
+ communicating with the repository server without tampering.</para>
+ <para>If you are using <command>svnlite</command> then you should
+ adjust the examples below.</para>
+ </sect2>
<sect2 xml:id="svn-install">
- <para><application>Subversion</application> 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,
+ <para>If the <command>svnlite</command> is unavailable or you wish to
+ use the full version of <application>Subversion</application> then
+ it must be installed.</para>
+ <para>If a copy of the ports tree is already present,
one can install <application>Subversion</application> like
<screen>&prompt.root; <userinput>cd /usr/ports/devel/subversion</userinput>
+&prompt.root; <userinput>make install clean</userinput>
+&prompt.root; <userinput>cd /usr/ports/security/ca_root_nss</userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
- <para>If the ports tree is not available,
- <application>Subversion</application> can be installed as a
- package:</para>
+ <para><application>Subversion</application> can easily be
+ installed as a package:</para>
- <screen>&prompt.root; <userinput>pkg install devel/subversion</userinput></screen>
+ <screen>&prompt.root; <userinput>pkg install subversion</userinput>
+&prompt.root; <userinput>pkg install ca_root_nss</userinput></screen>
<sect2 xml:id="svn-usage">
@@ -561,7 +586,7 @@ Comment out for now until these can be verified.
<para>This example checks out the Ports Collection from the
- western US repository using the <acronym>HTTPS</acronym>
+ &os; repository using the <acronym>HTTPS</acronym>
protocol, placing the local working copy in
<filename>/usr/ports</filename>. If
<filename>/usr/ports</filename> is already