docs/103519: [patch] minor suggestions to changes in handbook ports section

[Jeppe Larsen]

>Number:         103519
>Category:       docs
>Synopsis:       [patch] minor suggestions to changes in handbook ports section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Sep 23 14:40:22 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Jeppe Larsen
>Release:        FreeBSD 6.2-PRERELEASE i386
>Organization:
>Environment:
	
>Description:
	
>How-To-Repeat:
	
>Fix:

	

--- chapter.diff begins here ---
--- chapter.sgml.old	Sat Sep 23 15:41:05 2006
+++ chapter.sgml	Sat Sep 23 15:46:06 2006
@@ -1124,7 +1124,7 @@
       <para>First, list outdated ports that have a newer version available in
 	the Ports Collection with the &man.pkg.version.1; command:</para>
 
-      <screen>&prompt.root; <userinput>pkg_version -v</userinput></screen>
+      <screen>&prompt.root; <userinput>pkg_version -l "<"</userinput></screen>
 
       <sect3 id="ports-file-updating">
 	<title><filename>/usr/ports/UPDATING</filename></title>
@@ -1192,8 +1192,15 @@
 
       <para>To just fetch distfiles (or packages, if
 	<option>-P</option> is specified) without building or
-	installing anything, use <option>-F</option>.
-	For further information see &man.portupgrade.1;.</para>
+	installing anything, use <option>-F</option>.</para>
+
+      <para>The <application>portupgrade</application> suite also comes with 
+	<command>portinstall</command> that automates the previously explained
+	approach, so a port and all its dependcies will be compiled and installed
+	with:</para>
+	<screen>&prompt.root; <userinput>portinstall lsof</userinput></screen>
+
+	<para>For further information see &man.portupgrade.1;.</para>
       </sect3>
 
       <sect3 id="portmanager">
@@ -1260,6 +1267,9 @@
 	ports:</para>
 
       <screen>&prompt.root; <userinput>portsclean -D</userinput></screen>
+      <para>Or if you want to remove all distfiles not referenced by any port
+      currently installed on your system:</para>
+      <screen>&prompt.root; <userinput>portsclean -DD</userinput></screen>
 
       <note>
 	<para>The <command>portsclean</command> utility is part of the
@@ -1267,7 +1277,7 @@
       </note>
 
       <para>Do not forget to remove the installed ports once you no longer need
-	them.  A nice tool to help automate this task is available from the
+	them. A nice tool to help automate this task is available from the
 	<filename role="package">sysutils/pkg_cutleaves</filename> port.</para>
     </sect2>
 
--- chapter.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: