docs/88646: sysutils/portmanager documentaion for handbook "Using ports"

[Michael C. Shultz]

>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 at 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: