hc-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Apache Wiki <wikidi...@apache.org>
Subject [Jakarta-httpclient Wiki] Update of "HttpClientReleaseProcess" by MichaelBecke
Date Sun, 07 May 2006 14:18:01 GMT
Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Jakarta-httpclient Wiki" for change
notification.

The following page has been changed by MichaelBecke:
http://wiki.apache.org/jakarta-httpclient/HttpClientReleaseProcess

------------------------------------------------------------------------------
- The following steps are required to create and deploy a release version of a Commons library
package. The example text consistently assumes that we are releasing version 2.0 of the httpclient
 package.
+ The following steps are required to create and deploy a release version of a Commons library
package. The example text consistently assumes that we are releasing version 3.0.1 of the
httpclient  package.
  
-    1. Announce your proposed release of a particular package to the commons-httpclient-dev@jakarta.apache.org
mailing list, and ask for a vote. Per the Commons Project charter, votes of committers on
the particular package in question (as listed in the project.xml file) are binding.
+ == Pre Release ==
  
-    1. Check out and thoroughly test the package code that you plan to release.
+    * Announce your proposed release of a particular package to the httpclient-dev@jakarta.apache.org
mailing list, and ask for a vote. Per the Jakarta Project charter, votes of committers on
the particular package in question (as listed in the project.xml file) are binding.
  
-    1. Update release_notes.txt. This file should be updated in CVS when patches are committed,
but it is frequently not. Be sure all relevant changes since the last release are included.
This file should be published along with the release source and binary distributions.
+    * Assuming the vote is successful send an email to httpclient-dev@jakarta.apache.org
and pmc@jakarta.apache.org with the outcome of the vote.  Something like the following:
+ {{{
+ Subject: [VOTE][RESULT] Commons HttpClient 3.0.1 released
  
-    1. Update the project version number in the build.xml, project.xml, status.xml, downloads.xml,
and the HttpMethodBase useragent string. There is an Ant property named component.version
that would be updated to 2.0. Check in any files you have modified.
+ The vote to release Commons HttpClient 3.0.1 has passed with
+ the following results
  
-    1. In your local repository (or on cvs.apache.org) tag only the files in the subdirectory
for this package with the package name (in caps) and version number for the package you are
creating. For example,
+ +1
  
-                   cd $JAKARTA_COMMONS_HOME/httpclient
-                   cvs tag HTTPCLIENT_2_0_BETA1
+ Michael Becke <mbecke -at- apache.org>
+ Ortwin Gl├╝ck <oglueck -at- apache.org>
+ Oleg Kalnichevski <olegk -at- apache.org>
+ Roland Weber <rolandw -at- apache.org>
+ 
+ ---
+ Original thread:
+ http://www.mail-archive.com/httpclient-dev%40jakarta.apache.org/msg03653.html
+ }}}
+ 
+ == Building the Release ==
+ 
+ === Documentation ===
+ 
+    * Update release_notes.txt - This file should be updated when patches are committed,
but sometimes is not. Be sure all relevant changes since the last release are included. This
file should be published along with the release source and binary distributions.  
+ 
+    * Update the project version number.
+     * build.xml - change the property '''component.version'''
+     * project.xml - change '''<currentVersion/>''' and add a '''<version/>'''
element
+     * src/java/org/apache/commons/httpclient/params/DefaultHttpParamsFactory.java - update
the useragent string
+ 
+    * Update project site documentation.
+     * xdocs/status.xml - change the current status text, the link to next release bugs,
and the release info link
+     * xdocs/downloads.xml - change the release number and date and the Maven dependency
xml
+     * xdocs/news.xml - add a news item for the release.  This can be reused in the announcement
email and the Jakarta site news.
+ 
+    * Generate the HttpClient site locally and validate. 
+     `maven site:generate`
+    * Checkin all changes.
+     `svn commit -m 'Changes for 3.0.1 release'`
+ 
+ === Release Package ===
+ 
+    * Tag the code in SVN.
+     {{{svn copy -m "HttpClient release 3.0.1" 
+ https://svn.apache.org/repos/asf/jakarta/commons/proper/httpclient/branches/HTTPCLIENT_3_0_BRANCH
https://svn.apache.org/repos/asf/jakarta/commons/proper/httpclient/tags/HTTPCLIENT_3_0_1}}}
+    * Make sure you running a 1.3 JVM.  This is necessary to ensure that the generated binaries
are 1.3 compatable.
+    * Generate the binary packages.
+     `maven httpclient:dist`
                  
+ 
+ '''The following section is in progress'''
  
     1. Regenerate the binary distribution of the code by running maven dist. Ensure that
you use the lowest reasonable jdk to do the build, 1.2.2. Review the generated documentation
to ensure that it correctly reflects the functionality (and the version number) of this code.
  
@@ -65, +107 @@

                              cvs update index.html site
                          
  
-   1. Update components.xml in the jakarta-commons/xdocs CVS and then build the docs by running
ant (this may require some configuration). CVS commit, then if you have an account on daedalus,
update the commons website with a cvs udpate in /www/jakarta.apache.org/commons.
-   1. Announce the availability of the new package on the following mailing lists:
+   * Announce the availability of the new package on the following mailing lists:
            * announcements@jakarta.apache.org
            * commons-dev@jakarta.apache.org
            * commons-user@jakarta.apache.org
            * commons-httpclient-dev@jakarta.apache.org
  
-   1. Check in bugzilla for all bugs which have been marked LATER and update their status
appropriately. If you need to have some changes made to bugzilla you can contact mvdb@apache.org
- 
-   1. Deploy the jar file to the ibiblio repository.
+   * Deploy the jar file to the ibiblio repository.
  
                    maven jar:deploy
                  

---------------------------------------------------------------------
To unsubscribe, e-mail: httpclient-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: httpclient-dev-help@jakarta.apache.org


Mime
View raw message