From owner-freebsd-doc  Fri Nov  9  8:50:11 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0A75E37B425
	for <freebsd-doc@freebsd.org>; Fri,  9 Nov 2001 08:50:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id fA9Go2v99976;
	Fri, 9 Nov 2001 08:50:02 -0800 (PST)
	(envelope-from gnats)
Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18])
	by hub.freebsd.org (Postfix) with ESMTP id 3098537B41F
	for <FreeBSD-gnats-submit@freebsd.org>; Fri,  9 Nov 2001 08:46:21 -0800 (PST)
Received: (from mwlucas@localhost)
	by blackhelicopters.org (8.9.3/8.9.3) id LAA14647;
	Fri, 9 Nov 2001 11:46:17 -0500 (EST)
	(envelope-from mwlucas)
Message-Id: <200111091646.LAA14647@blackhelicopters.org>
Date: Fri, 9 Nov 2001 11:46:17 -0500 (EST)
From: mwlucas@blackhelicopters.org
Reply-To: mwlucas@blackhelicopters.org
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.2
Subject: docs/31879: port upgrade FAQ
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org


>Number:         31879
>Category:       docs
>Synopsis:       port upgrade FAQ
>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:   Fri Nov 09 08:50:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Michael Lucas
>Release:        FreeBSD 3.5-STABLE i386
>Organization:
None
>Environment:

recent -doc tree

>Description:

This question doesn't mention new tools to handle upgrading ports.
Also, minor simplification of one paragraph.

>How-To-Repeat:


>Fix:


*** en_US.ISO8859-1/books/faq/book.sgml-dist	Thu Nov  8 07:46:11 2001
--- en_US.ISO8859-1/books/faq/book.sgml	Fri Nov  9 11:45:57 2001
***************
*** 5049,5058 ****
          </question>
  
          <answer>
!           <para>Unfortunately, there is no easy way to update installed
!             ports. The &man.pkg.version.1; command can be used
!             to generate a script that will update the installed ports with
!             a newer version in the ports tree:</para>
  
            <screen>&prompt.root; <userinput>pkg_version <option>-c</option> > <replaceable>/tmp/myscript</replaceable></userinput></screen>
  
--- 5049,5062 ----
          </question>
  
          <answer>
!           <para>FreeBSD does not include a port upgrading tool, but it
!             does have some tools to make the upgrade process somewhat
!             easier.  You can also install additional tools to simplify
!             port handling.</para>
! 
!           <para>The &man.pkg.version.1; command can generate a script
!             that will update installed ports to the latest version in
!             the ports tree.</para>
  
            <screen>&prompt.root; <userinput>pkg_version <option>-c</option> > <replaceable>/tmp/myscript</replaceable></userinput></screen>
  
***************
*** 5067,5072 ****
--- 5071,5086 ----
              they need to be updated is that a shared library has changed
              version numbers, so the ports that used that library need to be
              rebuilt to use the new version.</para>
+ 
+           <para>If you have the disk space, you can use the
+             <command>portupgrade</command> tool to automate all of
+             this.  <command>portupgrade</command> includes various
+             tools to simplify package handling.  It is available under
+             <filename>/usr/ports/sysutils/portupgrade</filename>.
+             Since it is written in Ruby,
+             <command>portupgrade</command> is a poor candidate for
+             integration with the main FreeBSD tree.  That shouldn't
+             stop anyone from using it, however.</para>
  
            <para>If your system is up full time, the &man.periodic.8 system
              can be used to generate a weekly list of ports that might need



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

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message