5661c4df7a
git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@542593 13f79535-47bb-0310-9956-ffa450edef68
116 lines
4.2 KiB
XML
116 lines
4.2 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<!--
|
|
====================================================================
|
|
Licensed to the Apache Software Foundation (ASF) under one or more
|
|
contributor license agreements. See the NOTICE file distributed with
|
|
this work for additional information regarding copyright ownership.
|
|
The ASF licenses this file to You under the Apache License, Version 2.0
|
|
(the "License"); you may not use this file except in compliance with
|
|
the License. You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
====================================================================
|
|
-->
|
|
<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd">
|
|
|
|
<document>
|
|
|
|
<header>
|
|
<title>Branching</title>
|
|
<authors>
|
|
<person id="GJS" name="Glen Stampoultzis" email="user@poi.apache.org"/>
|
|
</authors>
|
|
</header>
|
|
|
|
<body>
|
|
<section><title>Branching Conventions</title>
|
|
<p>
|
|
Branches are tagged in the following way:
|
|
</p>
|
|
<ul>
|
|
<li>REL_1_5_BRANCH</li>
|
|
<li>REL_2_0_BRANCH</li>
|
|
</ul>
|
|
<p>
|
|
Merge points should be tagged as follows:
|
|
</p>
|
|
<ul>
|
|
<li>REL_1_5_BRANCH_MERGE1</li>
|
|
<li>REL_1_5_BRANCH_MERGE2</li>
|
|
<li>etc...</li>
|
|
</ul>
|
|
<p>
|
|
Releases should be tagged as:
|
|
</p>
|
|
<ul>
|
|
<li>REL_1_5</li>
|
|
<li>REL_1_5_1</li>
|
|
<li>REL_1_5_2</li>
|
|
<li>etc...</li>
|
|
</ul>
|
|
|
|
</section>
|
|
<section><title>Branching Advise</title>
|
|
<p>
|
|
Don't forget which branch you are currently on. This is critically
|
|
important. Committing stuff to the wrong branch causes all sorts of
|
|
headaches. Best to name your checkout after the branch you are on.
|
|
</p>
|
|
</section>
|
|
<section><title>Who Manages Branching?</title>
|
|
<p>
|
|
All branching is currently managed by Glen Stampoultzis. If you wish
|
|
to create your own branch please let him know. Merging is also
|
|
handled by Glen. Just pop him a mail if you feel it's necessary to
|
|
create a branch or perform a merge.
|
|
</p>
|
|
<p>
|
|
The reason to go through a single point for branching is that it can be
|
|
an easy thing to get wrong. Having a single person managing branches
|
|
means there is less chance of getting getting our wires crossed with this
|
|
difficult area of CVS.
|
|
</p>
|
|
</section>
|
|
<section><title>Currently Active Branches</title>
|
|
<p>
|
|
The following branches are currently active:
|
|
</p>
|
|
<table>
|
|
<tr>
|
|
<th>
|
|
Branch
|
|
</th>
|
|
<th>
|
|
Description
|
|
</th>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
HEAD
|
|
</td>
|
|
<td>
|
|
This is the trunk and is always active. Currently it is being used to continue development
|
|
of the 2.0 release.
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td>
|
|
REL_1_5_BRANCH
|
|
</td>
|
|
<td>
|
|
All bug fixes not specifically relevant to the 2.0 work should be placed in this branch.
|
|
From here they will merged back to the trunk and the merge point marked.
|
|
</td>
|
|
</tr>
|
|
</table>
|
|
</section>
|
|
</body>
|
|
|
|
</document>
|