Browse Source

Merge from ANT_16_BRANCH

git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@275395 13f79535-47bb-0310-9956-ffa450edef68
master
Antoine Levy-Lambert 21 years ago
parent
commit
507bd35938
1 changed files with 30 additions and 30 deletions
  1. +30
    -30
      ReleaseInstructions

+ 30
- 30
ReleaseInstructions View File

@@ -9,33 +9,33 @@ Note: This document was updated in the context of releasing Ant 1.6.
your context. your context.


1. Propose a release plan for vote. This should set out the timetable for 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, 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, the first beta will be cut and there will be then a period of beta testing,
usually 1 month but this should be flexible. usually 1 month but this should be flexible.


2. Note that any mention of a deadline causes a flood of bug fixes, new tasks, 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. 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 For more information on performing branching and merging, please visit
http://www.durak.org/cvswebsites/doc/cvs_54.php#SEC54 http://www.durak.org/cvswebsites/doc/cvs_54.php#SEC54


Label such branches ANT_16_BRANCH. 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, branch, the version property in build.xml becomes 1.6Beta,
while the main branch is updated to 1.7alpha. 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. ]] to the right areas of Ant's website. ]]


5. Before a build : 5. Before a build :
@@ -45,20 +45,20 @@ Note: This document was updated in the context of releasing Ant 1.6.
* docs/manual/credits.html * docs/manual/credits.html
* build.xml (version property) * 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 version property in build.xml governs the output of ant -version and
the naming of the distribution files. the naming of the distribution files.


6. Ensure you have all the external libraries that Ant uses in your 6. Ensure you have all the external libraries that Ant uses in your
lib/optional directory. To find out what libraries you need, execute 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...". "Unable to load...".


7. Next bootstrap, build and run the tests. Then build the distribution 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. a tag ANT_16_B1.
8. Sign the distribution files using the following simple script 8. Sign the distribution files using the following simple script
#!/bin/sh #!/bin/sh
for i in distribution/* for i in distribution/*
@@ -73,13 +73,13 @@ Note: This document was updated in the context of releasing Ant 1.6.
Before you do that, ensure that the key you use is inside the KEYS 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 file in Ant's CVS repository - and that you perform a cvs update on
the KEYS file in /www/www.apache.org/dist/ant/ 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. keyserver.


9. The beta distribution is now ready to go. Bundle it up into a tar.gz file 9. The beta distribution is now ready to go. Bundle it up into a tar.gz file
and scp to your apache account. and scp to your apache account.
10. Meanwhile, convert the part of the WHATSNEW file covering the changes 10. Meanwhile, convert the part of the WHATSNEW file covering the changes
since the last release into HTML for the README file on the since the last release into HTML for the README file on the
website. See the previous release directories for examples of these files. website. See the previous release directories for examples of these files.
@@ -87,7 +87,7 @@ Note: This document was updated in the context of releasing Ant 1.6.


You may choose to use the text2html convertor present at You may choose to use the text2html convertor present at
http://www.aigeek.com/txt2html/ http://www.aigeek.com/txt2html/
Name the generated file RELEASE-NOTES-x.y.z.html. Name the generated file RELEASE-NOTES-x.y.z.html.


[[ TODO: This must perhaps be an Ant task. ]] [[ TODO: This must perhaps be an Ant task. ]]
@@ -102,18 +102,18 @@ Note: This document was updated in the context of releasing Ant 1.6.
12. Address the available release tags in BugZilla. Create a new tag 1.6Beta1 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 and a 1.7Alpha. Assign all existing 1.6 alpha bugs to one of these release
labels. labels.
13. Once that is done, do a test download to make sure everything is OK. A 13. Once that is done, do a test download to make sure everything is OK. A
common problem may be: 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) text/plain. Fix it by using some .htaccess magic (AddEncoding stuff)
* Your gz.asc files are not being displayed properly (RemoveEncoing stuff) * Your gz.asc files are not being displayed properly (RemoveEncoing stuff)
If it looks OK, announce it on dev@ant and user@ant. After a few If it looks OK, announce it on dev@ant and user@ant. After a few
days pass and there are no major problems, a wider announcement is days pass and there are no major problems, a wider announcement is
made (ant website, main jakarta website, announcements@jakarta.apache.org, made (ant website, main jakarta website, announcements@jakarta.apache.org,
etc). etc).
Also ensure you: Also ensure you:
* Update antnews.xml (Announcement) * Update antnews.xml (Announcement)
* Update faq.xml (Ant's history details - not for betas) * Update faq.xml (Ant's history details - not for betas)
@@ -135,8 +135,8 @@ Note: This document was updated in the context of releasing Ant 1.6.


15. Try to advertise the need for testing of the betas as much as possible. 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 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 To monitor the number of downloads, look at the access_log
file under /usr/local/apache2/logs file under /usr/local/apache2/logs


@@ -150,7 +150,7 @@ Note: This document was updated in the context of releasing Ant 1.6.
This time the directory you upload the files to is different and This time the directory you upload the files to is different and
you'll have to do some house-keeping for the old release: 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]. /www/www.apache.org/dist/ant/[source|binary].


* remove the symbolic links from /www/www.apache.org/dist/ant. * remove the symbolic links from /www/www.apache.org/dist/ant.


Loading…
Cancel
Save