cayenne-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r837699 - in /websites/staging/cayenne/trunk/content: ./ release-guide.html
Date Thu, 08 Nov 2012 18:30:14 GMT
Author: buildbot
Date: Thu Nov  8 18:30:13 2012
New Revision: 837699

Log:
Staging update by buildbot for cayenne

Modified:
    websites/staging/cayenne/trunk/content/   (props changed)
    websites/staging/cayenne/trunk/content/release-guide.html

Propchange: websites/staging/cayenne/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Nov  8 18:30:13 2012
@@ -1 +1 @@
-1407207
+1407208

Modified: websites/staging/cayenne/trunk/content/release-guide.html
==============================================================================
--- websites/staging/cayenne/trunk/content/release-guide.html (original)
+++ websites/staging/cayenne/trunk/content/release-guide.html Thu Nov  8 18:30:13 2012
@@ -101,34 +101,21 @@ perform to prepare a release. The specif
 that we are publishing both downloadable assemblies and Maven artifacts, so
 we have to build and publish things twice. Both forms of Cayenne release
 are also available for evaluation during the vote.</p>
-<p><a name="ReleaseGuide-Prerequisites"></a></p>
 <h2 id="prerequisites">Prerequisites</h2>
 <ul>
-<li>
-<p>A release manager must have his public key appended to the KEYS file
+<li>A 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 at <a href="http://www.apache.org/dev/release-signing.html">http://www.apache.org/dev/release-signing.html</a></p>
-</li>
-<li>
-<p>Make sure "apache-releases" repository is configured in
+More info can be found at <a href="http://www.apache.org/dev/release-signing.html">http://www.apache.org/dev/release-signing.html</a></li>
+<li>Make sure "apache-releases" repository is configured in
 <em>~/.m2/settings.xml</em> and an appropriate password is setup. See <a href="http://www.apache.org/dev/publishing-maven-artifacts.html">this
page</a>
- for details.</p>
-</li>
+ for details.</li>
 </ul>
-<p><a name="ReleaseGuide-PreparingSources"></a></p>
 <h2 id="preparing-sources">Preparing Sources</h2>
 <ul>
+<li>Edit UPGRADE-NOTES.txt if there is anything to add there.</li>
 <li>
-<p>Export and commit the latest documentation per <a href="documentation-guidelines.html">Documentation
Guidelines</a>.</p>
-</li>
-<li>
-<p>Edit UPGRADE-NOTES.txt if there is anything to add there.</p>
-</li>
-<li>
-<p>Check Sources Compliance with ARAT. <a href="http://code.google.com/p/arat/">ARAT</a>
- (A Release Audit Tool) is a Java tool written by Robert Burrell Donkin for
-checking the release files for ASF licensing compliance. To run ARAT,
-download the jar <em>(we are using version 0.5.1)</em>, and run it against
+<p>Check Sources Compliance with <a href="http://creadur.apache.org/rat/">RAT</a>.
To run RAT,
+download the jar, and run it against
 unpacked distro (or the release tag), read the report and fix any issues.</p>
 <div class="codehilite"><pre><span class="n">cd</span> <span class="n">cayenne</span>
 <span class="n">mvn</span> <span class="n">clean</span>
@@ -157,26 +144,25 @@ development, SVN checkout is still neede
 </pre></div>
 
 
+</li>
+</ul>
 <p>A problem <a href="http://www.apache.org/dev/publishing-maven-artifacts.html#prepare-release">described
in the documentation</a>
  consistently occurs here ... if you are in Europe: "If you're located in
 Europe then release:prepare may fail with 'Unable to tag SCM' and ' svn: No
 such revision X '. Wait 10 seconds and run mvn release:prepare again." It
 fails indeed, and requires a re-run and continue:</p>
-<div class="codehilite"><pre><span class="n">mvn</span> <span
class="n">release:perform</span> <span class="o">-</span><span class="n">P</span>
<span class="n">gpg</span> <span class="p">[</span><span class="o">-</span><span
class="n">Dgpg</span><span class="o">.</span><span class="n">keyname</span><span
class="o">=</span><span class="n">B8AF90BF</span><span class="p">]</span>
+<div class="codehilite"><pre>    <span class="n">mvn</span> <span
class="n">release:perform</span> <span class="o">-</span><span class="n">P</span>
<span class="n">gpg</span> <span class="p">[</span><span class="o">-</span><span
class="n">Dgpg</span><span class="o">.</span><span class="n">keyname</span><span
class="o">=</span><span class="n">B8AF90BF</span><span class="p">]</span>
 </pre></div>
 
 
-</li>
-<li>
-<p>Close the staging repo. Login to <a href="https://repository.apache.org/">https://repository.apache.org/</a>
with
+<ul>
+<li>Close the staging repo. Login to <a href="https://repository.apache.org/">https://repository.apache.org/</a>
with
 Apache ID/password, go to "Staging Repositories" page. Select a staging
 repository that was just created during "<em>mvn release:perform</em>", click
 "Close". Take a note of the freshly created staging repository URL. It will
 be used by the people voting on Cayenne. It may look like this:
-<a href="https://repository.apache.org/content/repositories/orgapachecayenne-052/">https://repository.apache.org/content/repositories/orgapachecayenne-052/</a>
</p>
-</li>
+<a href="https://repository.apache.org/content/repositories/orgapachecayenne-052/">https://repository.apache.org/content/repositories/orgapachecayenne-052/</a>
</li>
 </ul>
-<p><a name="ReleaseGuide-ReleasingDownloadableAssemblies"></a></p>
 <h2 id="releasing-downloadable-assemblies">Releasing Downloadable Assemblies</h2>
 <ul>
 <li>
@@ -191,8 +177,7 @@ in the next steps) :</p>
 
 </li>
 <li>
-<p>Build binary assemblies. Take
-<em>"assembly/target/cayenne-XXX-src.tar.gz"</em>, unpack it somewhere, and
+<p>Build binary assemblies. Take <em>"assembly/target/cayenne-XXX-src.tar.gz"</em>,
unpack it somewhere, and
 perform binary builds from the unpacked directory (NOT FROM SVN OR GIT
 CHECKOUT). <em>Release manager may skip running unit tests from here, as shown
 below, although release evaluators should use the src assembly for <a href="running-unit-tests.html">unit
testing</a>
@@ -209,22 +194,21 @@ below, although release evaluators shoul
 </li>
 <li>
 <p>Signing assemblies</p>
+</li>
+</ul>
 <p>For more info visit <a href="http://www.apache.org/dev/release-signing.html">this
page</a>
 . Release manager key must be in the project KEYS file. Signing is a manual
 procedure not included in the Ant or Maven script. Here is how it might
 work ("-u" option can be omitted if you have only one GPG key):</p>
-<div class="codehilite"><pre><span class="n">gpg</span> <span
class="o">--</span><span class="n">armor</span> <span class="o">-</span><span
class="n">u</span> <span class="n">B8AF90BF</span> <span class="o">--</span><span
class="n">output</span> <span class="n">cayenne</span><span class="o">-</span><span
class="n">X</span><span class="o">.</span><span class="n">X</span><span
class="o">.</span><span class="n">tar</span><span class="o">.</span><span
class="n">gz</span><span class="o">.</span><span class="n">asc</span>
<span class="o">--</span><span class="n">detach</span><span class="o">-</span><span
class="n">sig</span> <span class="n">cayenne</span><span class="o">-</span><span
class="n">X</span><span class="o">.</span><span class="n">X</span><span
class="o">.</span><span class="n">tar</span><span class="o">.</span><span
class="n">gz</span>
-<span class="n">gpg</span> <span class="o">--</span><span class="k">print</span><span
class="o">-</span><span class="n">md</span> <span class="n">MD5</span>
<span class="n">cayenne</span><span class="o">-</span><span class="n">X</span><span
class="o">.</span><span class="n">X</span><span class="o">.</span><span
class="n">tar</span><span class="o">.</span><span class="n">gz</span>
<span class="o">&gt;</span> <span class="n">cayenne</span><span
class="o">-</span><span class="n">X</span><span class="o">.</span><span
class="n">X</span><span class="o">.</span><span class="n">tar</span><span
class="o">.</span><span class="n">gz</span><span class="o">.</span><span
class="n">md5</span>
+<div class="codehilite"><pre>    <span class="n">gpg</span> <span
class="o">--</span><span class="n">armor</span> <span class="o">-</span><span
class="n">u</span> <span class="n">B8AF90BF</span> <span class="o">--</span><span
class="n">output</span> <span class="n">cayenne</span><span class="o">-</span><span
class="n">X</span><span class="o">.</span><span class="n">X</span><span
class="o">.</span><span class="n">tar</span><span class="o">.</span><span
class="n">gz</span><span class="o">.</span><span class="n">asc</span>
<span class="o">--</span><span class="n">detach</span><span class="o">-</span><span
class="n">sig</span> <span class="n">cayenne</span><span class="o">-</span><span
class="n">X</span><span class="o">.</span><span class="n">X</span><span
class="o">.</span><span class="n">tar</span><span class="o">.</span><span
class="n">gz</span>
+    <span class="n">gpg</span> <span class="o">--</span><span
class="k">print</span><span class="o">-</span><span class="n">md</span>
<span class="n">MD5</span> <span class="n">cayenne</span><span
class="o">-</span><span class="n">X</span><span class="o">.</span><span
class="n">X</span><span class="o">.</span><span class="n">tar</span><span
class="o">.</span><span class="n">gz</span> <span class="o">&gt;</span>
<span class="n">cayenne</span><span class="o">-</span><span class="n">X</span><span
class="o">.</span><span class="n">X</span><span class="o">.</span><span
class="n">tar</span><span class="o">.</span><span class="n">gz</span><span
class="o">.</span><span class="n">md5</span>
 </pre></div>
 
 
-</li>
-<li>
-<p>Assemblies, signature and checksum files are uploaded to the release
-manager's web directory on <em>people.apache.org</em>.</p>
-</li>
+<ul>
+<li>Assemblies, signature and checksum files are uploaded to the release
+manager's web directory on <em>people.apache.org</em>.</li>
 </ul>
-<p><a name="ReleaseGuide-Voting"></a></p>
 <h2 id="voting">Voting</h2>
 <ul>
 <li>The vote is started on the dev mailing list.</li>
@@ -246,7 +230,6 @@ main jar passes some basic tests.
 running them manually or verifying that Hudson has run those tests against
 the equivalent source). </li>
 </ul>
-<p><a name="ReleaseGuide-PublishingtheRelease"></a></p>
 <h2 id="publishing-the-release">Publishing the Release</h2>
 <ul>
 <li>
@@ -262,7 +245,6 @@ select the staging repo and click "Relea
 
 </li>
 </ul>
-<p><a name="ReleaseGuide-AftertheRelease"></a></p>
 <h2 id="after-the-release">After the release</h2>
 <ul>
 <li><a href="https://issues.apache.org/jira/secure/project/ManageVersions.jspa?pid=12310903">Tell
Jira</a>
@@ -283,7 +265,6 @@ add any new features</li>
 <li>Send a notification email to announceATapachenews.org</li>
 <li>Update <a href="http://en.wikipedia.org/wiki/Apache_Cayenne">http://en.wikipedia.org/wiki/Apache_Cayenne</a></li>
 </ul>
-<p><a name="ReleaseGuide-Reference"></a></p>
 <h2 id="reference">Reference:</h2>
 <ul>
 <li>Apache release publishing:



Mime
View raw message