Add windows build notes before any 2.2.X release, which should help

users with the integration notes for obtaining 3rd party db drivers.

This file was shipped in the tarball as a dist artifact, but it
better belongs in the httpd tree to warn users about the first pipe
handling issue if they are rolling their own.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@782399 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/README-win32.txt b/README-win32.txt
new file mode 100644 (file)
index 0000000..d7c793c
--- /dev/null
+++ b/README-win32.txt
@@ -0,0 +1,57 @@
+New version of APR\r
+------------------\r
+\r
+Note that the included APR is now version 1.3, which adds several\r
+subtle changes in the behavior of file handling, pipes and process\r
+creation.  Most importantly, there is finer control over the handles\r
+inherited by processes, so the mod_fastcgi or mod_fcgid modules must \r
+be updated for httpd-2.2.9 to run correctly on Windows.\r
+\r
+Most other third party modules are unaffected by this change.\r
+\r
+\r
+Source corrections applied\r
+--------------------------\r
+\r
+The -win32-src.zip package includes corrections to the Makefile.win\r
+build file so that .mak based builds work.  The package also corrects\r
+the default to disable IPV6 support.  These patches are summarized in\r
+the httpd-2.2.9-win32-src.applied.patch file.\r
+\r
+\r
+Connecting to databases\r
+-----------------------\r
+\r
+With APR-util 1.3.0, the MySQL and FreeTDS drivers do not compile\r
+on Windows.  There is no Microsoft SQL Server client or ODBC client\r
+at the present time.\r
+\r
+Three driver connectors are provided in the binary distribution, for\r
+SQLite3, PostgreSQL and Oracle.  They require you to install the actual \r
+corresponding client drivers.\r
+\r
+The sqlitedll.zip binary file can be obtained from;\r
+\r
+http://www.sqlite.org/download.html\r
+\r
+note that this binary was built with version 3.5.9 (earlier and\r
+later version 3.5 driver .dll's may work.)\r
+\r
+The Oracle Instant Client - Basic driver can be obtained from\r
+\r
+http://www.oracle.com/technology/software/tech/oci/instantclient/htdocs/winsoft.html\r
+\r
+and note that this binary was built against version 11.1.0.6.0,\r
+other version 11.1 drivers may work.\r
+\r
+The PostgreSQL binaries may be obtained from\r
+\r
+http://www.postgresql.org/ftp/binary/v8.3.1/win32/\r
+\r
+and note that this binary was built against version 8.3.1-1, and\r
+again it may work with other 8.1 version .dll's.\r
+\r
+For whichever database backend you configure, the corresponding driver\r
+.dll's must be in your PATH (and in the systemwide path if used for \r
+a service such as Apache httpd).\r
+\r