You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by dd...@apache.org on 2017/03/15 21:26:52 UTC
incubator-freemarker-site git commit: Updated committer-howto
Repository: incubator-freemarker-site
Updated Branches:
refs/heads/asf-site a40043241 -> 17589eaa2
Updated committer-howto
Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/commit/17589eaa
Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/tree/17589eaa
Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/diff/17589eaa
Branch: refs/heads/asf-site
Commit: 17589eaa2a8ce2e32473a00020757532e526e768
Parents: a400432
Author: ddekany <dd...@apache.org>
Authored: Wed Mar 15 22:26:48 2017 +0100
Committer: ddekany <dd...@apache.org>
Committed: Wed Mar 15 22:26:48 2017 +0100
----------------------------------------------------------------------
committer-howto.html | 40 +++++++++++++++++++++++++++++-----------
1 file changed, 29 insertions(+), 11 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/17589eaa/committer-howto.html
----------------------------------------------------------------------
diff --git a/committer-howto.html b/committer-howto.html
index 3e6803e..7eaa917 100644
--- a/committer-howto.html
+++ b/committer-howto.html
@@ -14,7 +14,7 @@
<link rel="canonical" href="http://freemarker.org/committer-howto.html">
<link rel="icon" href="favicon.png" type="image/png">
<link rel="stylesheet" type="text/css" href="http://fonts.googleapis.com/css?family=Roboto:500,700,400,300|Droid+Sans+Mono">
-<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1488814460551">
+<link rel="stylesheet" type="text/css" href="docgen-resources/docgen.min.css?1489613156790">
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
@@ -35,8 +35,8 @@ ga('send', 'pageview');
<div class="content-wrapper">
<div id="table-of-contents-wrapper" class="col-left">
<script>var breadcrumb = ["Apache FreeMarker","Community","Committer how-to"];</script>
- <script src="toc.js?1488814460551"></script>
- <script src="docgen-resources/main.min.js?1488814460551"></script>
+ <script src="toc.js?1489613156790"></script>
+ <script src="docgen-resources/main.min.js?1489613156790"></script>
</div>
<div class="col-right"><div class="page-content"><div class="page-title"><div class="title-wrapper">
<h1 class="content-header header-section1" id="committer-howto" itemprop="headline">Committer how-to</h1>
@@ -183,8 +183,8 @@ ga('send', 'pageview');
<p>Releases with non-trivial changes should have at least one
Release Candidate (RC01) release, which is legally a normal
release (not just a internal/developer one), and is promoted for
- at least 1 month on our web page. These are there differences to a
- final release:</p>
+ at least 1 month on our web page. The differences to a final
+ release are these:</p>
<ul>
<li>
@@ -205,22 +205,28 @@ ga('send', 'pageview');
project (src tar.gz). For the convenience of users the release is
also accompanied by compiled binaries (bin tar.gz, which also
contains the documentation). Both artifacts are downloadable from
- the Apache Software Foundation, as usual</p>
+ the Apache Software Foundation, as usual.</p>
</li>
<li>
<p>The same two artifacts should also be released (uploaded for
download) on <a href="https://sourceforge.net/projects/freemarker/">https://sourceforge.net/projects/freemarker/</a>.
- We add a note there to the indicate that the canonical download is
- the one from Apache.</p>
+ We add a note there to indicate that the canonical download is the
+ one from Apache.</p>
</li>
<li>
<p>Releases should have a usual jar artifact, an src artifact
- and javadoc artifact either in the Apache Maven staging reposotory
+ and javadoc artifact either in the Apache Maven staging repository
(for RC-s), or in the Maven Central Repository (for
finals).</p>
</li>
+
+ <li>
+ <p>In the 2.3.x branch, we release two products, the normal and
+ the GAE (Google App Engine) version. Hence when executing the
+ release steps, you do many of them twice.</p>
+ </li>
</ul>
<p>The steps of making a release:</p>
@@ -245,7 +251,19 @@ ga('send', 'pageview');
</li>
<li>
- <p>Ensure this is up to date:
+ <p>Compare the jar to the earlier stable release for API
+ compatibility issues (both source and binary level). So far we
+ have used <a href="https://lvc.github.io/japi-compliance-checker/">"Java
+ API Compliance Checker" (JAPICC)</a> with these
+ arguments: <code class="inline-code">-keep-internal -skip-internal-types \._ -l
+ FreeMarker <em class="code-color">old</em>.jar
+ <em class="code-color">new</em>.jar</code>. Note that it's prone
+ to generate false alarms, so simply review each problems and
+ decide which is real.</p>
+ </li>
+
+ <li>
+ <p>Ensure that this is up to date:
https://dist.apache.org/repos/dist/<em>{dev,release}</em>/incubator/freemarker/KEY</p>
</li>
@@ -641,7 +659,7 @@ ga('send', 'pageview');
</div>
<div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="index.html">What is FreeMarker?</a></li><li><a href="freemarkerdownload.html">Download</a></li><li><a href="docs/app_versions.html">Version history</a></li><li><a href="history.html">About us</a></li><li><a itemprop="license" href="docs/app_license.html">License</a></li></ul></div><div class="column"><h3 class="column-header">Handy stuff</h3><ul><li><a href="http://freemarker-online.kenshoo.com/">Try template online</a></li><li><a href="docs/dgui_template_exp.html#exp_cheatsheet">Expressions cheatsheet</a></li><li><a href="docs/ref_directive_alphaidx.html">#directives</a></li><li><a href="docs/ref_builtins_alphaidx.html">?built_ins</a></li><li><a href="docs/ref_specvar.html">.special_vars</a></li></ul></div><div class="column"><h3 class="column-header">Community</h3><ul><li><a href="https://github.com/apach
e/incubator-freemarker">FreeMarker on Github</a></li><li><a href="https://twitter.com/freemarker">Follow us on Twitter</a></li><li><a href="https://issues.apache.org/jira/browse/FREEMARKER/">Report a bug</a></li><li><a href="http://stackoverflow.com/questions/ask?tags=freemarker">Ask a question</a></li><li><a href="mailing-lists.html">Mailing lists</a></li></ul></div></div><div class="col-right"><ul class="social-icons"><li><a class="github" href="https://github.com/apache/incubator-freemarker">GitHub</a></li><li><a class="twitter" href="https://twitter.com/freemarker">Twitter</a></li><li><a class="stack-overflow" href="http://stackoverflow.com/questions/ask?tags=freemarker">Stack Overflow</a></li></ul><a class="xxe" href="http://www.xmlmind.com/xmleditor/" rel="nofollow" title="Edited with XMLMind XML Editor"><span>Edited with XMLMind XML Editor</span></a></div></div><div class="footer-bottom"> <p class="last-generated">
Last generated:
-<time itemprop="dateModified" datetime="2017-03-06T15:34:20Z" title="Monday, March 6, 2017 3:34:20 PM GMT">2017-03-06 15:34:20 GMT</time> </p>
+<time itemprop="dateModified" datetime="2017-03-15T21:25:56Z" title="Wednesday, March 15, 2017 9:25:56 PM GMT">2017-03-15 21:25:56 GMT</time> </p>
<p class="copyright">
� <span itemprop="copyrightYear">1999</span>\u20132017
<a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. </p>