[PATCH] Document move to apr 1.2 in INSTALL

[Mark Phippard]
> So if Red Hat 6 ships with Apache 2.2 and builds Subversion
> accordingly should we be hiring lawyers to block their release
> because they are breaking our compatibility warranty? How far should
> we go with this?

Thanks to your liberal licensing, what other people do is pretty much
not your concern. The -deps tarball isn't someone else's decision,
though, it is an integral part of your own release process. If that
tarball is something you really only recommend in peculiar
circumstances (I'm fine with that, I don't use it myself), I think it's
best to actually say so.

> I thought the dependencies file was a convenience for people to grab
> the dependencies. 99.9% of whom could give a shit about ABI.

How about this patch, then? Note, I don't know anything about Windows
build issues, so I thought I should leave that one paragraph for
somebody else to fill in.

-- 
Peter Samuelson | org-tld!p12n!peter | http://p12n.org/
[[[
* INSTALL: update to document the move to apr 1.2.
Patch by: Peter Samuelson <peter_at_p12n.org>
]]]
Index: INSTALL
===================================================================
--- INSTALL	(revisione 30118)
+++ INSTALL	(copia locale)
@@ -202,26 +202,26 @@
         |                                                              |
         |   - if you are already using Subversion with APR 0.9.X, and  |
         |     then upgrade your libapr to 1.X without rebuilding       |
-        |     Subversion, things will break and segfault.              |
+        |     Subversion and third-party Subversion apps, things will  |
+        |     break and segfault.                                      |
         |                                                              |
         |   - if your Subversion server libraries are linked to one    | 
         |     version of APR, but your Apache server is linked to a    | 
         |     different version, things will break and segfault.       |
         |                                                              |
-        | Subversion 1.0 originally shipped with APR 0.9.  Even        |
-        | though APR 1.X has been available for many years, we         |
-        | continue to ship APR 0.9 so as not to accidentally break     |
-        | binary compatibility in Subversion upgrades.                 |
+        | Subversion 1.0 through 1.4 shipped with APR 0.9; we          |
+        | switched to APR 1.2 in Subversion 1.5.  Thus if you use our  |
+        | "subversion-deps" tarball, an upgrade to Subversion 1.5 is   |
+        | not binary compatible.  We recommend the "subversion-deps"   |
+        | tarball only for new installs; for upgrades, you should use  |
+        | the same library versions you used for the previous build,   |
+        | unless you are prepared to recompile any third-party         |
+        | Subversion applications as well.                             |
         |                                                              |
-        | However, it's *perfectly* safe to use APR 1.X from the       |
-        | beginning.  In fact, we recommend it.  If you're building    |
-        | Subversion for the first time, there's no compatibility      |
-        | issue to worry about, so grab the latest version of APR      |
-        | (rather than the 0.9.X version we distribute.)               |
-        |                                                              |
         | If you already have a Subversion installation using APR      |
         | 0.9.x, it's still possible to move to APR 1.X safely.  Just  |
-        | be sure to recompile Subversion after upgrading APR!         |
+        | be sure to recompile Subversion and your third-party         |
+        | Subversion applications after upgrading APR!                 |
         |______________________________________________________________|
 
 
@@ -785,6 +785,7 @@
         for building the client components.  Neon is included in the zip file
         distribution.  (0.25.0+ compiles, but does not properly support all
         HTTP auth types.)
+      * FIXME: next paragraph is out of date.
       * Apache apr, apr-util, and apr-iconv libraries, version 0.9.12.
         Included in both the Subversion dependencies ZIP file and the
         Apache 2.058 source zip.  If you are building from a Subversion
@@ -804,12 +805,8 @@
 
       * [Optional] Apache 2 source, downloaded from
         http://httpd.apache.org/download.cgi, these instructions assume
-        version 2.0.58.  This is only needed for building the Subversion
-        server Apache modules.  Note that although Subversion will compile
-        against Apache 2.2.3 and APR 1.2.7, there is a bug that causes
-        runtime failures with Subversion on Windows.  The fix is included in
-        APR 1.2.8 and will be bundled in the next HTTP Server release
-        (likely to be 2.2.4).
+        version 2.2.8.  This is only needed for building the Subversion
+        server Apache modules.
       * [Optional] Apache 2 msi install file, also from
         http://httpd.apache.org/download.cgi (required for running the
         tests).  Only needed for testing the server dso modules and if
@@ -983,12 +980,12 @@
       Apache and Subversion will be running incompatible versions of apr.
 
       C:>cd src-%DIR%
-      C:>python gen-make.py -t dsp --with-httpd=..\httpd-2.0.58
+      C:>python gen-make.py -t dsp --with-httpd=..\httpd-2.2.8
          --with-berkeley-db=db4-win32 --with-openssl=..\openssl-0.9.7f
          --with-zlib=..\zlib --with-libintl=..\svn-win32-libintl
       C:>cd ..
       C:>set APACHEDIR=C:\Program Files\Apache Group\Apache2
-      C:>msdev httpd-2.0.58\apache.dsw /MAKE "BuildBin - Win32 Release"
+      C:>msdev httpd-2.2.8\apache.dsw /MAKE "BuildBin - Win32 Release"
 
       Subversion
 
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe_at_subversion.tigris.org
For additional commands, e-mail: dev-help_at_subversion.tigris.org