From: Joe Orton <jorton@apache.org>
Date: Mon, 23 Nov 2020 10:50:26 +0000 (+0000)
Subject: Add a note on APR/APR-util caching. [skip ci]
X-Git-Tag: 2.5.0-alpha2-ci-test-only~1130
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7594af85fefb95f6996518e4d747323c54d37aee;p=thirdparty%2Fapache%2Fhttpd.git

Add a note on APR/APR-util caching. [skip ci]


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

diff --git a/test/README.travis b/test/README.travis
index 5d41e120e70..575bed4d8c9 100644
--- a/test/README.travis
+++ b/test/README.travis
@@ -44,6 +44,8 @@ The Travis scripts use the following environment variables:
 
 * TEST_ARGS - arguments to pass to ./t/TEST in the Perl test framework
 
+* CLEAR_CACHE - if set, the cached $HOME/root is removed before each build
+
 Caching
 -------
 
@@ -53,6 +55,15 @@ Anything installed into the $HOME/root directory is cached - notably,
 versions of APR/APR-util are installed here and cached across httpd
 build jobs without needing to be rebuilt every time.
 
+The cached installs of APR/APR-util are refreshed if the
+last-changed-revision of the build is stale.
+
+If APR_VERSION and APU_VERSION are both set to 1.x versions, then
+CLEAR_CACHE should also be set to disable APR* caching.  APR-util can
+only be rebuilt if an APR checkout is present, so a APR-util cannot be
+built from source alone.  (i.e. the scripts do not handle the case of
+cached, fresh APR plus a cached but stale APR-util)
+
 TODO list
 ---------