From b5e167d902c5502a6a24f125b896d792cfdb935a Mon Sep 17 00:00:00 2001
From: Brad Davis <brd@FreeBSD.org>
Date: Tue, 12 May 2015 15:07:26 +0000
Subject: [PATCH] Simplify the section on upgrading with pkg.

---
 .../books/handbook/ports/chapter.xml          | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/en_US.ISO8859-1/books/handbook/ports/chapter.xml b/en_US.ISO8859-1/books/handbook/ports/chapter.xml
index af04cbcf52..b795ff628e 100644
--- a/en_US.ISO8859-1/books/handbook/ports/chapter.xml
+++ b/en_US.ISO8859-1/books/handbook/ports/chapter.xml
@@ -807,19 +807,14 @@ Proceed with deleting packages [y/N]: <userinput>y</userinput>
     <sect2 xml:id="pkgng-upgrading">
       <title>Upgrading Installed Packages</title>
 
-      <para>Packages that are outdated can be found with
-	<command>pkg version</command>.  If a local ports tree
-	does not exist, pkg-version(8) will use the remote
-	repository catalogue.  Otherwise, the local ports tree will
-	be used to identify package versions.</para>
-
       <para>Installed packages can be upgraded to their latest
-	versions by typing <command>pkg upgrade</command>.  This
-	command will compare the installed versions with those
-	available in the repository catalogue.  When finished, it
-	will list the applications that have newer versions.  Type
-	<userinput>y</userinput> to proceed with the upgrade or
-	<userinput>n</userinput> to cancel the upgrade.</para>
+	versions by running:</para>
+
+      <screen>&prompt.root; <userinput>pkg upgrade</userinput></screen>
+
+      <para>This command will compare the installed versions with those
+	available in the repository catalogue and upgrade them from the
+	repository.</para>
     </sect2>
 
     <sect2 xml:id="pkgng-auditing">