doc updates for 76101 from Helen - how to build AJ and stuff it into AJDT.

1 files changed, 124 insertions, 1 deletions

diff --git a/docs/faq/faq.xml b/docs/faq/faq.xml
index ff6acf3ad..7a27b0b08 100644
--- a/docs/faq/faq.xml
+++ b/docs/faq/faq.xml
@@ -22,7 +22,7 @@
        2003-2005 Contributors. All rights reserved.
   </para>
   <!-- todo Update me! -->
-  <para>Last updated December 18, 2005
+  <para>Last updated January 17, 2006
   </para>
   <para>
    For a list of recently-updated FAQ entries, see <xref linkend="q:faqchanges"/>
@@ -4294,6 +4294,11 @@ java -javaagent:aspectjweaver.jar -classpath "aspects.jar:${CLASSPATH}" ..
 			</listitem>
 			<listitem>
 			<para>
+			Name: <literal>JRE14_LIB</literal>, Value: (wherever your Java 4 Runtime is installed)<literal>\jre\lib\rt.jar</literal>
+			</para>
+			</listitem>
+			<listitem>
+			<para>
 			Name: <literal>JRE15_LIB</literal>, Value: (wherever your Java 5 Runtime is installed)<literal>\jre\lib\rt.jar</literal>
 			</para>
 			</listitem>
@@ -4304,6 +4309,12 @@ java -javaagent:aspectjweaver.jar -classpath "aspects.jar:${CLASSPATH}" ..
 			</listitem>
 		  </itemizedlist>
 		  </para>
+		  <para>
+		  The <literal>org.aspectj.lib</literal> project is an AspectJ project so 
+          you also have to have AJDT installed. For the latest AJDT release and
+          download instructions visit the
+		  <ulink url="http://www.eclipse.org/ajdt/downloads/">AJDT Downloads</ulink> page.
+		  </para>
 			<para>
 			When you've added the variables click OK to do a full rebuild, then run the tests by going in the Package Explorer to:
 			<literal>run-all-junit-tests > testsrc > (default package) > RunTheseBeforeYouCommitTests.java</literal>
@@ -4361,6 +4372,117 @@ java -javaagent:aspectjweaver.jar -classpath "aspects.jar:${CLASSPATH}" ..
         </answer>
       </qandaentry>
       <qandaentry>
+
+        <question id="q:buildingAspectJAndAJDT"
+            xreflabel="Q:How do I build AspectJ and integrate it into AJDT?">
+          <para>How do I build AspectJ and integrate it into AJDT?
+          </para>
+        </question>
+        <answer>
+          <para>To build AspectJ, first get the source tree as
+          described in <xref linkend="q:buildingsource"/>. Once you have
+          a development environment set up, copy the 
+          <literal>build/sample-local.properties</literal> file
+          to <literal>build/local.properties</literal> and within this file point the 
+          <literal>java14.home</literal> and <literal>java15.home</literal>
+          to the corresponding places on your machine.
+          </para>
+			<para>
+             To build AspectJ on the command line:
+          </para>
+		  <para>
+		  <itemizedlist>
+		  	<listitem>
+		  	<para>
+			Open a command prompt
+			</para>
+			</listitem>
+			<listitem>
+			<para>
+			Navigate to the <literal>build</literal> directory within your AspectJ workspace 
+			(to find out where your workspace is go to <literal>File > 
+			Switch Workspace</literal> within Eclipse).
+			</para>
+			</listitem>
+			<listitem>
+			<para>
+			Run <literal>ant clean</literal> to remove the files from 
+			previously built AspectJ versions. 
+			</para>
+			</listitem>
+		  	<listitem>
+		  	<para>
+			Run <literal>ant</literal> to build AspectJ. The built files are created in 
+			<literal>your_eclipse_installation_directory/aspectj_development_workspace/aj-build</literal>.
+			</para>
+			</listitem>
+		  </itemizedlist>
+		  </para>
+			<para>
+			To import a locally built AspectJ into AJDT first follow the
+			instructions on <ulink url="http://www.eclipse.org/ajdt/faq.php#q:develop">
+			How do I setup an AJDT development environment in Eclipse?</ulink>
+			for setting up an AJDT development environment and running the 
+			correctness tests. Then:
+			</para>
+		  <para>
+		  <itemizedlist>
+		  	<listitem>
+		  	<para>
+			Create a file <literal>aspectjlib.properties</literal> within 
+			the <literal>org.aspectj.ajde</literal> project and add the following two lines
+			<programlisting>
+aspectj.lib.dir=C:/eclipse/aspectj-workspace/aj-build/dist/tools/lib
+aspectj.doc.dir=C:/eclipse/aspectj-workspace/aj-build/dist/ide/eclipse/org.aspectj.ajde.doc/doc
+			</programlisting>
+  			making sure to change the path to correspond to your set up.
+			</para>
+			</listitem>
+			<listitem>
+			<para>
+			Run the <literal>build.xml</literal> file in <literal>org.aspectj.ajde</literal> 
+			with the <literal>plugin jars</literal> target:
+			<itemizedlist>
+		  	   	<listitem>
+		  		<para>
+	 			Right click on the <literal>build.xml</literal> file in the 
+	 			<literal>org.aspectj.ajde</literal> plugin
+	 			</para>
+	 			</listitem>
+				<listitem>
+	 			<para>
+				Select <literal>Run As > Ant build...</literal>
+				</para>
+				</listitem>
+				<listitem>
+				<para>
+				In the resultant dialog navigate to the <literal>Targets</literal> tab
+				</para>
+				</listitem>
+				<listitem>
+				<para>
+				Ensure <literal>plugin jars</literal> is the only selected target
+				</para>
+				</listitem>
+				<listitem>
+				<para>
+				Click <literal>Run</literal>
+				</para>
+				</listitem>
+			</itemizedlist>	
+			</para>
+			</listitem>
+			<listitem>
+			<para>
+			Refresh the <literal>org.aspectj.ajde, org.aspectj.runtime</literal> 
+			and <literal>org.aspectj.weaver</literal> plugins.
+			</para>
+			</listitem>
+		  </itemizedlist>
+		  </para>					
+        </answer>
+      </qandaentry>
+      <qandaentry>
         <question id="q:devDocs"
             xreflabel="Q:Where do I find developer documentation on building and testing AspectJ source code?">
           <para>Where do I find developer documentation on building and testing AspectJ source code?
@@ -4850,6 +4972,7 @@ java -javaagent:aspectjweaver.jar -classpath "aspects.jar:${CLASSPATH}" ..
         <listitem><para><xref linkend="q:java5"/></para></listitem>
 	    <listitem><para><xref linkend="q:dynamicaop"/></para></listitem>
         <listitem><para><xref linkend="q:buildingsource"/></para></listitem>
+        <listitem><para><xref linkend="q:buildingAspectJAndAJDT"/></para></listitem>
             </itemizedlist>
           </para>
         </answer>