From fc76c6a606515c856c7a94a73e2867b5ce0668f1 Mon Sep 17 00:00:00 2001
From: Johann Kois <jkois@FreeBSD.org>
Date: Sun, 29 Aug 2010 13:42:49 +0000
Subject: [PATCH] Do some rewording in the portsnap section to avoid user
 confusion.

Noticed and suggested by:       A. Stein (lordpsycho ett web dott de)
---
 .../books/handbook/cutting-edge/chapter.sgml          | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml b/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
index 6e6679a1d3..f4f4a9fcd7 100644
--- a/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
+++ b/en_US.ISO8859-1/books/handbook/cutting-edge/chapter.sgml
@@ -683,7 +683,8 @@ Fetching 133 new ports or files... done.</screen>
       a <command>fetch</command> operation, the Ports Collection and
       subsequent patches exist on the local system that have passed
       verification.  The first time <command>portsnap</command> is executed,
-      use <literal>extract</literal> to install the updated files:</para>
+      you have to use <literal>extract</literal> to install the
+      downloaded files:</para>
 
     <screen>&prompt.root; <userinput>portsnap extract</userinput>
 /usr/ports/.cvsignore
@@ -699,8 +700,8 @@ Fetching 133 new ports or files... done.</screen>
 /usr/ports/Mk/bsd.cmake.mk
 <replaceable>...</replaceable></screen>
 
-    <para>For subsequent runs of <command>portsnap fetch</command>,
-      <literal>update</literal> should be used instead:</para>
+    <para>To update an already installed Ports Collection use the command
+      <command>portsnap update</command>:</para>
 
     <screen>&prompt.root; <userinput>portsnap update</userinput></screen>
 
@@ -712,6 +713,10 @@ Fetching 133 new ports or files... done.</screen>
       shown in the following example:</para>
 
     <screen>&prompt.root; <userinput>portsnap fetch update</userinput></screen>
+
+    <para>This command will download the latest version of the
+      Ports Collection and update your local version under
+      <filename class="directory">/usr/ports</filename>.</para>
   </sect1>
 
   <sect1 id="updating-upgrading-documentation">