From 10b2e8062fbccdc23566024dc6902be5a0c32cd7 Mon Sep 17 00:00:00 2001 From: Antoine Levy-Lambert Date: Sat, 20 Dec 2003 16:19:00 +0000 Subject: [PATCH] The ant 1.6.0 distribution includes 5 documents which still refer to the beta, most notably the index.html at the root of the docs directory. Let's try to put the ReleaseInstructions in an order such that we do not have this type of problems in the future. PR: 25652 git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@275827 13f79535-47bb-0310-9956-ffa450edef68 --- ReleaseInstructions | 58 +++++++++++++++++++++++++++++---------------- 1 file changed, 38 insertions(+), 20 deletions(-) diff --git a/ReleaseInstructions b/ReleaseInstructions index a9ed058de..e10967790 100644 --- a/ReleaseInstructions +++ b/ReleaseInstructions @@ -39,17 +39,35 @@ Note: This document was updated in the context of releasing Ant 1.6. to the right areas of Ant's website. ]] 5. Before a build : - Update the following files for version number, and commit your changes. - - * docs/manual/cover.html - * docs/manual/credits.html - * build.xml (version property) 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. + Update the following files for version number: + + On the branch only : + + * docs/manual/cover.html + * docs/manual/credits.html + * build.xml (version property & manifest-version property) + + Commit your changes. + + On the branch and on the main trunk (*): + + * xdocs/antnews.xml (Announcement) + * xdocs/faq.xml (Ant's history details - not for betas) + * xdocs/index.xml (Announcement, latest release details, link to + manual under "Documentation") + * xdocs/srcdownload.xml + * xdocs/bindownload.xml + + Generate the html files by invoking ant on docs.xml - you need + jakarta-site2 checked out for this. Commit the modified/generated + 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 @@ -101,7 +119,9 @@ 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 and a 1.7Alpha. Assign all existing 1.6 alpha bugs to one of these release - labels. + labels. Note that such massive changes can be done at once by choosing the + link "Change several bugs at once" at the bottom of the bug list + displaying the 1.6alpha bugs. 13. Once that is done, do a test download to make sure everything is OK. A common problem may be: @@ -114,15 +134,7 @@ Note: This document was updated in the context of releasing Ant 1.6. 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) - * Update index.xml (Announcement, latest release details, link to - manual under "Documentation") - - Generate the html files by invoking ant on docs.xml - you need - jakarta-site2 checked out for this. Commit the modified/generated - files and also perform a cvs update on files in minotaur's + and also perform a cvs update on files in minotaur's /www/ant.apache.org/ Announce beta releases at freshmeat.net (Stefan Bodewig is the @@ -160,12 +172,13 @@ Note: This document was updated in the context of releasing Ant 1.6. * Make sure that the symbolic link README.html points to the new RELEASE-NOTES. -18. Change the links in /xdocs/bindownload.xml and /xdocs/srcdownload.xml, - regenerate the HTML files, commit and update the site. +18. Update the ant.apache.org site : + + running cvs update *.html under /www/ant.apache.org should update the + files regenerated and committed in point 5 above (index.html, faq.html, + antnews.html, srcdownload.html, bindownload.html). - As the mirrors may need some days to pick up the new release, you - may want to add a note to that effect to the pages and remove it a few - days later. + Update the online manual too. 19. Clean up. @@ -197,3 +210,8 @@ Note: This document was updated in the context of releasing Ant 1.6. 22. You can now reacquaint yourself with your family and friends. +(*) the xdocs need to be updated on both the branch and the HEAD revision + because traditionally the ant.apache.org web site reflects the HEAD + revisio of the xdocs, but the users downloading a distribution will get + the xdocs and the generated html from the branch and will complain if there + are discrepancies in version numbers. \ No newline at end of file