Document the fact that Cygwin's awk doesn't work with MSVC. This is

  due to Cygwin making awk.exe a 'cygwin symlink' to gawk.exe. The windows
  shell does not support symlinks, and so any Apache makefile references
  to awk.exe will fail.

PR:8726
Submitted by:	Jerry Baker <jerrybaker@weirdness.com>

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@95121 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/platform/win_compiling.html b/docs/manual/platform/win_compiling.html
index 08893021e18a8934877cab7594c0e8cf1a08d763..ebe5d7d07eb66111c988fe63c85033b23e3646d1 100644 (file)
--- a/docs/manual/platform/win_compiling.html
+++ b/docs/manual/platform/win_compiling.html
@@ -93,6 +93,13 @@
         listing Executable file paths.  Add the path for awk.exe to this 
         list, and your system PATH environment variable, as needed.<br />
         <br />
+         Also note that if you are using Cygwin (<a href="http://www.cygwin.com/"
+         >http://www.cygwin.com/</a>) the awk utility is named gawk.exe and
+         that the file awk.exe is really a symlink to the gawk.exe file. The
+         Windows command shell does not recognize symlinks, and because of that
+         building InstallBin will fail. A workaround is to delete awk.exe from
+         the cygwin installation and rename gawk.exe to awk.exe.<br />
+         <br />
       </li>
 
       <li>[Optional] OpenSSL libraries (for mod_ssl and ab.exe with ssl support)<br />