svn commit: r1870086 - /httpd/httpd/trunk/test/README.travis

[jo...@apache.org]

Author: jorton
Date: Thu Nov 21 13:00:47 2019
New Revision: 1870086

URL: http://svn.apache.org/viewvc?rev=1870086&view=rev
Log:
Doc updates for Travis.  [skip ci]

Modified:
    httpd/httpd/trunk/test/README.travis

Modified: httpd/httpd/trunk/test/README.travis
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/test/README.travis?rev=1870086&r1=1870085&r2=1870086&view=diff
==============================================================================
--- httpd/httpd/trunk/test/README.travis (original)
+++ httpd/httpd/trunk/test/README.travis Thu Nov 21 13:00:47 2019
@@ -4,14 +4,16 @@ Variables
 
 The Travis scripts use the following environment variables:
 
-* APR_VERSION - if set, APR of this version is built and installed
-  in $HOME/root/apr-$APR_VERSION (trunk means trunk is used)
+* APR_VERSION - if set, APR of this version is built and installed in
+  $HOME/root/apr-$APR_VERSION - a value of "trunk" means trunk is
+  used, "*.x" means a branch, otherwise a tagged version is implied.
 
 * APR_CONFIG - arguments to pass when running APR's configure script
   if APR_VERSION is set
 
 * APU_VERSION - if set, APR-util of this version is built and
-  installed in $HOME/root/apu-$APU_VERSION
+  installed in $HOME/root/apr-util-$APU_VERSION - a value of "*.x"
+  means a branch, otherwise a tagged version is implied.
 
 * APU_CONFIG - arguments to pass when running APR-util's configure
   script if APU_VERSION is set
@@ -49,3 +51,52 @@ TODO list
 * VPATH builds
 * sanity checks for use of APLOGNO() - empty arguments, accidental duplicates, etc.
  - not sure how exactly
+
+Testing from a Feature Branch
+-----------------------------
+
+An SVN branch off trunk should be mirrored to github, and will be
+tested in the same way that trunk is in Travis, so this workflow is
+available for those familiar with using Subversion and the standard
+ASF/httpd repository layout.
+
+Tested branches are listed at: https://travis-ci.org/apache/httpd/branches
+
+Travis will also run the tests for a PR filed against the httpd Github
+repository at https://github.com/apache/httpd or from a fork of this
+repository if enabled for the Travis user.
+
+A workflow to enable testing would be as follows, substituting
+$USERNAME for your github username:
+
+  $ git clone https://github.com/apache/httpd
+  $ cd httpd
+  $ git remote add $USERNAME git@github.com:$USERNAME/httpd.git
+  $ git checkout -b my-feature origin/trunk
+  ... do some work ...
+  $ git commit ...
+  $ git push -u $USERNAME my-feature:my-feature
+
+To enable testing for a fork, visit the settings page at
+https://travis-ci.org/$USERNAME/httpd/settings - you may need to sync
+your account via https://travis-ci.org/account/repositories for a
+freshly created fork.
+
+To create a Pull Request, go to a URL like:
+https://github.com/apache/httpd/compare/trunk...$USERNAME:trunk
+
+Once a PR has been created, travis will run the tests and link the
+results from a PR comment. All tested PRs are listed here:
+https://travis-ci.org/apache/httpd/pull_requests
+
+To merge from github back to SVN trunk, create a patch from e.g.:
+
+  $ git diff origin/trunk..my-feature
+
+and then apply it in SVN.  To rebase a feature once trunk has
+diverged, from a feature branch run:
+
+  $ git pull
+  $ git rebase -i origin/trunk
+
+and follow the standard rebase steps.

Re: svn commit: r1870086 - /httpd/httpd/trunk/test/README.travis

[Yann Ylavic <yl...@gmail.com>]

On Thu, Nov 21, 2019 at 2:00 PM <jo...@apache.org> wrote:
>
> +Testing from a Feature Branch
> +-----------------------------

Awesome Joe, thanks!