From jwl@io.dk  Sat Sep 23 14:34:41 2006
Return-Path: <jwl@io.dk>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 7037716A417
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 23 Sep 2006 14:34:41 +0000 (UTC)
	(envelope-from jwl@io.dk)
Received: from voroth.sysctl.dk (0x5551206f.adsl.cybercity.dk [85.81.32.111])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0559B43D5A
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 23 Sep 2006 14:34:40 +0000 (GMT)
	(envelope-from jwl@io.dk)
Received: from apnex.sysctl.dk (apnex.sysctl.dk [10.0.0.3])
	by voroth.sysctl.dk (Postfix) with ESMTP id 6CAC55A94B
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 23 Sep 2006 16:34:39 +0200 (CEST)
Message-Id: <1159022069.25741@apnex.sysctl.dk>
Date: Sat, 23 Sep 2006 16:34:29 +0200
From: Jeppe Larsen <jwl@io.dk>
Reply-To: Jeppe Larsen <jwl@io.dk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] minor suggestions to changes in handbook ports section
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         103519
>Category:       docs
>Synopsis:       [patch] minor suggestions to changes in handbook ports section
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    trhodes
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Sat Sep 23 14:40:22 GMT 2006
>Closed-Date:    Mon Oct 09 18:38:47 GMT 2006
>Last-Modified:  Mon Oct  9 18:40:19 GMT 2006
>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:

From: Pav Lucistnik <pav@FreeBSD.org>
To: Jeppe Larsen <jwl@io.dk>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/103519: [patch] minor suggestions to changes in handbook
	ports section
Date: Sat, 23 Sep 2006 23:20:03 +0200

 > @@ -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">
 
 I disagree with this change. There is absolutely no need for
 portinstall, ever. It just changes to the respective directory and do
 make install.
 
 User can do this himself, absolutely.
 
 >        <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>
 
 Any particular need to duplicate portupgrade manpages here?
  
 >        <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>
 
 Please don't, the double space after full stop is a proper English.
 
 -- 
 Pav Lucistnik <pav@oook.cz>
               <pav@FreeBSD.org>
 
 An arrow (+0,+0) {@f0} finds a mark. It dies.
State-Changed-From-To: open->closed 
State-Changed-By: trhodes 
State-Changed-When: Mon Oct 9 18:36:54 UTC 2006 
State-Changed-Why:  
Manually merged the only part (portsclean -DD) which both 
made sense and was not argued.  Pav is right about the other 
parts and as such, they have not been merged.  Thanks for the 
submission! 


Responsible-Changed-From-To: freebsd-doc->trhodes 
Responsible-Changed-By: trhodes 
Responsible-Changed-When: Mon Oct 9 18:36:54 UTC 2006 
Responsible-Changed-Why:  
Over to me, closed_count++ 

http://www.freebsd.org/cgi/query-pr.cgi?pr=103519 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/103519: commit references a PR
Date: Mon,  9 Oct 2006 18:36:41 +0000 (UTC)

 trhodes     2006-10-09 18:36:34 UTC
 
   FreeBSD doc repository
 
   Modified files:
     en_US.ISO8859-1/books/handbook/ports chapter.sgml 
   Log:
   Add information on portsclean -DD.
   
   PR:             103519
   Glanced at by:  pav
   
   Revision  Changes    Path
   1.260     +5 -0      doc/en_US.ISO8859-1/books/handbook/ports/chapter.sgml
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
>Unformatted:
