From 7ef12296b5b1ee0773790bcda996bbe5f9ffaf28 Mon Sep 17 00:00:00 2001 From: Yegor Kozlov Date: Mon, 21 Apr 2008 13:29:59 +0000 Subject: [PATCH] unfinished release guide. It would be nice to have a html version. git-svn-id: https://svn.apache.org/repos/asf/poi/trunk@650138 13f79535-47bb-0310-9956-ffa450edef68 --- .../content/xdocs/utils/release-guide.xml | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100755 src/documentation/content/xdocs/utils/release-guide.xml diff --git a/src/documentation/content/xdocs/utils/release-guide.xml b/src/documentation/content/xdocs/utils/release-guide.xml new file mode 100755 index 000000000..e8680c29b --- /dev/null +++ b/src/documentation/content/xdocs/utils/release-guide.xml @@ -0,0 +1,101 @@ + + + + + +
+ POI Release Guide + + + +
+ + +
+ POI Release Guide + +
Prerequisites + +
    +
  1. You should read the Apache Release FAQ
    2. +
  2. You must have shell access to people.apache.org
    3. +
  3. Release manager must have his public key appended to the KEYS file checked in to SVN and the key published on one of the public key servers. + More info can be found here: http://www.apache.org/dev/release-signing.html
    4. +
  4. You must have JDK 1.4 / 1.5
    5. +
  5. You must have the following utilities installed on your local machine and available in your path: +
      +
    • ssh
      • +
    • gnupg
      • +
    • openssl
      • +
    + For Windows users, install Cygwin and make sure you have the above components. +
    6. +
  6. The POI build system requires two components to perform a build +
      +
    • Ant
      • +
    • Forrest
      • +
    +
    7. +
+
+
Building Release Artifacts +
    +
  • Ensure the changelog is up to date
    • +
  • Tag SVN: +
    + svn cp https://svn.apache.org/repos/asf/poi/trunk \
    + https://svn.apache.org/repos/asf/poi/tags/REL_3_0_2_BETA1 \
    + -m "tag trunk as REL_3_0_2_BETA1" +
    • +
  • Update version.id in build.xml
    • +
  • Start a new section for the next release in xdocs/sites.xml and status.xml in the documentation/content/xdocs directory
    • +
  • Checkout the new tag:
    + + svn checkout https://svn.apache.org/repos/asf/poi/tags/REL_3_0_2_BETA1 + +
    • +
  • Merge if needed:
    + cd tags/REL_3_0_2_BETA1
    + svn merge https://svn.apache.org/repos/asf/poi/tags/REL_3_0_2_BETA1 \
    + https://svn.apache.org/repos/asf/poi/trunk +
    • +
  • Build as if the vote had passed.
    + Typically a release vote lasts 7 days so the filename dates should be +7 days from current date.
    + cd tags/REL_3_0_2_BETA1
    + Main distribution:
    + ant dist
    + Maven artifacts:
    + ant maven-dist +
    • +
  • Create MD5 checksums for all artifacts to be published:
    + openssl md5 < file > file.md5
    +
    • +
  • Signing all artifacts to be published:
    + gpg --armor --output file.asc --detach-sig $file;
    + Verify signatures: + gpg --verify file.asc file
    +
    • +
  • Upload to your area at people.apache.org
    • +
+
+ +
+ +