This is an automated email from the ASF dual-hosted git repository.

csutherl pushed a commit to branch master
in repository

The following commit(s) were added to refs/heads/master by this push:
     new f1cc7fc  Update BUILDING and CONTRIBUTING docs after the svn->git 
     new 5e28428  Merge pull request #141 from csutherl/master
f1cc7fc is described below

commit f1cc7fcefa844b13622812e9fd875b18f68b0df7
Author: Coty Sutherland <>
AuthorDate: Fri Mar 1 13:50:03 2019 -0500

    Update BUILDING and CONTRIBUTING docs after the svn->git migration
 BUILDING.txt    | 10 +++++----- | 47 ++++++++++++++++++-----------------------------
 2 files changed, 23 insertions(+), 34 deletions(-)

diff --git a/BUILDING.txt b/BUILDING.txt
index 77fd6c8..331184a 100644
--- a/BUILDING.txt
+++ b/BUILDING.txt
@@ -93,13 +93,13 @@ source distribution, do the following:
 (3.1) Checkout or obtain the source code for Tomcat @VERSION_MAJOR_MINOR@
-Checkout the source using SVN, selecting a tag for released version or
-trunk for the current development code, or download and unpack a source
+Clone the source using git, then checkout a specific major branch or
+master for the latest code development, or download and unpack a source
- *  Tomcat SVN repository URL:
+ *  Tomcat GitHub repository URL:
  *  Source packages can be downloaded from:
@@ -184,7 +184,7 @@ each release package has the appropriate line-endings.
 (4) Updating sources and rebuilding
 It is recommended that you regularly update the downloaded Tomcat 
-sources using your SVN client.
+sources using your git client.
 For a quick rebuild of only modified code you can use:
diff --git a/ b/
index a13c5c9..74eac26 100644
--- a/
+++ b/
@@ -1,7 +1,7 @@
 # Contributing to Apache Tomcat
 Firstly, thanks for your interest in contributing! I hope that this will be a
-pleasant first experience for you, and that you will return to continue
+pleasant experience for you, and that you will return to continue
 Please visit our [Get Involved 
@@ -38,12 +38,12 @@ the issues marked 'Beginner', link below. Please note that 
the Beginner keyword
 is pretty new to the project, so if there aren't any issues in the filter feel
 free to ask on the [dev list](
-* [Beginner 
+* [Beginner 
 issues which should only require a few lines of code, and a test or two to
 The list above shows all bugs that are marked 'Beginner' and are open in the
-currently supported Tomcat versions (7, 8, and 9).
+currently supported Tomcat versions (7, 8.5, and 9).
 If you prefer C over Java, you may also take a look at the tomcat-native and
 Tomcat Connectors products in Bugzilla.
@@ -57,11 +57,8 @@ committers of the project for review and acceptance.
 You can provide a patch in one of the following ways (in order of preference):
+* GitHub Pull Request
 * Patch attachment to the Bugzilla issue
-* Github Pull Request
-> **Note:** Github is a mirror of the SVN repository that Tomcat is stored in
-and therefore it can't be merged outright. Your contribution will be converted
-into an SVN patch and committed with a mention of your name for credit.
 * Email the patch to the developer list. This is not preferred, but if no bug
 is associated with the patch, or you would like a developer review, an email
 may be appropriate.
@@ -73,51 +70,43 @@ source code.
 ###### Download The Source Distribution
-This method works if you want to submit a patch (like you would do for SVN), 
+This method works if you want to submit a patch via email, but
 the difference in using the sources distribution and a VCS is that you have to
 manually generate the patch file by using diff. If this is what you want, you
 can download the sources from the "Source Code Distributions" section of the
 Download Page. There is one such page for every major Tomcat version:
 - [Tomcat 9](
 - [Tomcat 8](
 - [Tomcat 7](
-###### SVN
+##### Manual Patch Generation
 If you have chosen to attach a patch to the Bugzilla issue (or email
-one), then you'll need to checkout the SVN version. Instructions for new
-committers to learn how to do this are found
-[here]( However, in the
-interest of a fast ramp up, the short version is below. Note that the root of
-the SVN repository is
-but you can clone specific versions too, such as
-[tc8.5.x]( or even tags 
+one), then you'll need to download the sources as noted above, make your
+desired changes and then manually generate your patch using diff (other 
+other tool).
-$ svn co
+##### GitHub
-##### Github
-For Github, it's almost the same. Chose the major version that you want (for
-now they're in different repositories), fork the repository, and then clone
-your fork to do that work.
+To submit a GitHub Pull Request you'll need to fork the
+[repository](, clone your fork to do the work:
 $ git clone$USERNAME/tomcat.git
+and then push your changes, and submit a Pull Request via the GitHub UI.
 #### Submitting Your Patch!
 After you've chosen your method of submission, retrieved the sources, and
 fixed the issue it's time to submit your work. At this point, just follow
 the method of submission you chose earlier.
-* Bugzilla attachment - attach the SVN patch to the Bugzilla issue
-* Github PR - after resolving the issue in your local fork and pushing to your
-copy of the repository, open a Github PR for review.
+* GitHub PR - after resolving the issue in your local fork and pushing to your
+copy of the repository, open a GitHub PR for review.
+* Bugzilla attachment - attach the patch to the Bugzilla issue
 * Email - again, not preferred, but you may send an email to the developer list
 with a patch attached for review.

To unsubscribe, e-mail:
For additional commands, e-mail:

Reply via email to