Tell the user that environment variables are case sensitive.
authorbbahnsen <bbahnsen@de2fecce-e211-0410-80a6-f3fac2684e05>
Fri, 12 May 2006 19:12:09 +0000 (19:12 +0000)
committerbbahnsen <bbahnsen@de2fecce-e211-0410-80a6-f3fac2684e05>
Fri, 12 May 2006 19:12:09 +0000 (19:12 +0000)
git-svn-id: https://edk2.tianocore.org/svn/edk2/trunk@136 de2fecce-e211-0410-80a6-f3fac2684e05

www/installation.html

index 5851ce1..1d0d2be 100644 (file)
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
-<html xmlns="http://www.w3.org/1999/xhtml">\r
-<head>\r
-  <meta content="text/html; charset=ISO-8859-1"\r
- http-equiv="content-type">\r
-  <title>EDK 2.0 Installation Guide</title>\r
-</head>\r
-<body>\r
-<h3>Getting and installing the required tools for building the EDK2<br>\r
-</h3>\r
-<h3>Table of Contents</h3>\r
-<ul>\r
-  <li><a href="#Requirements">Requirements</a></li>\r
-</ul>\r
-<h3><a name="Requirements"></a>Requirements</h3>\r
-<p>\r
-The following are required to be able to build the EDK:\r
-</p>\r
-<div id="requirements">\r
-<table style="width: 741px; height: 216px;" id="requirements_table"\r
- border="1" cellpadding="0" cellspacing="0">\r
-  <tbody>\r
-    <tr class="header">\r
-      <th\r
- style="border-color: black; background-color: grey; color: white;">Name</th>\r
-      <th\r
- style="border-color: black; background-color: grey; color: white;">Version</th>\r
-      <th\r
- style="border-color: black; background-color: grey; color: white;">URL</th>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">TortoiseSVN<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">1.3.3<br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download">http://prdownloads.sourceforge.net/tortoisesvn/</a><br>\r
-      <a\r
- href="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download">TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download</a><br>\r
-      </td>\r
-    </tr>\r
-    <tr>\r
-      <td style="text-align: center; font-weight: bold;">Ant</td>\r
-      <td style="text-align: center; font-weight: bold;">1.6.5</td>\r
-      <td style="text-align: center;"><a\r
- href="http://ant.apache.org/bindownload.cgi">http://ant.apache.org/bindownload.cgi</a></td>\r
-    </tr>\r
-    <tr>\r
-      <td style="text-align: center; font-weight: bold;">Ant\r
-Contrib</td>\r
-      <td style="text-align: center; font-weight: bold;">1.0b2</td>\r
-      <td style="text-align: center;"><a\r
- href="http://sourceforge.net/project/showfiles.php?group_id=36177">http://sourceforge.net/project/showfiles.php?group_id=36177</a></td>\r
-    </tr>\r
-    <tr>\r
-      <td style="text-align: center; font-weight: bold;">Java\r
-JDK</td>\r
-      <td style="text-align: center; font-weight: bold;">1.5.x</td>\r
-      <td style="text-align: center;"><a\r
- href="http://java.sun.com/j2se/1.5.0/download.jsp">http://java.sun.com/j2se/1.5.0/download.jsp</a></td>\r
-    </tr>\r
-    <tr>\r
-      <td style="text-align: center; font-weight: bold;">Saxon-B</td>\r
-      <td style="text-align: center; font-weight: bold;">8.1.1 for Java<br>\r
-      </td>\r
-      <td style="text-align: center;"><a\r
- href="http://prdownloads.sourceforge.net/saxon/saxonb8-1-1.zip">http://prdownloads.sourceforge.net/saxon/saxonb8-1-1.zip<br>\r
-      </a></td>\r
-    </tr>\r
-    <tr>\r
-      <td style="text-align: center; font-weight: bold;">XMLBeans</td>\r
-      <td style="text-align: center; font-weight: bold;">2.1.0</td>\r
-      <td style="text-align: center;"><a\r
- href="http://www.apache.org/dyn/closer.cgi/xmlbeans/binaries">http://www.apache.org/dyn/closer.cgi/xmlbeans/binaries</a></td>\r
-    </tr>\r
-  </tbody>\r
-</table>\r
-<br>\r
-<p>The following tools are optional:<br>\r
-</p>\r
-<div id="requirements">\r
-<table style="width: 745px; height: 46px;" id="requirements_table"\r
- border="1" cellpadding="0" cellspacing="0">\r
-  <tbody>\r
-    <tr class="header">\r
-      <th\r
- style="border-color: black; background-color: grey; color: white;">Name</th>\r
-      <th\r
- style="border-color: black; background-color: grey; color: white;">Version</th>\r
-      <th\r
- style="border-color: black; background-color: grey; color: white;">URL</th>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; font-weight: bold; text-align: center;">Cygwin<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; font-weight: bold; text-align: center;">Current<br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://www.cygwin.com">http://www.cygwin.com</a><br>\r
-      </td>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">Intel\r
-C++ Compiler for Windows<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">9.0\r
-      <br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://www.intel.com">http://www.intel.com</a><br>\r
-      </td>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">Intel\r
-C Compiler for EFI Byte Code<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">1.2<br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://www.intel.com/cd/software/products/asmo-na/eng/compilers/efibc/index.htm">http://www.intel.com/cd/software/products</a><br>\r
-      <a\r
- href="http://www.intel.com/cd/software/products/asmo-na/eng/compilers/efibc/index.htm">/asmo-na/eng/compilers/efibc/index.htm</a><br>\r
-      </td>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">Microsoft\r
-Driver Development Kit<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">3790.1830<br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://www.microsoft.com/whdc/devtools/ddk/orderddkcd.mspx">http://www.microsoft.com/whdc/devtools/ddk/orderddkcd.mspx</a><br>\r
-      </td>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">Microsoft\r
-ACPI Source Language Assembler<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">1.0.13NT<br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://download.microsoft.com/download/0/e/2/0e258da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe">http://download.microsoft.com/download/0/e/2/0e2</a><br>\r
-      <a\r
- href="http://download.microsoft.com/download/0/e/2/0e258da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe">58da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe</a><br>\r
-      </td>\r
-    </tr>\r
-    <tr>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">Intel\r
-ACPI Component Architecture<br>\r
-      </td>\r
-      <td\r
- style="vertical-align: top; text-align: center; font-weight: bold;">20060113<br>\r
-      </td>\r
-      <td style="vertical-align: top; text-align: center;"><a\r
- href="http://www.intel.com/technology/iapc/acpi/downloads.htm">http://www.intel.com/technology/iapc/acpi/downloads.htm</a><br>\r
-      </td>\r
-    </tr>\r
-  </tbody>\r
-</table>\r
-<h3>Install and Configure Tools on Windows XP</h3>\r
-<h4>Software Installation Order</h4>\r
-After installing the compiler tools and your Subversion client, the\r
-following required tools should be installed in this order: <br>\r
-Java JDK, Apache-Ant, ant-contrib, xmlbeans, saxon8<br>\r
-<h4>Java Development Kit</h4>\r
-The Java Environment Variable must be set before attempting to build.<br>\r
-e.g. For Sun JDK:<br>\r
-<pre>set JAVA_HOME=c:\Java\jdk1.5.0_06</pre>\r
-During installation, you should specify the install directory as\r
-C:\Java instead of C:\Program Files (or some other drive letter.)&nbsp;\r
-While installing to this non-standard location is not required. In use,\r
-it seems to work more reliably.<br>\r
-<br>\r
-NOTE: You cannot combine the location for the JDK and the JRE, as the\r
-JRE install removes most of the binaries and libraries installed by the\r
-JDK install.<br>\r
-<h4>Java Tools</h4>\r
-The Apache-ANT requires the ANT_HOME environment variable to be set\r
-before attempting to build:<br>\r
-<br>\r
-Unzip <span style="font-weight: bold;">apache-ant-1.6.5-bin.zip</span>\r
-to a directory. We need to set an environment variable ANT_HOME to this\r
-location:\r
-<pre>set ANT_HOME=&lt;full path to where ant was unzipped&gt;</pre>\r
-Unzip the <span style="font-weight: bold;">ant-contrib-1.0b2-bin.zip</span>\r
-file. The ant-contrib.jar file should be <span\r
- style="font-weight: bold;">copied </span>into the %ANT_HOME%\lib\r
-directory.<br>\r
-<br>\r
-Unzip <span style="font-weight: bold;">xmlbeans-2.1.0.zip</span> to a\r
-directory. XMLBeans requires the XMLBEANS_HOME environment variable to\r
-be set\r
-before attempting to build:<br>\r
-<pre>set XMLBEANS_HOME=&lt;full path to where xmlbeans was unzipped&gt;</pre>\r
-Unzip the <span style="font-weight: bold;">saxonb8-1-1.zip</span>\r
-file. The saxon8.jar file should be <span style="font-weight: bold;">copied\r
-</span>to\r
-the %XMLBEANS_HOME%\lib\r
-directory. Do <span style="font-style: italic;">not </span>download a\r
-later version of saxon 8. You will get the\r
-following error message if you do:<br>\r
-<pre>build.xml:45: java.lang.RuntimeException:&nbsp; Trying XBeans path engine... Trying XQRL... Trying Saxon... FAILED on declare namespace sans='http://www.TianoCore.org/2006/Edk2.0'; $this/sans:FrameworkPlatformDescription/sans:Flash/sans:FvImages/sans:FvImage[@Type='ValidImageNames']/sans:FvImageNames</pre>\r
-The Ant and XMLBean tools are required to be in the path.<br>\r
-<pre>set PATH=%PATH%;%ANT_HOME%\bin;%XMLBEANS_HOME%\bin<br></pre>\r
-<h3>Cygwin</h3>\r
-If you optionally install cygwin (for gcc support) you should install\r
-it in "Unix" mode. The gcc tool chain will not compile in "DOS" mode.<br>\r
-<h3>Environment Variables</h3>\r
-You need to set WORKSPACE to the location of the edk2 directory that\r
-you pulled from Subversion. For example<br>\r
-<pre>set WORKSPACE=c:\workspace\edk2\</pre>\r
-It is recommended that you wrap up all the environment variables above\r
-into a script that you can launch each time you begin to do development\r
-in your EDK2 workspace.<br>\r
-<h3>The first build</h3>\r
-Once the external tools are installed, the environment variables are\r
-set, and you have the ant executable in your path, you can try a build.<br>\r
-<ol>\r
-  <li>cd to %WORKSPACE%</li>\r
-  <li>run edksetup.bat (this will build several tools that are used in\r
-edk2 development. It will fail if the external tools above are not\r
-properly installed.)<br>\r
-  </li>\r
-  <li>cd MdePkg</li>\r
-  <li>type ant</li>\r
-</ol>\r
-</div>\r
-</div>\r
-</body>\r
-</html>\r
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">\r
+<HTML>\r
+<HEAD>\r
+       <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">\r
+       <TITLE>EDK 2.0 Installation Guide</TITLE>\r
+       <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0  (Win32)">\r
+       <META NAME="CREATED" CONTENT="20060512;12074440">\r
+       <META NAME="CHANGEDBY" CONTENT="Bruce Bahnsen">\r
+       <META NAME="CHANGED" CONTENT="20060512;12101742">\r
+</HEAD>\r
+<BODY LANG="en-US" DIR="LTR">\r
+<H3>Getting and installing the required tools for building the EDK2</H3>\r
+<H3>Table of Contents</H3>\r
+<UL>\r
+       <LI><P><A HREF="#Requirements">Requirements</A> \r
+       </P>\r
+</UL>\r
+<H3><A NAME="Requirements"></A>Requirements</H3>\r
+<P>The following are required to be able to build the EDK: \r
+</P>\r
+<DIV ID="requirements" DIR="LTR"><A NAME="requirements_table"></A>\r
+       <TABLE BORDER=1 CELLPADDING=0 CELLSPACING=0>\r
+               <TR>\r
+                       <TH>\r
+                               <P STYLE="border: none; padding: 0in"><FONT COLOR="#ffffff">Name</FONT></P>\r
+                       </TH>\r
+                       <TH>\r
+                               <P STYLE="border: none; padding: 0in"><FONT COLOR="#ffffff">Version</FONT></P>\r
+                       </TH>\r
+                       <TH>\r
+                               <P STYLE="border: none; padding: 0in"><FONT COLOR="#ffffff">URL</FONT></P>\r
+                       </TH>\r
+               </TR>\r
+               <TR>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>TortoiseSVN</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>1.3.3</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><A HREF="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download">http://prdownloads.sourceforge.net/tortoisesvn/</A><BR><A HREF="http://prdownloads.sourceforge.net/tortoisesvn/TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download">TortoiseSVN-1.3.3.6219-svn-1.3.1.msi?download</A></P>\r
+                       </TD>\r
+               </TR>\r
+               <TR>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>Ant</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>1.6.5</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><A HREF="http://ant.apache.org/bindownload.cgi">http://ant.apache.org/bindownload.cgi</A></P>\r
+                       </TD>\r
+               </TR>\r
+               <TR>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>Ant Contrib</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>1.0b2</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><A HREF="http://sourceforge.net/project/showfiles.php?group_id=36177">http://sourceforge.net/project/showfiles.php?group_id=36177</A></P>\r
+                       </TD>\r
+               </TR>\r
+               <TR>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>Java JDK</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>1.5.x</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><A HREF="http://java.sun.com/j2se/1.5.0/download.jsp">http://java.sun.com/j2se/1.5.0/download.jsp</A></P>\r
+                       </TD>\r
+               </TR>\r
+               <TR>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>Saxon-B</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>8.1.1 for Java</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><A HREF="http://prdownloads.sourceforge.net/saxon/saxonb8-1-1.zip">http://prdownloads.sourceforge.net/saxon/saxonb8-1-1.zip</A></P>\r
+                       </TD>\r
+               </TR>\r
+               <TR>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>XMLBeans</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><B>2.1.0</B></P>\r
+                       </TD>\r
+                       <TD>\r
+                               <P ALIGN=CENTER><A HREF="http://www.apache.org/dyn/closer.cgi/xmlbeans/binaries">http://www.apache.org/dyn/closer.cgi/xmlbeans/binaries</A></P>\r
+                       </TD>\r
+               </TR>\r
+       </TABLE>\r
+       <P><BR><BR>\r
+       </P>\r
+       <P>The following tools are optional:</P>\r
+       <DIV ID="Section1" DIR="LTR"><A NAME="requirements"></A><A NAME="requirements_table1"></A>\r
+               <TABLE BORDER=1 CELLPADDING=0 CELLSPACING=0>\r
+                       <TR>\r
+                               <TH>\r
+                                       <P STYLE="border: none; padding: 0in"><FONT COLOR="#ffffff">Name</FONT></P>\r
+                               </TH>\r
+                               <TH>\r
+                                       <P STYLE="border: none; padding: 0in"><FONT COLOR="#ffffff">Version</FONT></P>\r
+                               </TH>\r
+                               <TH>\r
+                                       <P STYLE="border: none; padding: 0in"><FONT COLOR="#ffffff">URL</FONT></P>\r
+                               </TH>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Cygwin</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Current</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.cygwin.com/">http://www.cygwin.com</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Intel C++ Compiler for Windows</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>9.0 </B>\r
+                                       </P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.intel.com/">http://www.intel.com</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Intel C Compiler for EFI Byte Code</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>1.2</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.intel.com/cd/software/products/asmo-na/eng/compilers/efibc/index.htm">http://www.intel.com/cd/software/products</A><BR><A HREF="http://www.intel.com/cd/software/products/asmo-na/eng/compilers/efibc/index.htm">/asmo-na/eng/compilers/efibc/index.htm</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Microsoft Driver Development Kit</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>3790.1830</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.microsoft.com/whdc/devtools/ddk/orderddkcd.mspx">http://www.microsoft.com/whdc/devtools/ddk/orderddkcd.mspx</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Microsoft ACPI Source Language Assembler</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>1.0.13NT</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://download.microsoft.com/download/0/e/2/0e258da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe">http://download.microsoft.com/download/0/e/2/0e2</A><BR><A HREF="http://download.microsoft.com/download/0/e/2/0e258da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe">58da3-dd7a-4d3b-9b48-8673b6b5897c/ASL.exe</A></P>\r
+                               </TD>\r
+                       </TR>\r
+                       <TR>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>Intel ACPI Component Architecture</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><B>20060113</B></P>\r
+                               </TD>\r
+                               <TD>\r
+                                       <P ALIGN=CENTER><A HREF="http://www.intel.com/technology/iapc/acpi/downloads.htm">http://www.intel.com/technology/iapc/acpi/downloads.htm</A></P>\r
+                               </TD>\r
+                       </TR>\r
+               </TABLE>\r
+               <H3>Install and Configure Tools on Windows XP</H3>\r
+               <H4>Software Installation Order</H4>\r
+               <P>After installing the compiler tools and your Subversion client,\r
+               the following required tools should be installed in this order:\r
+               <BR>Java JDK, Apache-Ant, ant-contrib, xmlbeans, saxon8</P>\r
+               <H4>Java Development Kit</H4>\r
+               <P>The Java Environment Variable must be set before attempting to\r
+               build.<BR>e.g. For Sun JDK:</P>\r
+               <PRE STYLE="margin-bottom: 0.2in">set JAVA_HOME=c:\Java\jdk1.5.0_06</PRE><P>\r
+               During installation, you should specify the install directory as\r
+               C:\Java instead of C:\Program Files (or some other drive letter.)&nbsp;\r
+               While installing to this non-standard location is not required. In\r
+               use, it seems to work more reliably.<BR><BR>NOTE: You cannot\r
+               combine the location for the JDK and the JRE, as the JRE install\r
+               removes most of the binaries and libraries installed by the JDK\r
+               install.</P>\r
+               <H4>Java Tools</H4>\r
+               <P>The Apache-ANT requires the ANT_HOME environment variable to be\r
+               set before attempting to build:<BR><BR>Unzip\r
+               <B>apache-ant-1.6.5-bin.zip</B> to a directory. We need to set an\r
+               environment variable ANT_HOME to this location: \r
+               </P>\r
+               <PRE STYLE="margin-bottom: 0.2in">set ANT_HOME=&lt;full path to where ant was unzipped&gt;</PRE><P>\r
+               Unzip the <B>ant-contrib-1.0b2-bin.zip</B> file. The\r
+               ant-contrib.jar file should be <B>copied </B>into the\r
+               %ANT_HOME%\lib directory.<BR><BR>Unzip <B>xmlbeans-2.1.0.zip</B> to\r
+               a directory. XMLBeans requires the XMLBEANS_HOME environment\r
+               variable to be set before attempting to build:</P>\r
+               <PRE STYLE="margin-bottom: 0.2in">set XMLBEANS_HOME=&lt;full path to where xmlbeans was unzipped&gt;</PRE><P>\r
+               Unzip the <B>saxonb8-1-1.zip</B> file. The saxon8.jar file should\r
+               be <B>copied </B>to the %XMLBEANS_HOME%\lib directory. Do <I>not\r
+               </I>download a later version of saxon 8. You will get the following\r
+               error message if you do:</P>\r
+               <PRE STYLE="margin-bottom: 0.2in">build.xml:45: java.lang.RuntimeException: Trying XBeans path engine... Trying XQRL... Trying Saxon... FAILED on declare namespace sans='http://www.TianoCore.org/2006/Edk2.0'; $this/sans:FrameworkPlatformDescription/sans:Flash/sans:FvImages/sans:FvImage[@Type='ValidImageNames']/sans:FvImageNames</PRE><P>\r
+               The Ant and XMLBean tools are required to be in the path.</P>\r
+               <PRE STYLE="margin-bottom: 0.2in">set PATH=%PATH%;%ANT_HOME%\bin;%XMLBEANS_HOME%\bin</PRE><H3>\r
+               Cygwin</H3>\r
+               <P>If you optionally install cygwin (for gcc support) you should\r
+               install it in &quot;Unix&quot; mode. The gcc tool chain will not\r
+               compile in &quot;DOS&quot; mode.</P>\r
+               <H3>Environment Variables</H3>\r
+               <P>Environment variables are <B>case sensitive</B>. You must use\r
+               the exact case as in the examples of this document. Even though\r
+               windows does not care about case, Java does.<BR><BR>You need to set\r
+               WORKSPACE to the location of the edk2 directory that you pulled\r
+               from Subversion. For example</P>\r
+               <PRE STYLE="margin-bottom: 0.2in">set WORKSPACE=c:\workspace\edk2\</PRE><P>\r
+               It is recommended that you wrap up all the environment variables\r
+               above into a script that you can launch each time you begin to do\r
+               development in your EDK2 workspace.</P>\r
+               <H3>The first build</H3>\r
+               <P>Once the external tools are installed, the environment variables\r
+               are set, and you have the ant executable in your path, you can try\r
+               a build.</P>\r
+               <OL>\r
+                       <LI><P STYLE="margin-bottom: 0in">cd to %WORKSPACE% \r
+                       </P>\r
+                       <LI><P STYLE="margin-bottom: 0in">run edksetup.bat (this will\r
+                       build several tools that are used in edk2 development. It will\r
+                       fail if the external tools above are not properly installed.)</P>\r
+                       <LI><P STYLE="margin-bottom: 0in">cd MdePkg \r
+                       </P>\r
+                       <LI><P>type ant \r
+                       </P>\r
+               </OL>\r
+       </DIV>\r
+</DIV>\r
+</BODY>\r
+</HTML>
\ No newline at end of file