Add Cygwin build note

git-svn-id: svn://svn.code.sf.net/p/nuttx/code/trunk@2979 42af7a65-404d-4744-a932-0658087f49c3

2 files changed, 34 insertions, 1 deletions

diff --git a/nuttx/Documentation/README.html b/nuttx/Documentation/README.html
index 8b95f247a..f52fb4a3c 100755
--- a/nuttx/Documentation/README.html
+++ b/nuttx/Documentation/README.html
@@ -9,7 +9,7 @@
   <tr align="center" bgcolor="#e4e4e4">
     <td>
       <h1><big><font color="#3c34ec"><i>NuttX README Files</i></font></big></h1>
-      <p>Last Updated: May 8, 2010</p>
+      <p>Last Updated: October 8, 2010</p>
     </td>
   </tr>
 </table>
@@ -43,6 +43,8 @@
  |   |       `- <a href="arch/z80/src/z80/README.txt">z80/README.txt</a>
  |   `- <a href="arch/README.txt"><b><i>README.txt</i></b></a>
  |- configs/
+ |   |- avr32dev1/
+ |   |   `- <a href="configs/avr32dev1/README.txt"><b><i>README.txt</i></b></a>
  |   |- c5471evm/
  |   |   |- <a href="configs/c5471evm/include/README.txt">include/README.txt</a>
  |   |   |- <a href="configs/c5471evm/src/README.txt">src/README.txt</a>
@@ -73,6 +75,8 @@
  |   |- m68332evb/
  |   |   |- <a href="configs/m68332evb/include/README.txt">include/README.txt</a>
  |   |   `- <a href="configs/m68332evb/src/README.txt">src/README.txt</a>
+ |   |- mbed/
+ |   |   `- <a href="configs/mbed/README.txt"><b><i>README.txt</i></b></a>
  |   |- mcu123-lpc214x/
  |   |   |- <a href="configs/mcu123-lpc214x/include/README.txt">include/README.txt</a>
  |   |   |- <a href="configs/mcu123-lpc214x/src/README.txt">src/README.txt</a>
diff --git a/nuttx/README.txt b/nuttx/README.txt
index 6e0a6c0d3..76d2c7911 100755
--- a/nuttx/README.txt
+++ b/nuttx/README.txt
@@ -99,6 +99,31 @@ At least one configuration (eagle100) requires additional command line
 arguments on the make command.  Read ${TOPDIR}/configs/<board-name>/README.txt
 to see if that applies to your target.
 
+CYGWIN BUILD PROBLEMS
+^^^^^^^^^^^^^^^^^^^^^
+
+If you see strange behaviour when building under Cygwin then you may have
+a problem with your PATH variable.  For example, if you see failures to
+locate files that are clearly present, then may mean that you are using
+the wrong version of a tool.  For example, you may not be using Cywgin's
+'make' program at /usr/bin/make.  Try:
+
+    $ which make
+    /usr/bin/make
+
+When you install some toolchains (such as Yargarto or CodeSourcery tools),
+they may modify your PATH variable to include a path to their binaries.
+At that location, they make have GNUWin32 versions of the tools.  So you
+might actually be using a version of make that does not understand Cygwin
+pathes.
+
+The solution is either:
+
+1. Edit your PATH to remove the path to the GNUWin32 tools, or
+2. Put /usr/local/bin, /usr/bin, and /bin at the front of your path:
+
+   $ export PATH=/usr/local/bin:/usr/bin:/bin:$PATH
+
 DOCUMENTATION
 ^^^^^^^^^^^^^
 
@@ -134,6 +159,8 @@ Below is a guide to the available README files in the NuttX source tree:
  |   |       `- z80/README.txt
  |   `- README.txt
  |- configs/
+ |   |- avr32dev1/
+ |   |   `- README.txt
  |   |- c5471evm/
  |   |   |- include/README.txt
  |   |   |- src/README.txt
@@ -164,6 +191,8 @@ Below is a guide to the available README files in the NuttX source tree:
  |   |- m68332evb/
  |   |   |- include/README.txt
  |   |   `- src/README.txt
+ |   |- mbed/
+ |   |   `- README.txt
  |   |- mcu123-lpc214x/
  |   |   |- include/README.txt
  |   |   |- src/README.txt