aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorWilliam Victor Mote <vmote@apache.org>2003-06-14 05:41:18 +0000
committerWilliam Victor Mote <vmote@apache.org>2003-06-14 05:41:18 +0000
commitcbe508833d226377bd9eedf018a11c4eb9e84e57 (patch)
tree6e68097499e6753e3ee8d19f07b4bd1bf7ee61fb
parentd6548e7605d3fd3cf6c02a6af408f9ef24435697 (diff)
downloadxmlgraphics-fop-cbe508833d226377bd9eedf018a11c4eb9e84e57.tar.gz
xmlgraphics-fop-cbe508833d226377bd9eedf018a11c4eb9e84e57.zip
Add release notes (from Christian Geisert's notes).
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196499 13f79535-47bb-0310-9956-ffa450edef68
-rw-r--r--src/documentation/content/xdocs/dev/book.xml1
-rw-r--r--src/documentation/content/xdocs/dev/release.xml59
2 files changed, 60 insertions, 0 deletions
diff --git a/src/documentation/content/xdocs/dev/book.xml b/src/documentation/content/xdocs/dev/book.xml
index be3f1829d..10322781a 100644
--- a/src/documentation/content/xdocs/dev/book.xml
+++ b/src/documentation/content/xdocs/dev/book.xml
@@ -27,6 +27,7 @@
</menu>
<menu label="Deploy">
<menu-item label="Doc Mgmt" href="doc.html"/>
+ <menu-item label="Release" href="release.html"/>
<external label="Bugs" href="http://nagoya.apache.org/bugzilla/buglist.cgi?bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED&amp;email1=&amp;emailtype1=substring&amp;emailassigned_to1=1&amp;email2=&amp;emailtype2=substring&amp;emailreporter2=1&amp;bugidtype=include&amp;bug_id=&amp;changedin=&amp;votes=&amp;chfieldfrom=&amp;chfieldto=Now&amp;chfieldvalue=&amp;product=Fop&amp;short_desc=&amp;short_desc_type=allwordssubstr&amp;long_desc=&amp;long_desc_type=allwordssubstr&amp;bug_file_loc=&amp;bug_file_loc_type=allwordssubstr&amp;keywords=&amp;keywords_type=anywords&amp;field0-0-0=noop&amp;type0-0-0=noop&amp;value0-0-0=&amp;order=bugs.component"/>
</menu>
<menu label="Resources">
diff --git a/src/documentation/content/xdocs/dev/release.xml b/src/documentation/content/xdocs/dev/release.xml
new file mode 100644
index 000000000..bbfa6ee1d
--- /dev/null
+++ b/src/documentation/content/xdocs/dev/release.xml
@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN"
+ "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/resources/schema/dtd/document-v11.dtd">
+<document>
+ <header>
+ <title>FOP Development: Release Mechanics</title>
+ </header>
+ <body>
+ <section id="intro">
+ <title>Introduction</title>
+ <p>This page documents the process of creating a FOP release.
+FOP releases are coordinated by one member of the team (currently Christian Geisert), so others do not ordinarily need to use this information.
+The purpose of documenting it here is to facilitate consistency, ensure that the process is captured, and to allow others to comment on the process.</p>
+ <p>The checklist below was assembled from Christian Geisert's notes. It will be expanded in the future as he has time.</p>
+ </section>
+ <section id="checklist">
+ <title>Checklist</title>
+ <ul>
+ <li>Determine whether this is a Release Candidate or a Release.</li>
+ <li>Determine whether further testing is required.</li>
+ <li>Edit release notes, and commit any changes.</li>
+ <li>Update version number in build.xml, and commit the change.</li>
+ <li>Tag the source tree with the release ID. For example, if the release is 0.20.5rc3:
+ <code>cvs tag fop-0_20_5rc3</code></li>
+ <li>Make a fresh checkout with the just created tag:
+ <code>cvs -d :pserver:anoncvs@cvs.apache.org:/home/cvspublic co -r
+fop-0_20_5rc3 xml-fop</code></li>
+ <li>Copy jimi and jai to lib/ (jimi-1.0.jar, jai_core.jar, jai_codec.jar)</li>
+ <li>Run build[.sh] dist. Use jdk1.3. A Forrest installation is needed.</li>
+ <li>Create signatures. Don't forget to upload your KEY:
+ <code>gpg -a -b --force-v3-sigs fop-0.20.5rc3-bin.tar.gz etc.</code></li>
+ <li>[md5?]</li>
+ <li>Upload to www.apache.org. (An account on daedalus is needed):
+ <code>scp fop-0.20.5rc3*.tar.gz*
+chrisg@www.apache.org:/www/www.apache.org/dist/xml/fop/</code></li>
+ <li>Check permissions:
+ <code>chmod 664 ... ; chgrp xml ...</code></li>
+ <li>Make a test download.</li>
+ <li>Wait 24 hours (for the mirrors to catch up).</li>
+ <li>Post announcements on fop-dev and fop-user mailing lists.</li>
+ <li>Add bugzilla entry for the new release id.</li>
+ </ul>
+ </section>
+ <section id="other-checklists">
+ <title>Resources</title>
+ <p>The following is a sample of some other project release checlists, which might be consulted for ideas:</p>
+ <ul>
+ <li><jump href="http://cvs.apache.org/viewcvs.cgi/xml-batik/MAINTAIN?rev=HEAD&amp;content-type=text/vnd.viewcvs-markup">Batik</jump></li>
+ <li><jump href="http://cvs.apache.org/viewcvs.cgi/ant/ReleaseInstructions?rev=HEAD&amp;content-type=text/vnd.viewcvs-markup">Ant</jump></li>
+ <li><jump href="http://jakarta.apache.org/cactus/participating/release_checklist.html">Cactus</jump></li>
+ </ul>
+ <p>Following are links with information about mirroring:</p>
+ <ul>
+ <li><jump href="http://apache.bilkent.edu.tr/dev/mirrors.html">Apache Mirroring</jump></li>
+ <li>Stefan Bodewig's <jump href="http://cvs.apache.org/~bodewig/mirror.html">Making your Downloads Mirrorable</jump></li>
+ </ul>
+ </section>
+ </body>
+</document>