sis-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r873632 - in /websites/staging/sis/trunk/content: ./ release-management-setup.html release-management.html
Date Thu, 08 Aug 2013 21:53:53 GMT
Author: buildbot
Date: Thu Aug  8 21:53:53 2013
New Revision: 873632

Log:
Staging update by buildbot for sis

Modified:
    websites/staging/sis/trunk/content/   (props changed)
    websites/staging/sis/trunk/content/release-management-setup.html
    websites/staging/sis/trunk/content/release-management.html

Propchange: websites/staging/sis/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Thu Aug  8 21:53:53 2013
@@ -1 +1 @@
-1511861
+1512061

Modified: websites/staging/sis/trunk/content/release-management-setup.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management-setup.html (original)
+++ websites/staging/sis/trunk/content/release-management-setup.html Thu Aug  8 21:53:53 2013
@@ -104,13 +104,15 @@ However in the later case, all relative 
 ├─ trunk
 ├─ branches
 ├─ tags
-└─ distribution
+├─ distribution
+└─ site
 </pre></div>
 
 
 <p>Create the above directory structure as below:</p>
 <div class="codehilite"><pre>svn checkout https://svn.apache.org/repos/asf/sis/trunk
 svn checkout https://dist.apache.org/repos/dist/dev/sis distribution
+svn checkout https://svn.apache.org/repos/asf/sis/site/trunk site
 mkdir branches
 mkdir tags
 </pre></div>

Modified: websites/staging/sis/trunk/content/release-management.html
==============================================================================
--- websites/staging/sis/trunk/content/release-management.html (original)
+++ websites/staging/sis/trunk/content/release-management.html Thu Aug  8 21:53:53 2013
@@ -146,9 +146,12 @@ in this page shall be adjusted according
 │  └─ $NEW_VERSION
 │     └─ target
 │        └─ bundles
-└─ distribution
-   └─ $NEW_VERSION
-      └─ RC$RELEASE_CANDIDATE
+├─ distribution
+│  └─ $NEW_VERSION
+│     └─ RC$RELEASE_CANDIDATE
+└─ site
+   └─ content
+      └─ apidocs
 </pre></div>
 
 
@@ -319,9 +322,9 @@ Select any <code>*.html</code> file whic
 Click on that file and verify that the custom elements are rendered properly.
 In particular, all Java code snippets are missing if the <code>@preformat</code>
taglet had not be properly registered,
 so try to see at least one code snippet.</p>
-<p>Delete all <code>org/apache/sis/parent/$NEW_VERSION/sis-$NEW_VERSION-source-release.zip.*</code>
files on the Nexus repository.
+<p>Delete all <code>org/apache/sis/parent/$NEW_VERSION/parent-$NEW_VERSION-source-release.zip.*</code>
files on the Nexus repository.
 They should not be there - source release will be deployed on an other repository later.</p>
-<p>Delete all <code>org/apache/sis/**/$NEW_VERSION/site.xml.*</code> files.
+<p>Delete all <code>org/apache/sis/*/$NEW_VERSION/*-$NEW_VERSION-site.xml.*</code>
files.
 There is no apparent reason for deploying Maven web site descriptors.</p>
 <p>Close the Nexus staging repository: click the checkboxes for the open staging repositories
 (<code>org.apache.sis-&lt;id&gt;</code>) and press <em>Close</em>
in the menu bar.
@@ -331,55 +334,86 @@ This will not be done automatically sinc
 <p>Click on the <code>org.apache.sis-&lt;id&gt;</code> link in
order to get the URL to the temporary Maven repository created by Nexus.
 Announce on the <code>dev@</code> mailing list the availability of this temporary
repository for testing purpose.</p>
 <h1 id="stage">Stage the source, binary and javadoc artifacts</h1>
+<p>Create the binary artifact (<code>pack.gz</code> file):</p>
+<div class="codehilite"><pre>mvn org.apache.sis.core:sis-build-helper:<span
class="nv">$NEW_VERSION</span>:pack --non-recursive
+</pre></div>
+
+
+<p>Generate the Javadoc. While not mandatory, we suggest to use JDK 7 or above for
getting the new look and feel,
+getting the Javadoc enhancements expected in future JDK releases (more dynamic pages),
+avoiding the security vulnerability discovered in the Javadoc tools of older JDK releases,
+and keeping the <code>diff</code> smaller on the SVN repository of SIS web site.
+If JDK7 is <em>not</em> used, then omit the <code>cp</code> command
below.</p>
+<div class="codehilite"><pre>cp ../../JDK7/src/main/javadoc/stylesheet.css src/main/javadoc/
+mvn site
+svn revert src/main/javadoc/stylesheet.css
+<span class="nb">cd </span>target/site
+zip -9 -r apache-sis-<span class="nv">$NEW_VERSION</span>-doc.zip apidocs
+<span class="nb">cd</span> ../..
+</pre></div>
+
+
 <p>Create the directory for the new version and release candidate within the distribution
directory.
 The <code>$RELEASE_CANDIDATE</code> number shall correspond to the current release
attempt.</p>
-<div class="codehilite"><pre>mkdir ../../distribution/<span class="nv">$NEW_VERSION</span>
+<div class="codehilite"><pre><span class="nb">cd</span> ../../distribution
+mkdir -p <span class="nv">$NEW_VERSION</span>/RC<span class="nv">$RELEASE_CANDIDATE</span>
+svn add <span class="nv">$NEW_VERSION</span>
 </pre></div>
 
 
-<p>Create and put the binary artifact in the distribution directory:</p>
-<div class="codehilite"><pre>mvn org.apache.sis.core:sis-build-helper:<span
class="nv">$NEW_VERSION</span>:pack --non-recursive
-mv target/bundles ../../distribution/<span class="nv">$NEW_VERSION</span>/RC<span
class="nv">$RELEASE_CANDIDATE</span>
+<p>Copy the <code>HEADER.html</code> file from the previous release.
+Update the file content if necessary.</p>
+<div class="codehilite"><pre><span class="n">cd</span> $<span
class="n">NEW_VERSION</span><span class="o">/</span><span class="n">RC</span>$<span
class="n">RELEASE_CANDIDATE</span>
+<span class="n">svn</span> <span class="n">copy</span> <span class="n">https</span><span
class="p">:</span><span class="o">//</span><span class="n">dist</span><span
class="p">.</span><span class="n">apache</span><span class="p">.</span><span
class="n">org</span><span class="o">/</span><span class="n">repos</span><span
class="o">/</span><span class="n">dist</span><span class="o">/</span><span
class="n">release</span><span class="o">/</span><span class="n">sis</span><span
class="o">/</span>$<span class="n">OLD_VERSION</span><span class="o">/</span><span
class="n">HEADER</span><span class="p">.</span><span class="n">html</span>
<span class="p">.</span>
 </pre></div>
 
 
-<p>Create and put the javadoc in the distribution directory:</p>
-<div class="codehilite"><pre><span class="nb">cd </span>target/site
-zip -9 -r ../../../../distribution/<span class="nv">$NEW_VERSION</span>/RC<span
class="nv">$RELEASE_CANDIDATE</span>/sis-<span class="nv">$NEW_VERSION</span>-apidocs.zip
apidocs
-<span class="nb">cd</span> ../..
+<p>Move the files generated by Maven to the distribution directory:</p>
+<div class="codehilite"><pre><span class="n">mv</span> <span class="p">.</span><span
class="o">./</span><span class="p">.</span><span class="o">./</span><span
class="p">.</span><span class="o">./</span><span class="n">tags</span><span
class="o">/</span>$<span class="n">NEW_VERSION</span><span class="o">/</span><span
class="n">target</span><span class="o">/</span><span class="n">sis</span><span
class="o">-</span>$<span class="n">NEW_VERSION</span><span class="o">-*</span>
<span class="p">.</span>
+<span class="n">mv</span> <span class="p">.</span><span class="o">./</span><span
class="p">.</span><span class="o">./</span><span class="p">.</span><span
class="o">./</span><span class="n">tags</span><span class="o">/</span>$<span
class="n">NEW_VERSION</span><span class="o">/</span><span class="n">target</span><span
class="o">/</span><span class="n">site</span><span class="o">/</span><span
class="n">apache</span><span class="o">-</span><span class="n">sis</span><span
class="o">-</span>$<span class="n">NEW_VERSION</span><span class="o">-*</span>
<span class="p">.</span>
 </pre></div>
 
 
-<p>Create and put the source code in the distribution directory:</p>
-<div class="codehilite"><pre>svn <span class="nb">export</span> .
../../distribution/<span class="nv">$NEW_VERSION</span>/RC<span class="nv">$RELEASE_CANDIDATE</span>/src
--native-eol LF
-<span class="nb">cd</span> ../../distribution/<span class="nv">$NEW_VERSION</span>/RC<span
class="nv">$RELEASE_CANDIDATE</span>
-zip -9 -r sis-<span class="nv">$NEW_VERSION</span>-src.zip src
-rm -r src
+<p>Rename the files to something more conform to the convention seen in other Apache
projects:</p>
+<div class="codehilite"><pre><span class="n">mv</span> <span class="n">sis</span><span
class="o">-</span>$<span class="n">NEW_VERSION</span><span class="o">-</span><span
class="n">source</span><span class="o">-</span><span class="n">release</span><span
class="p">.</span><span class="n">zip</span>     <span class="n">apache</span><span
class="o">-</span><span class="n">sis</span><span class="o">-</span>$<span
class="n">NEW_VERSION</span><span class="o">-</span><span class="n">src</span><span
class="p">.</span><span class="n">zip</span>
+<span class="n">mv</span> <span class="n">sis</span><span class="o">-</span>$<span
class="n">NEW_VERSION</span><span class="o">-</span><span class="n">source</span><span
class="o">-</span><span class="n">release</span><span class="p">.</span><span
class="n">zip</span><span class="p">.</span><span class="n">asc</span>
<span class="n">apache</span><span class="o">-</span><span class="n">sis</span><span
class="o">-</span>$<span class="n">NEW_VERSION</span><span class="o">-</span><span
class="n">src</span><span class="p">.</span><span class="n">zip</span><span
class="p">.</span><span class="n">asc</span>
 </pre></div>
 
 
 <p>Sign the source, javadoc and binary artifacts:</p>
-<div class="codehilite"><pre>gpg --armor --detach-sign sis-<span class="nv">$NEW_VERSION</span>.src.zip
-gpg --print-md SHA512     sis-<span class="nv">$NEW_VERSION</span>.src.zip &gt;
sis-<span class="nv">$NEW_VERSION</span>.src.zip.sha
-gpg --print-md MD5        sis-<span class="nv">$NEW_VERSION</span>.src.zip &gt;
sis-<span class="nv">$NEW_VERSION</span>.src.zip.md5
-gpg --armor --detach-sign sis-<span class="nv">$NEW_VERSION</span>.apidocs.zip
-gpg --print-md SHA512     sis-<span class="nv">$NEW_VERSION</span>.apidocs.zip
&gt; sis-<span class="nv">$NEW_VERSION</span>.apidocs.zip.sha
-gpg --print-md MD5        sis-<span class="nv">$NEW_VERSION</span>.apidocs.zip
&gt; sis-<span class="nv">$NEW_VERSION</span>.apidocs.zip.md5
-gpg --armor --detach-sign sis-<span class="nv">$NEW_VERSION</span>.pack.gz
-gpg --print-md SHA512     sis-<span class="nv">$NEW_VERSION</span>.pack.gz &gt;
sis-<span class="nv">$NEW_VERSION</span>.pack.gz.sha
-gpg --print-md MD5        sis-<span class="nv">$NEW_VERSION</span>.pack.gz &gt;
sis-<span class="nv">$NEW_VERSION</span>.pack.gz.md5
+<div class="codehilite"><pre>gpg --print-md SHA512     apache-sis-<span class="nv">$NEW_VERSION</span>-src.zip
&gt; apache-sis-<span class="nv">$NEW_VERSION</span>-src.zip.sha
+gpg --print-md MD5        apache-sis-<span class="nv">$NEW_VERSION</span>-src.zip
&gt; apache-sis-<span class="nv">$NEW_VERSION</span>-src.zip.md5
+gpg --armor --detach-sign apache-sis-<span class="nv">$NEW_VERSION</span>-doc.zip
+gpg --print-md SHA512     apache-sis-<span class="nv">$NEW_VERSION</span>-doc.zip
&gt; apache-sis-<span class="nv">$NEW_VERSION</span>-doc.zip.sha
+gpg --print-md MD5        apache-sis-<span class="nv">$NEW_VERSION</span>-doc.zip
&gt; apache-sis-<span class="nv">$NEW_VERSION</span>-doc.zip.md5
+gpg --armor --detach-sign apache-sis-<span class="nv">$NEW_VERSION</span>.pack.gz
+gpg --print-md SHA512     apache-sis-<span class="nv">$NEW_VERSION</span>.pack.gz
&gt; apache-sis-<span class="nv">$NEW_VERSION</span>.pack.gz.sha
+gpg --print-md MD5        apache-sis-<span class="nv">$NEW_VERSION</span>.pack.gz
&gt; apache-sis-<span class="nv">$NEW_VERSION</span>.pack.gz.md5
 </pre></div>
 
 
 <p>Commit:</p>
 <div class="codehilite"><pre><span class="nb">cd</span> ../..
-svn add <span class="nv">$NEW_VERSION</span>
 svn commit --message <span class="s2">&quot;SIS release candidate $RELEASE_CANDIDATE&quot;</span>
 </pre></div>
 
 
 <p>Verify that the files are downloadable from the
-[http://dist.apache.org/repos/dist/dev/sis/][http://dist.apache.org/repos/dist/dev/sis/]
sub-directory.</p>
+[https://dist.apache.org/repos/dist/dev/sis/][https://dist.apache.org/repos/dist/dev/sis/]
sub-directory.</p>
+<p>Copy the Javadoc to the web site staging directory:</p>
+<div class="codehilite"><pre><span class="nb">cd</span> ../site/content
+rm -r apidocs
+unzip ../../distribution/0.3/RC1/apache-sis-0.3-doc.zip
+</pre></div>
+
+
+<p>Execute <code>svn add</code> for new files and <code>svn remove</code>
for deleted files:</p>
+<div class="codehilite"><pre><span class="nb">cd </span>apidocs
+svn status | gawk <span class="s1">&#39;/^\?.*/ {print $2}&#39;</span>
| xargs -r svn add
+svn status | gawk <span class="s1">&#39;/^\!.*/ {print $2}&#39;</span>
| xargs -r svn remove
+</pre></div>
+
+
 <h1 id="vote">Put the release candidate up for a vote</h1>
 <ul>
 <li>Create a VOTE email thread on <code>dev@</code> to record votes as
replies.



Mime
View raw message