From owner-freebsd-doc@FreeBSD.ORG  Sat Sep 23 21:20:29 2006
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@hub.freebsd.org
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B566416A407
	for <freebsd-doc@hub.freebsd.org>; Sat, 23 Sep 2006 21:20:29 +0000 (UTC)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 564D543D77
	for <freebsd-doc@hub.freebsd.org>; Sat, 23 Sep 2006 21:20:29 +0000 (GMT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k8NLKSCZ065582
	for <freebsd-doc@freefall.freebsd.org>; Sat, 23 Sep 2006 21:20:28 GMT
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k8NLKSGk065581;
	Sat, 23 Sep 2006 21:20:28 GMT (envelope-from gnats)
Date: Sat, 23 Sep 2006 21:20:28 GMT
Message-Id: <200609232120.k8NLKSGk065581@freefall.freebsd.org>
To: freebsd-doc@FreeBSD.org
From: Pav Lucistnik <pav@FreeBSD.org>
Cc: 
Subject: Re: docs/103519: [patch] minor suggestions to changes in handbook
	ports section
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
Reply-To: Pav Lucistnik <pav@FreeBSD.org>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 23 Sep 2006 21:20:29 -0000

The following reply was made to PR docs/103519; it has been noted by GNATS.

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.