svn commit: r43775 - head/en_US.ISO8859-1/books/handbook/ports

[Dru Lavigne]

Author: dru
Date: Tue Feb  4 20:54:59 2014
New Revision: 43775
URL: http://svnweb.freebsd.org/changeset/doc/43775

Log:
  Incorporate the missing details from the former updating-upgrading-portsnap into Procedure 5.1.
  
  Sponsored by: iXsystems

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

Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Tue Feb  4 20:45:43 2014	(r43774)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Tue Feb  4 20:54:59 2014	(r43775)
@@ -890,13 +890,16 @@ Deinstalling ca_root_nss-3.15.1_1... don
     <procedure>
       <title>Portsnap Method</title>
 
-      <para><application>Portsnap</application> is a fast and
+      <para>The base system of &os; includes <application>Portsnap</application>. This is a fast and
 	user-friendly tool for retrieving the Ports Collection and
-	is the recommended choice for most users.</para>
+	is the recommended choice for most users.  This utility connects to a
+	&os; site, verifies the secure key, and downloads a new copy of
+	the Ports Collection.  The key is used to verify the integrity
+	of all downloaded files.</para>
 
       <step>
-	<para>Download a compressed snapshot of the Ports Collection
-	  into <filename>/var/db/portsnap</filename>.</para>
+	<para>To download a compressed snapshot of the Ports Collection
+	  into <filename>/var/db/portsnap</filename>:</para>
 
 	<screen>&prompt.root; <userinput>portsnap fetch</userinput></screen>
       </step>
@@ -917,6 +920,12 @@ Deinstalling ca_root_nss-3.15.1_1... don
 
 	<screen>&prompt.root; <userinput>portsnap fetch</userinput>
 &prompt.root; <userinput>portsnap update</userinput></screen>
+      
+	<para>When using <literal>fetch</literal>, the
+	  <literal>extract</literal> or the <literal>update</literal>
+	  operation may be run consecutively, like so:</para>
+
+	<screen>&prompt.root; <userinput>portsnap fetch update</userinput></screen>
       </step>
     </procedure>