mirrors
/
fop
mirror of https://github.com/apache/fop.git
Watch 1
Star 0
Fork 0
Code Issues 0 Releases 48 Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
7101 Commits
70 Branches
Tree: ab6067a056
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'ab6067a056'
${ noResults }
fop/src/documentation/content/xdocs/dev/release.xml

release.xml 9.0KB
Raw Blame History

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159 
  1. <?xml version="1.0" encoding="UTF-8"?>

  2. <!--

  3.   Licensed to the Apache Software Foundation (ASF) under one or more

  4.   contributor license agreements.  See the NOTICE file distributed with

  5.   this work for additional information regarding copyright ownership.

  6.   The ASF licenses this file to You under the Apache License, Version 2.0

  7.   (the "License"); you may not use this file except in compliance with

  8.   the License.  You may obtain a copy of the License at

  9. 

  10.        http://www.apache.org/licenses/LICENSE-2.0

  11. 

  12.   Unless required by applicable law or agreed to in writing, software

  13.   distributed under the License is distributed on an "AS IS" BASIS,

  14.   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.

  15.   See the License for the specific language governing permissions and

  16.   limitations under the License.

  17. -->

  18. <!-- $Id$ -->

  19. <!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.3//EN" "http://forrest.apache.org/dtd/document-v13.dtd">

  20. <document>

  21.   <header>

  22.     <title>Apache™ FOP Development: Release Mechanics</title>

  23.     <version>$Revision$</version>

  24.   </header>

  25.   <body>

  26.     <section id="intro">

  27.       <title>Introduction</title>

  28.       <p>This page documents the process of creating a Apache™ FOP release.

  29. FOP releases are coordinated by one member of the team (currently Christian Geisert), so others do not ordinarily need to use this information.

  30. 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>

  31.       <p>The checklist below was assembled from Christian Geisert's notes. It will be expanded in the future as he has time.</p>

  32.     </section>

  33.     <section id="checklist">

  34.       <title>Checklist</title>

  35.       <ul>

  36.         <li>Determine whether this is a Release Candidate or a Release.</li>

  37.         <li>Determine whether further testing is required.</li>

  38.         <li>Commit any outstanding changes</li>

  39.         <li>Create a branch called <code>branches/fop-v_vv</code></li>

  40.         <li>Edit release notes (<code>README</code> and

  41. 		<code>status.xml</code> in the root).</li>

  42. 		<li>Add the release to <code>news-data.xml</code>;

  43. 		remove links to release notes of older versions from this file.</li>

  44. 		<li>Update the FAQ (<code>faq.xml</code>) to the new release.</li>

  45. 		<li>Check and update the copyright year in NOTICE and build.xml.</li>

  46.         <li>Update the file <code>doap.rdf</code>, and the files

  47. 		<code>index.xml</code>, <code>site.xml</code>,

  48. 		<code>download.xml</code>, <code>fo.xml</code>,

  49. 		<code>maillist.xml</code>, <code>quickstartguide.xml</code>,

  50. 		<code>faq.xml</code> and <code>status.xml</code>

  51. 		in directory <code>xdocs</code> for the new version.</li>

  52.         <li>Update the version numbers in the release column on the

  53.         compliance page (<code>compliance.xml</code>); update the compliance in the release column

  54.         to the current state (development column).</li>

  55.         <li>Update version number in <code>build.xml</code> (not to be merged back

  56.         into trunk).</li>

  57.         <li>Copy trunk documentation directory to a new directory with

  58. 		the new version number, and update the .htaccess file for

  59. 		redirections.</li>

  60.         <li>Copy <code>test/fotree/disabled-testcases.xml</code> and

  61.         <code>test/layoutengine/disabled-testcases.xml</code> to the

  62.         new version directory

  63.         <code>&lt;version&gt;/fotree/disabled-testcases.xml</code> and

  64.         <code>&lt;version&gt;/layoutengine/disabled-testcases.xml</code>.

  65.         Copy <code>known-issues.xml</code> to the new version

  66.         directory. Copy <code>knownissues-overview.xml</code> from the

  67.         current to the new version directory, and update the <code>xi:include</code>

  68.         links in it.</li>

  69.         <li>Update the tab names and directories in tabs.xml</li>

  70.         <li>Delete the previous version directory.</li>

  71. 		<li>Update index.xml in the new version directory.</li>

  72. 		<li>Update compiling.xml in the new version directory: change the intro for trunk to that for a release.</li>

  73.         <li>Build the dist files (<code>build[.sh] dist</code>)

  74.         and upload them to your web directory on

  75.         <code>people.apache.org</code></li>

  76.         <li>Ask on fop-dev to check the branch and the generated dist

  77.         files for errors.</li>

  78.         <li>Tag the source tree with the release ID. For example, if the release is 1.0:

  79.           <code>svn copy https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-1_0 https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-1_0</code></li>

  80.         <li>Make a fresh checkout with the just created tag:

  81.           <code>svn co https://svn.apache.org/repos/asf/xmlgraphics/fop/tags/fop-1_0</code></li>

  82.         <li>Copy jimi and jai to lib/ (jimi-1.0.jar, jai_core.jar, jai_codec.jar)</li>

  83.         <li>Copy jce-jdk13-119.jar from <link href="http://www.bouncycastle.org/latest_releases.html">

  84.           from http://www.bouncycastle.org/latest_releases.html</link> to lib/</li>

  85.         <li>Copy the hyphenation patterns jar file

  86.         <code>fop-hyph.jar</code> to lib/ (e.g. from

  87.         <code>http://sourceforge.net/projects/offo</code></li>

  88.         <li>Alternatively, create a build-local.properties file that points to the above libs.</li>

  89.         <li>Run build[.sh] dist. Do this using Sun JDK 1.4.2_08 or later. A Forrest installation is needed.</li>

  90.         <li>Create signatures. Don't forget to upload your KEY:

  91.           <code>gpg -a -b --force-v3-sigs fop-1.0-src.tar.gz</code> etc.</li>

  92.         <li>Upload the dist and signature files to your web directory

  93.           on people.apache.org (An account on minotaur is needed):

  94.           <code>scp fop-1.0*.tar.gz*

  95.           chrisg@people.apache.org:public_html/</code></li>

  96.         <li>Check permissions:

  97.           <code>chmod 664 ... ; chgrp xmlgraphics ...</code></li>

  98.         <li>Add MD5 sums: <code>md5 fop-1.0-src.tar.gz &gt;

  99.           fop-1.0-src.tar.gz.md5</code> etc.</li>

  100.         <li>Make a test download.</li>

  101.         <li>Start a vote for the release on

  102.         <code>general@xmlgraphics.a.o</code>. The message should point

  103.         to the release files and list the MD5 sums (<code>cat

  104.         *.md5</code>). The vote is open for 72hrs.</li>

  105.         <li>When the release is accepted, copy the release files,

  106.         their md5 sum files and the signature files to

  107.         /www/www.apache.org/dist/xmlgraphics/fop/ in the

  108.         subdirectories <code>source</code> and

  109.         <code>binaries</code>. Create links to all files in the

  110.         <code>fop</code> directory. Remove the links to the files of

  111.         the previous version.</li>

  112.         <li>Update HEADER.html and README.html in people.apache.org:/www/www.apache.org/dist/xmlgraphics/fop/</li>

  113.         <li>Wait 24 hours (for the mirrors to catch up).</li>

  114.         <li>Merge the changes of the subversion release branch back

  115.         into trunk (not the version number in the build file) and

  116.         delete the branch.</li>

  117.         <li>Deploy the updated documentation to the FOP website.</li>

  118.         <li>Post announcements on fop-dev and fop-user and other related mailing lists.</li>

  119.         <li>Ask a Bugzilla admin (Christian Geisert) to add a bugzilla

  120.         entry for the new release id, or create an issue at

  121.         <code>https://issues.apache.org/jira/browse/INFRA</code>.</li>

  122.       </ul>

  123.     </section>

  124.     <section id="other-checklists">

  125.       <title>Resources</title>

  126.       <p>The following is a sample of some other project release checklists, which might be consulted for ideas:</p>

  127.       <ul>

  128.         <li><jump href="http://svn.apache.org/repos/asf/xmlgraphics/batik/trunk/MAINTAIN">Apache Batik</jump></li>

  129.         <li><jump href="http://svn.apache.org/repos/asf/ant/core/trunk/ReleaseInstructions">Apache Ant</jump></li>

  130.         <li><jump href="http://jakarta.apache.org/cactus/participating/release_checklist.html">Apache Cactus</jump></li>

  131.       </ul>

  132.       <p>Following are links with information about mirroring:</p>

  133.       <ul>

  134.         <li><jump href="http://www.apache.org/dev/mirrors.html">Apache Mirroring</jump></li>

  135.         <li>Stefan Bodewig's <jump href="http://people.apache.org/~bodewig/mirror.html">Making your Downloads Mirrorable</jump></li>

  136.       </ul>

  137.     </section>

  138.     <section id="announcements">

  139.       <title>Announcing the release</title>

  140.       <p>Here's a collected list of places where to announce new FOP releases:</p>

  141.       <ul>

  142.         <li>fop-dev@xmlgraphics.apache.org</li>

  143.         <li>fop-users@xmlgraphics.apache.org</li>

  144.         <li>general@xmlgraphics.apache.org</li>

  145.         <li>general@xml.apache.org</li>

  146.         <li>announce@apache.org (from your apache.org address)</li>

  147.         <li>xsl-list@lists.mulberrytech.com (subscriber-only)</li>

  148.         <li>XSL-FO@yahoogroups.com (subscriber-only)</li>

  149.         <li>www-xsl-fo@w3.org</li>

  150.         <li>docbook-apps@lists.oasis-open.org (subscriber-only)</li>

  151.         <li>dita-users@yahoogroups.com (subscriber-only) (http://dita-ot.sourceforge.net/)</li>

  152.         <li>http://xslfo-zone.com/news/index.jsp</li>

  153.         <li>http://www.w3.org/Style/XSL/</li>

  154.         <li>http://freshmeat.net/projects/fop/</li>

  155.         <li>any others?</li>

  156.       </ul>

  157.     </section>

  158.   </body>

  159. </document>