Just add a file to use to house some platform dependent knowledge...

Right now, just some Darwin notes.
PR:
Obtained from:
Submitted by:
Reviewed by:

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

diff --git a/README b/README
index bcda0b9c7e12a2cd637ca5de1f5ae2c6ff30d854..c4c2108399843c195d553ee6ff41d64cf40df6b4 100644 (file)
--- a/README
+++ b/README
@@ -29,7 +29,8 @@
   Installation
   ------------
 
-  Please see the file called INSTALL.
+  Please see the file called INSTALL.  Platform specific notes can be
+  found in README.platforms.
 
   Licensing
   ---------

diff --git a/README.platforms b/README.platforms
new file mode 100644 (file)
index 0000000..d5a9b6e
--- /dev/null
+++ b/README.platforms
@@ -0,0 +1,37 @@
+
+                          Apache HTTP Server
+
+  Platform specific notes:
+  ------------------------
+
+  Darwin (OS X):
+   Apache 2.0 relies heavily on the use of autoconf and libtool to provide
+   a build environment.  Darwin provides these tools,  but they are
+   an earlier release,  and for the most part,  do not work well.
+   If you are interested in developing under Darwin,  we recommend
+   that you obtain and install replacement versions of what are
+   normally installed on Darwin (and OS X, as of v10.1.4).  If you
+   build your own versions of autoconf 2.52 and libtool 1.4.2,  be
+   aware that there are some Darwin specific patchs to the official
+   code that still must be applied for them to fully work.  A useful
+   page to check out is:
+
+      http://fink.sourceforge.net/doc/porting/libtool.php
+
+   Pier Fumagalli also provides pre-built Darwin packages of the
+   patched autoconf and libtool suites,  available at:
+
+      http://www.apache.org/~pier/macosx/
+
+   You will note that GNU libtool should actually be installed as
+   glibtool, to avoid conflict with a Darwin program of the same
+   name.  Pier's packages have this change already.  All files are
+   installed under /usr/local/ so to use these versions,  be sure that
+   /usr/local/bin is earlier in your PATH.
+
+   There have been some reports that autoconf 2.52 prevents Apache's
+   build system from correctly handling passing multi-value envvars
+   to the build system (eg: CFLAGS="-g -O3" ./configure),  causing
+   errors.  Use of bash does not seem to help in this situation.  If
+   this affects you, downgrading to autoconf 2.13 (which is installed
+   on Darwin) will help.