Updates for cygwin
[mirror_edk2.git] / Tools / gcc / README.txt
index 71c31a8..9e581f2 100644 (file)
@@ -5,8 +5,9 @@ system to make the scripts work.
 \r
 You will need\r
 \r
-  A recent version of gcc that is able to produce executables for the machine\r
-    that you want to run this compiler on (the host machine).\r
+  A recent version (3.0 or later should be fine) of gcc that is able to produce\r
+    executables for the machine that you want to run this compiler on (the host\r
+    machine).\r
   wget or curl\r
   tar\r
   bzip\r
@@ -16,14 +17,19 @@ You will need
 \r
 CYGWIN Notes\r
 \r
-You must have the directory mounted as binary, or the build will not succeed.\r
-In the example below, /workspace is mounted as binary.\r
+You should setup cygwin to use binmode on all mounts. When you initially\r
+install cygwin it gives you the choice of Unix file mode (recommended) or DOS\r
+file mode. Unix mode will cause all the cygwin directories to be mounted in\r
+binmode, while DOS will mount the dirs in textmode. Here is an example of a\r
+cygwin install where the dirs are (properly) mounted in binmode.\r
 \r
-C:\cygwin\bin on /usr/bin type user (textmode)\r
-C:\cygwin\lib on /usr/lib type user (textmode)\r
+C:\cygwin\bin on /usr/bin type user (binmode)\r
+C:\cygwin\lib on /usr/lib type user (binmode)\r
 c:\workspace on /workspace type system (binmode)\r
-C:\cygwin on / type user (textmode)\r
-c: on /cygdrive/c type user (textmode,noumount)\r
-n: on /cygdrive/n type user (textmode,noumount)\r
+C:\cygwin on / type user (binmode)\r
 \r
+If you use textmode, it is likely that the build will fail in a way that is\r
+hard to debug.\r
+\r
+Cygwin is pretty slow, so it is not recommended for large builds.\r
 \r