More info on compiling with Cygwin.

[mirror_edk2.git] / ReleaseNotes.txt

diff --git a/ReleaseNotes.txt b/ReleaseNotes.txt
index 34254e61c7513f478f7bbc0ca1d7ee71d756a918..d10f1efd0193c5dbe39afcb32d22a7e595c799c6 100644 (file)
--- a/ReleaseNotes.txt
+++ b/ReleaseNotes.txt
@@ -1,7 +1,7 @@
 Intel(R) Platform Innovation Framework for EFI\r
 EFI Development Kit II (EDK II) \r
 Root Package 1.00\r
 Intel(R) Platform Innovation Framework for EFI\r
 EFI Development Kit II (EDK II) \r
 Root Package 1.00\r

-2006-07-13\r
+2006-07-18\r

 \r
 Intel is a trademark or registered trademark of Intel Corporation or its \r
 subsidiaries in the United States and other countries.\r
 \r
 Intel is a trademark or registered trademark of Intel Corporation or its \r
 subsidiaries in the United States and other countries.\r


@@ -192,6 +192,41 @@ many other POSIX-compliant host operating environments. To compile the custom
 gcc tool chain, you need the following tools on your host computer: bash, gcc, \r
 gmake, curl (or wget).\r
 \r
 gcc tool chain, you need the following tools on your host computer: bash, gcc, \r
 gmake, curl (or wget).\r
 \r

+Only the MdePkg and EdkModulePkg are currently supported by gcc builds. Other\r
+builds, such as the EdkNt32Pkg, will not compile with gcc.\r
+\r
+----------------------------\r
+A Word on compiling on Linux\r
+----------------------------\r
+\r
+In order to compile on Linux, you will need to have the e2fsprogs-dev package\r
+installed.  Check your distribution for the rpm, deb or other package format.\r
+This package contains the uuid library and header that are used by some of the\r
+host tools.\r
+\r
+If you are running on x86_64 Linux, then you should install a 64 bit version of\r
+the Java JDK. The version that was used was jdk-1_5_0_07-linux-amd64-rpm.bin.\r
+It may be downloaded from sun.com.\r
+\r
+-----------------------------------------\r
+A Word on compiling under Cygwin with gcc\r
+-----------------------------------------\r
+\r
+Cygwin is a POSIX style operating environment for Windows. It is possible to\r
+compile the EDK 2 using gcc and cygwin. There are a few extra steps necessary\r
+to make this happen. There is a JNI (Java Native Interface) library in the\r
+Tools.  In order to compile this under Cygwin, the 'linux' java headers must be\r
+installed to the $JAVA_HOME dir on the windows system. To accomplish this, you\r
+must install the JDK on a linux system, and then copy\r
+linux:$JAVA_HOME/include/linux/ to windows:$JAVA_HOME/include. These are really\r
+typedefs needed by gcc.\r
+\r
+Compiling under cygwin is slow, because the underlying file accesses are slow\r
+in cygwin. For this reason, we do not encourage the use of cygwin. A true unix\r
+system will be a superior choice for those wishing to compile with gcc.\r
+\r
+Make sure that you select the e2fsprogs development package when you install\r
+cygwin. It is necessary for the GenFvImage tool.\r

 \r
 -----------------------\r
 Notes on Documentation\r
 \r
 -----------------------\r
 Notes on Documentation\r


@@ -318,12 +353,18 @@ or
   about active platform policy, see the \93EDK II Build and Packaging Architecture\r
   Specification.\94 \r
 \r
   about active platform policy, see the \93EDK II Build and Packaging Architecture\r
   Specification.\94 \r
 \r

-To run the Nt32 emulation platform under Microsoft Windows, go to <full build path>\DEBUG\MSFT\IA32 and execute SecMain.exe\r
+To run the Nt32 emulation platform under Microsoft Windows, go to \r
+<full build path>\DEBUG\MSFT\IA32 and execute SecMain.exe\r

 \r
 To exit the Nt32 emulation platform, type \93reset\94 at the EFI Shell>\r
 command prompt.  Alternatively, from the graphical interface, select the Boot\r
 Maintenance Manager's \93Reset System\94 command.\r
 \r
 \r
 To exit the Nt32 emulation platform, type \93reset\94 at the EFI Shell>\r
 command prompt.  Alternatively, from the graphical interface, select the Boot\r
 Maintenance Manager's \93Reset System\94 command.\r
 \r

+      NOTE: When creating a new platform, the Platform Name is restricted\r
+      to a single word containing alphanumeric characters, underscore, dash, \r
+      and period.  The space character and other special characters are \r
+      not allowed.\r
+\r

 -----------------------\r
 Notes on Symbolic Debug\r
 -----------------------\r
 -----------------------\r
 Notes on Symbolic Debug\r
 -----------------------\r