Return-Path: 
 <svn-return-5854-apmail-forrest-svn-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-svn-archive@www.apache.org
Received: (qmail 89237 invoked from network); 12 Jul 2006 03:20:00 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 12 Jul 2006 03:20:00 -0000
Received: (qmail 69176 invoked by uid 500); 12 Jul 2006 03:20:00 -0000
Delivered-To: apmail-forrest-svn-archive@forrest.apache.org
Received: (qmail 69140 invoked by uid 500); 12 Jul 2006 03:20:00 -0000
Mailing-List: contact svn-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:svn-help@forrest.apache.org>
list-unsubscribe: <mailto:svn-unsubscribe@forrest.apache.org>
List-Post: <mailto:svn@forrest.apache.org>
Reply-To: "Forrest Developers List" <dev@forrest.apache.org>
List-Id: <svn.forrest.apache.org>
Delivered-To: mailing list svn@forrest.apache.org
Received: (qmail 69120 invoked by uid 99); 12 Jul 2006 03:20:00 -0000
Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 11 Jul 2006 20:20:00 -0700
X-ASF-Spam-Status: No, hits=-9.4 required=10.0
	tests=ALL_TRUSTED,NO_REAL_NAME
X-Spam-Check-By: apache.org
Received-SPF: pass (asf.osuosl.org: local policy)
Received: from [140.211.166.113] (HELO eris.apache.org) (140.211.166.113)
    by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 11 Jul 2006 20:19:59 -0700
Received: by eris.apache.org (Postfix, from userid 65534)
	id 6F24A1A981A; Tue, 11 Jul 2006 20:19:39 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r421099 -
 /forrest/trunk/site-author/content/xdocs/howto-dev.xml
Date: Wed, 12 Jul 2006 03:19:39 -0000
To: svn@forrest.apache.org
From: twilliams@apache.org
X-Mailer: svnmailer-1.0.8
Message-Id: <20060712031939.6F24A1A981A@eris.apache.org>
X-Virus-Checked: Checked by ClamAV on apache.org
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

Author: twilliams
Date: Tue Jul 11 20:19:38 2006
New Revision: 421099

URL: http://svn.apache.org/viewvc?rev=421099&view=rev
Log:
Add some rough profiling notes. 

Modified:
    forrest/trunk/site-author/content/xdocs/howto-dev.xml

Modified: forrest/trunk/site-author/content/xdocs/howto-dev.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/howto-dev.xml?rev=421099&r1=421098&r2=421099&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/howto-dev.xml (original)
+++ forrest/trunk/site-author/content/xdocs/howto-dev.xml Tue Jul 11 20:19:38 2006
@@ -560,6 +560,46 @@
           </li>
         </ul>
       </section>
+
+      <note>
+        The next two sections describe the configuration of profiling tools but they are not
+        integrated with the IDE.  If you can figure out how to properly configure the for 
+        integrated operation with the IDE, please provide a documentation patch.
+      </note>
+      
+      <section id="profile-yourkit">
+        <title>Profiling Forrest with YourKit</title>
+        <p>
+          Assuming you have the YourKit software installed you simply need to do two things to
+          profile a particular Forrest Project. First, you need to add *YourKit Home*\bin\win32 to
+          your PATH environment variable - where *YourKit Home* is the installation directory of that 
+          software.  Next you need to add the following to your forrest.properties file for the project.
+        </p>
+        <source>forrest.jvmargs=-agentlib:yjpagent</source>
+        <p>
+          You are now all set, simply type 'forrest run', then open up YourKit and select "Connect 
+          to locally running profiled application...".   If you don't see the types of objects that you
+          expected, check the current filters - YourKit seems to filter out org.apache.* namespaces by
+          default.
+        </p>
+      </section>
+      <section id="profile-netbeans">
+        <title>Profiling Forrest with Netbeans</title>
+        <p>
+          Assuming you have the Netbeans IDE installed you simply need to do a couple things to 
+          profile a particular Forrest Project.  First, you need to add 
+          *Netbeans Home*\profiler1\lib\deployed\jdk142\windows to your path.  Obviously, this needs
+          to be slightly modified for a Unix machine.  Now, you need to add the following line to your
+          forrest.properties file for the project (replacing *NetbeansHome* with the path to your install).
+        </p>
+        <source>forrest.jvmargs=-agentpath:C:\*NetbeansHome*\\profiler1\\lib\\deployed\\jdk15\\windows\\
+profilerinterface.dll=\C:\\*NetbeansHome*\\profiler1\\lib\\,5140</source>
+        <p>
+          You are now all set, simply type 'forrest run', then open up the Netbeans IDE with your Forrest 
+          project.  Click Profile->Attach Profiler and make selections appropriate to what you are trying 
+          to achieve. 
+        </p>
+      </section>
     </section>
 
     <section id="find">