From: William A. Rowe Jr <wrowe@apache.org>
Date: Wed, 15 May 2002 22:43:25 +0000 (+0000)
Subject:   Document the fact that Cygwin's awk doesn't work with MSVC. This is
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=7db46535fd35e5d689b1d0faef12927ec456913c;p=apache

  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 08893021e1..ebe5d7d07e 100644
--- 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 />