You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@directory.apache.org by bu...@apache.org on 2016/06/14 08:29:08 UTC
svn commit: r990560 - in /websites/staging/directory/trunk/content: ./
api/developer-guide.html
Author: buildbot
Date: Tue Jun 14 08:29:07 2016
New Revision: 990560
Log:
Staging update by buildbot for directory
Modified:
websites/staging/directory/trunk/content/ (props changed)
websites/staging/directory/trunk/content/api/developer-guide.html
Propchange: websites/staging/directory/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Tue Jun 14 08:29:07 2016
@@ -1 +1 @@
-1742386
+1748356
Modified: websites/staging/directory/trunk/content/api/developer-guide.html
==============================================================================
--- websites/staging/directory/trunk/content/api/developer-guide.html (original)
+++ websites/staging/directory/trunk/content/api/developer-guide.html Tue Jun 14 08:29:07 2016
@@ -458,39 +458,34 @@ stty <span class="nb">echo</span>
</td></tr></table>
<h3 id="publish-source-and-binary-distribution-packages">Publish Source and Binary Distribution Packages<a class="headerlink" href="#publish-source-and-binary-distribution-packages" title="Permanent link">¶</a></h3>
-<p>First of all, create a new directory on people.apache.org/public_html to store the pacckages :</p>
-<div class="codehilite"><pre>$ <span class="n">ssh</span> <span class="n">people</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span>
-$ <span class="n">mkdir</span> <span class="n">public_html</span><span class="o">/</span><span class="n">ldap</span><span class="o">-</span><span class="n">api</span><span class="o">-<</span><span class="n">version</span><span class="o">></span>
-$ <span class="n">exit</span>
+<p>The sources, binaries and their signatures, have to be pushed in a place where they can be downloaded by the other committers, in order to be chekced while validating the release. As the ~/people.apache.org server is not anymore available for that purpose, we use the <a href="https://dist.apache.org/repos/dist/dev/directory">distribution</a> space for that purpose.</p>
+<p>If you haven't chekced out this space, do it now :</p>
+<div class="codehilite"><pre>$ <span class="n">mkdir</span> <span class="o">-</span><span class="n">p</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span>
+$ <span class="n">svn</span> <span class="n">co</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">dev</span><span class="o">/</span><span class="n">directory</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span>
</pre></div>
-<p>Then copy the packages :</p>
+<p>That will checkout the full project distributions. </p>
+<p>You may want to checkout only the part that you are going to generate, to avoid getting Gb of data :</p>
+<div class="codehilite"><pre>$ <span class="n">mkdir</span> <span class="o">-</span><span class="n">p</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span>
+$ <span class="n">svn</span> <span class="n">co</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">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span>
+</pre></div>
+
+
+<p>Now, create a sub-directory for the version you have generated (here, for version 1.0.0-RC1) :</p>
+<div class="codehilite"><pre>$ <span class="n">mkdir</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span><span class="o">/</span>1<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">RC1</span>
+</pre></div>
+
+
+<p>and copy the packages and signature to this area :</p>
<div class="codehilite"><pre>$ <span class="n">cd</span> <span class="n">distributions</span><span class="o">/</span><span class="n">target</span>
-$ <span class="n">scp</span> <span class="n">apache</span><span class="o">-</span><span class="n">ldap</span><span class="o">-</span><span class="n">api</span><span class="o">-<</span><span class="n">version</span><span class="o">>-*</span> <span class="n">people</span><span class="p">.</span><span class="n">apache</span><span class="p">.</span><span class="n">org</span><span class="p">:</span><span class="n">public_html</span><span class="o">/</span><span class="n">ldap</span><span class="o">-</span><span class="n">api</span><span class="o">-<</span><span class="n">version</span><span class="o">>/</span>
+$ <span class="n">cp</span> <span class="n">apache</span><span class="o">-</span><span class="n">ldap</span><span class="o">-</span><span class="n">api</span><span class="o">-<</span><span class="n">version</span><span class="o">>-*</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span><span class="o">/</span>1<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">RC1</span>
</pre></div>
-<p>Update your index.html file on people.apach.org/public_html to make the packages visible. Here is an example of possible content :</p>
-<div class="codehilite"><pre><span class="nt"><h2></span>Last Directory LDAP API 1.0.0-M16 tarballs<span class="nt"></h2></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.tar.gz"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.tar.gz<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.tar.gz.asc"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.tar.gz.asc<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.tar.gz.md5"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.tar.gz.md5<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.tar.gz.sha1"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.tar.gz.sha1<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.zip"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.zip<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.zip.asc"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.zip.asc<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.zip.md5"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.zip.md5<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-bin.zip.sha1"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-bin.zip.sha1<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.tar.gz"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.tar.gz<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.tar.gz.asc"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.tar.gz.asc<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.tar.gz.md5"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.tar.gz.md5<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.tar.gz.sha1"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.tar.gz.sha1<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.zip"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.zip<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.zip.asc"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.zip.asc<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.zip.md5"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.zip.md5<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16-src.zip.sha1"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16-src.zip.sha1<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16.pom"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16.pom<span class="nt"></a><br/></span>
- <span class="nt"><a</span> <span class="na">href=</span><span class="s">"ldap-api-1.0.0-M16/apache-ldap-api-1.0.0-M16.pom.asc"</span><span class="nt">></span>apache-ldap-api-1.0.0-M16.pom.asc<span class="nt"></a><br/></span>
+<p>Last, not least, commit your changes</p>
+<div class="codehilite"><pre>$ <span class="n">scn</span> <span class="n">add</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span><span class="o">/</span>1<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">RC1</span>
+$ <span class="n">scn</span> <span class="n">ci</span> <span class="o">~/</span><span class="n">apacheds</span><span class="o">/</span><span class="n">dist</span><span class="o">/</span><span class="n">dev</span><span class="o">/</span><span class="n">directory</span><span class="o">/</span><span class="n">api</span><span class="o">/</span>1<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">RC1</span> <span class="o">-</span><span class="n">m</span> "<span class="n">Apache</span> <span class="n">LDAP</span> <span class="n">API</span> 1<span class="p">.</span>0<span class="p">.</span>0<span class="o">-</span><span class="n">RC1</span> <span class="n">packages</span>"
</pre></div>