antoine 2003/09/30 06:08:00
Modified: . ReleaseInstructions
Log:
Merge from ANT_16_BRANCH
Revision Changes Path
1.20 +30 -30 ant/ReleaseInstructions
Index: ReleaseInstructions
===================================================================
RCS file: /home/cvs/ant/ReleaseInstructions,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -r1.19 -r1.20
--- ReleaseInstructions 30 Sep 2003 13:01:32 -0000 1.19
+++ ReleaseInstructions 30 Sep 2003 13:08:00 -0000 1.20
@@ -9,33 +9,33 @@
your context.
1. Propose a release plan for vote. This should set out the timetable for
- the release under ideal circumstances. The level of bugs reported
- can delay things. Generally, give a few weeks to "close" the source tree
+ the release under ideal circumstances. The level of bugs reported
+ can delay things. Generally, give a few weeks to "close" the source tree
to further changes so people can finalise contributions, etc. At this
time,
the first beta will be cut and there will be then a period of beta
testing,
usually 1 month but this should be flexible.
2. Note that any mention of a deadline causes a flood of bug fixes, new
tasks,
- etc. This needs to be managed as best it can. Some fixes will be
applied,
- others held over. Make this clear in the release plan. The committers
and
- particularly the release manager will need to make judgement calls here.
+ etc. This needs to be managed as best it can. Some fixes will be
applied,
+ others held over. Make this clear in the release plan. The committers and
+ particularly the release manager will need to make judgement calls here.
Anything too "big" is likely to be held over.
-
-3. Once the freeze date arrives, create a branch for the release builds.
You
- will need to be comfortable in handling CVS branches with mutliple
- merge-backs to the main branch and even selected merges from the the
main
- branch to the release branch.
-
+
+3. Once the freeze date arrives, create a branch for the release builds. You
+ will need to be comfortable in handling CVS branches with mutliple
+ merge-backs to the main branch and even selected merges from the the main
+ branch to the release branch.
+
For more information on performing branching and merging, please visit
http://www.durak.org/cvswebsites/doc/cvs_54.php#SEC54
Label such branches ANT_16_BRANCH.
-
-4. Once the branch is setup, the version numbers in CVS are changed. On the
+
+4. Once the branch is setup, the version numbers in CVS are changed. On the
branch, the version property in build.xml becomes 1.6Beta,
while the main branch is updated to 1.7alpha.
-
- [[ TODO: Check if the documentation files also need to be updated to
point
+
+ [[ TODO: Check if the documentation files also need to be updated to
point
to the right areas of Ant's website. ]]
5. Before a build :
@@ -45,20 +45,20 @@
* docs/manual/credits.html
* build.xml (version property)
- the first beta on the 1.6 branch should be calle 1.6Beta1, ...
+ the first beta on the 1.6 branch should be called 1.6Beta1, ...
the version property in build.xml governs the output of ant -version and
the naming of the distribution files.
6. Ensure you have all the external libraries that Ant uses in your
lib/optional directory. To find out what libraries you need, execute
- the build with -verbose option and scan for lines beginning with
+ the build with -verbose option and scan for lines beginning with
"Unable to load...".
7. Next bootstrap, build and run the tests. Then build the distribution
- on the branch. It is important that this be a clean build. Label this
with
+ on the branch. It is important that this be a clean build. Label this
with
a tag ANT_16_B1.
-
+
8. Sign the distribution files using the following simple script
#!/bin/sh
for i in distribution/*
@@ -73,13 +73,13 @@
Before you do that, ensure that the key you use is inside the KEYS
file in Ant's CVS repository - and that you perform a cvs update on
the KEYS file in /www/www.apache.org/dist/ant/
-
- Also make sure you have sent the key that you use to a public
+
+ Also make sure you have sent the key that you use to a public
keyserver.
9. The beta distribution is now ready to go. Bundle it up into a tar.gz file
and scp to your apache account.
-
+
10. Meanwhile, convert the part of the WHATSNEW file covering the changes
since the last release into HTML for the README file on the
website. See the previous release directories for examples of these
files.
@@ -87,7 +87,7 @@
You may choose to use the text2html convertor present at
http://www.aigeek.com/txt2html/
-
+
Name the generated file RELEASE-NOTES-x.y.z.html.
[[ TODO: This must perhaps be an Ant task. ]]
@@ -102,18 +102,18 @@
12. Address the available release tags in BugZilla. Create a new tag 1.6Beta1
and a 1.7Alpha. Assign all existing 1.6 alpha bugs to one of these
release
labels.
-
+
13. Once that is done, do a test download to make sure everything is OK. A
common problem may be:
- * the file's mime type is not recognized and is interpreted as
+ * the file's mime type is not recognized and is interpreted as
text/plain. Fix it by using some .htaccess magic (AddEncoding stuff)
* Your gz.asc files are not being displayed properly (RemoveEncoing
stuff)
-
+
If it looks OK, announce it on [EMAIL PROTECTED] and [EMAIL PROTECTED]
After a few
days pass and there are no major problems, a wider announcement is
made (ant website, main jakarta website,
announcements@jakarta.apache.org,
etc).
-
+
Also ensure you:
* Update antnews.xml (Announcement)
* Update faq.xml (Ant's history details - not for betas)
@@ -135,8 +135,8 @@
15. Try to advertise the need for testing of the betas as much as possible.
This would eliminate the need to release minor patch versions like
- we had to do when releasing Ant 1.4.
-
+ we had to do when releasing Ant 1.4.
+
To monitor the number of downloads, look at the access_log
file under /usr/local/apache2/logs
@@ -150,7 +150,7 @@
This time the directory you upload the files to is different and
you'll have to do some house-keeping for the old release:
- * upload the new release files to
+ * upload the new release files to
/www/www.apache.org/dist/ant/[source|binary].
* remove the symbolic links from /www/www.apache.org/dist/ant.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
