Mailing-List: contact commits-help@apr.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@apr.apache.org
Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Subject: svn commit: r592642 - /apr/apr/trunk/README.dev
Date: Wed, 07 Nov 2007 07:20:31 -0000
To: commits@apr.apache.org
From: wrowe@apache.org
Message-Id: <20071107072032.2436E1A9832@eris.apache.org>

Author: wrowe
Date: Tue Nov  6 23:20:30 2007
New Revision: 592642

URL: http://svn.apache.org/viewvc?rev=592642&view=rev
Log:
The four most common win32 apr questions, answered.

Modified:
    apr/apr/trunk/README.dev

Modified: apr/apr/trunk/README.dev
URL: http://svn.apache.org/viewvc/apr/apr/trunk/README.dev?rev=592642&r1=592641&r2=592642&view=diff
==============================================================================
--- apr/apr/trunk/README.dev (original)
+++ apr/apr/trunk/README.dev Tue Nov  6 23:20:30 2007
@@ -50,6 +50,37 @@
    ./testall -v
 
 
+Configuring and Building APR on Windows
+=======================================
+
+Using Visual Studio, you can build and run the test validation of APR.
+The Makefile.win make file has a bunch of documentation about it's
+options, but a trivial build is simply;
+
+  nmake -f Makefile.win 
+  nmake -f Makefile.win PREFIX=c:\desired\path\of\apr install
+
+Note you must manually modify the include\apr.hw file before you
+build to change default options, see the #define APR_HAS_... or the
+#define APR_HAVE_... statements.  Be careful, many of these aren't
+appropriate to be modified.  The most common change is 
+
+#define APR_HAVE_IPV6           1
+
+rather than 0 if this build of APR will be used strictly on machines
+with the IPv6 adapter support installed.
+
+It's trivial to include the apr.dsp (for a static library) or the
+libapr.dsp (for a dynamic library) in your own build project, or you
+can load apr.dsw in Visual Studio 2002 (.NET) or later, which will
+convert these for you into apr.sln and associated .vcproj files.
+
+When using APR as a dynamic library, nothing special is required,
+simply link to libapr.lib.  To use it as a static library, simply 
+define APR_DECLARE_STATIC before you include any apr header files 
+in your source, and link to apr.lib instead.
+
+
 Generating Test Coverage information with gcc
 =============================================