Date: Mon, 07 Nov 2005 23:09:01 -0800 (PST) From: "Michael C. Shultz" <ringworm01@gmail.com> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/88646: sysutils/portmanager documentaion for handbook "Using ports" Message-ID: <20051108070901.C4823130C23@ringworm.mechee.com> Resent-Message-ID: <200511080720.jA87KF5s036047@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 88646 >Category: docs >Synopsis: sysutils/portmanager documentaion for handbook "Using ports" >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: Tue Nov 08 07:20:15 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Michael C. Shultz >Release: FreeBSD 5.4-STABLE i386 >Organization: >Environment: System: FreeBSD ringworm.mechee.com 5.4-STABLE FreeBSD 5.4-STABLE #0: Fri Nov 4 06:35:37 PST 2005 root@ringworm.mechee.com:/usr5/obj/usr5/src/sys/RINGWORM5 i386 >Description: sysutils/portmanager documentaion for handbook 4.5 Using the Ports Collection This documentation is submitted as an alternative way of keeping ports up to date with sysutils/portmanager >How-To-Repeat: N/A >Fix: --- chapter.sgml-portmanager.diff begins here --- --- ports/chapter.sgml Mon Oct 3 11:58:36 2005 +++ ports/chapter.sgml-portmanager Mon Nov 7 22:22:04 2005 @@ -1160,9 +1160,6 @@ <title>Upgrading Ports</title> <indexterm> - <primary>portupgrade</primary> - </indexterm> - <indexterm> <primary>ports</primary> <secondary>upgrading</secondary> </indexterm> @@ -1174,6 +1171,13 @@ encounter and need to perform when updating a port.</para> </note> + <sect3 id="portupgrade"> + <title>portupgrade</title> + <indexterm> + <primary>portupgrade</primary> + </indexterm> + + <para>Keeping your ports up to date can be a tedious job. For instance, to upgrade a port you would go to the ports directory, build the port, deinstall the old port, install the @@ -1233,6 +1237,32 @@ <para>Other utilities exist which will do this, check out the <filename>ports/sysutils</filename> directory and see what you come up with.</para> + </sect3> + <sect3 id="portmanager"> + <title>portmanager</title> + <indexterm><primary>portmanager</primary></indexterm> + <indexterm><primary>ports</primary><secondary>upgrading</secondary></indexterm> + <para>After updating your ports tree installed ports may easily be + brought up to date with <filename + role="package">sysutils/portmanager</filename>. + Installation and setup from the standard ports tree location is simple:</para> + <screen>&prompt.root; <userinput>cd /usr/ports/sysutils/portmanager</userinput></screen> + <screen>&prompt.root; <userinput>make install clean</userinput></screen> + <para>Once installed the only command needed to update all installed ports is:</para> + <screen>&prompt.root; <userinput>portmanager -u</userinput></screen> + <para>Portmanager can also add new ports to your installed software + collection, when used to install ports it will correctly update + or add any dependencies prior to building and installing the new + port. example:</para> + <screen>&prompt.root; <userinput>portmanager x11/gnome2</userinput></screen> + <para>will first insure all dependencies of x11/gnome2 are installed and up to date, + then x11/gnome2 will be installed.</para> + <para>Fixing a problem port when it is dependency related is easy, example:</para> + <screen>&prompt.root; <userinput>portmanager sysutils/problemPort -f</userinput></screen> + <para>all of sysutils/problemPort's dependencies will be rebuilt in a logical order + then rebuilding of sysutils/problemPort is attempted.</para> + <para>For further information see man portmanager(1)</para> + </sect3> </sect2> </sect1> --- chapter.sgml-portmanager.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20051108070901.C4823130C23>