Add some new text regarding portupgrade to the "upgrading ports"

FAQ, and tweak existing text slightly.

This change comes from the PR with one markup modification and one
rewording.

PR:		31879
Submitted by:	mwlucas@blackhelicopters.org
This commit is contained in:
Bruce A. Mah 2001-11-10 02:10:57 +00:00
parent 7bf53aa2c1
commit f241b59ab4
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=11171

View file

@ -5049,10 +5049,14 @@ crw-rw-rw- 1 root wheel 41, 1 Oct 15 22:14 spx</screen>
</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>
<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>
@ -5068,6 +5072,16 @@ crw-rw-rw- 1 root wheel 41, 1 Oct 15 22:14 spx</screen>
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
<port>sysutils/portupgrade</port>.
Since it is written in Ruby,
<command>portupgrade</command> is an unlikely 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
updating by setting