- Add a section on how to upgrade ports with Portmanager alongside section

on Portupgrade

PR:		docs/88646 (based on)
Submitted by:	Michael C. Shultz <ringworm01@gmail.com>
This commit is contained in:
Pav Lucistnik 2005-12-28 14:22:40 +00:00
parent 6f016f1dfe
commit af427bc287
Notes: svn2git 2020-12-08 03:00:23 +00:00
svn path=/head/; revision=26715

View file

@ -1103,9 +1103,6 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
<sect2 id="ports-upgrading">
<title>Upgrading Ports</title>
<indexterm>
<primary>portupgrade</primary>
</indexterm>
<indexterm>
<primary>ports</primary>
<secondary>upgrading</secondary>
@ -1123,6 +1120,13 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
encounter and need to perform when updating a port.</para>
</note>
<sect3 id="portupgrade">
<title>Upgrading Ports using Portupgrade</title>
<indexterm>
<primary>portupgrade</primary>
</indexterm>
<para>The <application>portupgrade</application> utility is designed
to easily upgrade installed ports. It is available from the <filename
role="package">sysutils/portupgrade</filename> port. Install it like
@ -1168,6 +1172,47 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
<option>-P</option> is specified) without building or
installing anything, use <option>-F</option>.
For further information see &man.portupgrade.1;.</para>
</sect3>
<sect3 id="portmanager">
<title>Upgrading Ports using Portmanager</title>
<indexterm>
<primary>portmanager</primary>
</indexterm>
<para><application>Portmanager</application> is another utility for
easy upgrading of installed ports. It is available from the
<filename role="package">sysutils/portmanager</filename> port:</para>
<screen>&prompt.root; <userinput>cd <filename role="directory">/usr/ports/sysutils/portmanager</filename></userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para>All the installed ports can be upgraded using this simple
command:</para>
<screen>&prompt.root; <userinput>portmanager -u</userinput></screen>
<para>You can add the <option>-ui</option> flag to get asked for
confirmation of every step <application>Portmanager</application>
will perform. <application>Portmanager</application> can also be
used to install new ports on the system. Unlike the usual
<command>make install clean</command> command, it will upgrade all
the dependencies prior to building and installing the
selected port.</para>
<screen>&prompt.root; <userinput>portmanager <replaceable>x11/gnome2</replaceable></userinput></screen>
<para>If there are any problems regarding the dependencies for the
selected port, you can use <application>Portmanager</application> to
rebuild all of them in the correct order. Once finished, the
problematic port will be rebuilt too.</para>
<screen>&prompt.root; <userinput>portmanager <replaceable>graphics/gimp</replaceable> -f</userinput></screen>
<para>For more information see
<application>Portmanager</application>'s manual page.</para>
</sect3>
</sect2>
<sect2 id="ports-disk-space">