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

[Brad Davis]

Author: brd
Date: Tue May 12 14:41:57 2015
New Revision: 46683
URL: https://svnweb.freebsd.org/changeset/doc/46683

Log:
  Update the pkg clean section to reflect that now expired packages are not kept in the cache.

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 May 12 14:24:05 2015	(r46682)
+++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml	Tue May 12 14:41:57 2015	(r46683)
@@ -893,13 +893,16 @@ Deinstalling ca_root_nss-3.15.1_1... don
 
       <para>By default, <application>pkg</application> stores
 	binary packages in a cache directory defined by
-	<envar>PKG_CACHEDIR</envar> in pkg.conf(5).  When upgrading
-	packages with <command>pkg upgrade</command>, old versions
-	of the upgraded packages are not automatically removed.</para>
-
-      <para>To remove these outdated binary packages, run:</para>
+	<envar>PKG_CACHEDIR</envar> in &man.pkg.conf.5;.  Only copies
+	of the latest installed packages are kept.  Older versions of
+	<application>pkg</application> kept all previous packages.  To
+	remove these outdated binary packages, run:</para>
 
       <screen>&prompt.root; <userinput>pkg clean</userinput></screen>
+
+      <para>The entire cache may be cleared by running:</para>
+
+      <screen>&prompt.root; <userinput>pkg clean -a</userinput></screen>
     </sect2>
 
     <sect2 xml:id="pkgng-set">