From ringworm01@gmail.com  Tue Nov  8 07:17:39 2005
Return-Path: <ringworm01@gmail.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 8503A16A41F
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  8 Nov 2005 07:17:39 +0000 (GMT)
	(envelope-from ringworm01@gmail.com)
Received: from vms040pub.verizon.net (vms040pub.verizon.net [206.46.252.40])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 0E43843D46
	for <FreeBSD-gnats-submit@freebsd.org>; Tue,  8 Nov 2005 07:17:39 +0000 (GMT)
	(envelope-from ringworm01@gmail.com)
Received: from ringworm.mechee.com ([71.102.14.129])
 by vms040.mailsrvcs.net (Sun Java System Messaging Server 6.2-4.02 (built Sep
 9 2005)) with ESMTPA id <0IPM00IKZK9DICT2@vms040.mailsrvcs.net> for
 FreeBSD-gnats-submit@freebsd.org; Tue, 08 Nov 2005 01:17:38 -0600 (CST)
Received: by ringworm.mechee.com (Postfix, from userid 1001)
	id C4823130C23; Mon, 07 Nov 2005 23:09:01 -0800 (PST)
Message-Id: <20051108070901.C4823130C23@ringworm.mechee.com>
Date: Mon, 07 Nov 2005 23:09:01 -0800 (PST)
From: Michael C. Shultz <ringworm01@gmail.com>
Reply-To: Michael C. Shultz <ringworm01@gmail.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: sysutils/portmanager documentaion for handbook "Using ports"
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         88646
>Category:       docs
>Synopsis:       [patch] sysutils/portmanager documentation for handbook "Using ports"
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    pav
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Nov 08 07:20:15 GMT 2005
>Closed-Date:    Wed Dec 28 14:22:54 GMT 2005
>Last-Modified:  Wed Dec 28 14:22:54 GMT 2005
>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:

From: "Michael C. Shultz" <ringworm01@gmail.com>
To: bug-followup@freebsd.org,
 ringworm01@gmail.com
Cc:  
Subject: Re: docs/88646: sysutils/portmanager documentaion for handbook "Using ports"
Date: Wed, 9 Nov 2005 07:10:10 -0800

 Here are links to the html page and full sgml source:
 
 http://portmanager.sunsite.dk/distfiles/ports-using.html
 
 http://portmanager.sunsite.dk/distfiles/chapter.sgml-portmanager
 
 -Mike
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: remko 
Responsible-Changed-When: Tue Dec 6 16:38:35 GMT 2005 
Responsible-Changed-Why:  
According to philip@ i can solve this ;-) lets do so. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88646 
Responsible-Changed-From-To: remko->freebsd-doc 
Responsible-Changed-By: remko 
Responsible-Changed-When: Fri Dec 23 19:49:34 UTC 2005 
Responsible-Changed-Why:  
I do not want to work on this PR any longer. 
If someone else wants to work on this, please contact 
me, i will deliver my rewritten diff since the current 
one is not per FDP and need a little tuning. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88646 

From: "Michael C. Shultz" <ringworm01@gmail.com>
To: bug-followup@freebsd.org,
 ringworm01@gmail.com
Cc:  
Subject: Re: docs/88646: sysutils/portmanager documentaion for handbook "Using ports"
Date: Fri, 23 Dec 2005 12:06:55 -0800

 It would have been nice if remko had attached his rewritten diff or at least 
 let me know where the information is on how to correct this.  No matter I'll 
 do my best to find the proper way and add a corrected diff to this PR asap.
 
 -Mike
 

From: "Michael C. Shultz" <ringworm01@gmail.com>
To: bug-followup@freebsd.org,
 ringworm01@gmail.com,
 Marc Fonvieille <blackend@freebsd.org>,
 Remko Lodder <remko@elvandar.org>,
 doceng@freebsd.org
Cc:  
Subject: Re: docs/88646: sysutils/portmanager documentaion for handbook "Using ports"
Date: Fri, 23 Dec 2005 17:20:00 -0800

 I just checked this diff with 
 
 a) make lint
 b) make FORMATS="html html-split txt ps pdf rtf"
 
 In accordance with
  
 http://www.freebsd.org/doc/en_US.ISO8859-1/books/fdp-primer/overview-quick-start.html
 
 And it shows no lint problems and also builds the
 various outputs with no problem.  I've posted
 the pdf and ps outputs as proof here:
 
 http://portmanager.sunsite.dk/distfiles/book.pdf.gz
 diff is at page 152-153
 
 http://portmanager.sunsite.dk/distfiles/book.ps.gz
 diff is at page 133-134
 
 I have no idea why Mr. Remko Lodder thinks it is not IAW FDP
 and would surely appreciate he explain what the problem is or
 where his version of FDP is located so I may enlighten myself.
 
 
 
 
Responsible-Changed-From-To: freebsd-doc->pav 
Responsible-Changed-By: pav 
Responsible-Changed-When: Wed Dec 28 13:41:33 UTC 2005 
Responsible-Changed-Why:  
Working on this 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88646 
State-Changed-From-To: open->closed 
State-Changed-By: pav 
State-Changed-When: Wed Dec 28 14:22:44 UTC 2005 
State-Changed-Why:  
Modified patch committed. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=88646 
>Unformatted:
