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/09/30 10:46:41 UTC
[1/3] incubator-freemarker git commit: Manual: Updated some
incompatibleImprovements version numbers in examples
Repository: incubator-freemarker
Updated Branches:
refs/heads/2.3 a86146b19 -> 9459a40cb
Manual: Updated some incompatibleImprovements version numbers in examples
Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/commit/a3671957
Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/tree/a3671957
Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/diff/a3671957
Branch: refs/heads/2.3
Commit: a367195722c6ae024f9a041e470399ab660dc6bc
Parents: 2c12980
Author: ddekany <dd...@apache.org>
Authored: Sat Sep 30 11:59:20 2017 +0200
Committer: ddekany <dd...@apache.org>
Committed: Sat Sep 30 11:59:20 2017 +0200
----------------------------------------------------------------------
src/manual/en_US/book.xml | 38 +++++++++++++++++++-------------------
1 file changed, 19 insertions(+), 19 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/a3671957/src/manual/en_US/book.xml
----------------------------------------------------------------------
diff --git a/src/manual/en_US/book.xml b/src/manual/en_US/book.xml
index 7ba5852..5da4c42 100644
--- a/src/manual/en_US/book.xml
+++ b/src/manual/en_US/book.xml
@@ -7672,7 +7672,7 @@ public class RepeatDirective implements TemplateDirectiveModel {
<listitem xml:id="topic.defaultObjectWrapperIcI">
<para><literal>DefaultObjectWrapper</literal> has an
<literal>incompatibleImprovements</literal> property, that's
- highly recommended to set to 2.3.22 or higher (see the <link
+ highly recommended to set it to a high value (see the <link
xlink:href="http://freemarker.org/docs/api/freemarker/template/DefaultObjectWrapper.html#DefaultObjectWrapper-freemarker.template.Version-">API
documentation</link> for the effects). How to set it:</para>
@@ -7701,13 +7701,13 @@ public class RepeatDirective implements TemplateDirectiveModel {
<listitem>
<para>If you are using the builder API:</para>
- <programlisting role="unspecified">... = new DefaultObjectWrapperBuilder(Configuration.VERSION_2_3_25).build()</programlisting>
+ <programlisting role="unspecified">... = new DefaultObjectWrapperBuilder(Configuration.VERSION_2_3_27).build()</programlisting>
</listitem>
<listitem>
<para>Or, if you are using the constructor:</para>
- <programlisting role="unspecified">... = new DefaultObjectWrapper(Configuration.VERSION_2_3_25)</programlisting>
+ <programlisting role="unspecified">... = new DefaultObjectWrapper(Configuration.VERSION_2_3_27)</programlisting>
</listitem>
<listitem>
@@ -7716,7 +7716,7 @@ public class RepeatDirective implements TemplateDirectiveModel {
(<literal>*.properties</literal> file or
<literal>java.util.Properties</literal> object):</para>
- <programlisting role="unspecified">object_wrapper=DefaultObjectWrapper(2.3.25)</programlisting>
+ <programlisting role="unspecified">object_wrapper=DefaultObjectWrapper(2.3.27)</programlisting>
</listitem>
<listitem>
@@ -7728,7 +7728,7 @@ public class RepeatDirective implements TemplateDirectiveModel {
<programlisting role="unspecified"><init-param>
<param-name>object_wrapper</param-name>
- <param-value>DefaultObjectWrapper(2.3.25)</param-value>
+ <param-value>DefaultObjectWrapper(2.3.27)</param-value>
</init-param></programlisting>
</listitem>
</itemizedlist>
@@ -7889,7 +7889,7 @@ public class MyAppObjectWrapper extends DefaultObjectWrapper {
our object wrapper in:</para>
<programlisting role="unspecified">// Where you initialize the cfg *singleton* (happens just once in the application life-cycle):
-cfg = new Configuration(Configuration.VERSION_2_3_25);
+cfg = new Configuration(Configuration.VERSION_2_3_27);
...
cfg.setObjectWrapper(new MyAppObjectWrapper(cfg.getIncompatibleImprovements()));</programlisting>
@@ -7897,7 +7897,7 @@ cfg.setObjectWrapper(new MyAppObjectWrapper(cfg.getIncompatibleImprovements()));
<literal>java.util.Properties</literal> instead (and let's say it's
also a <literal>.properties</literal> file):</para>
- <programlisting role="unspecified">object_wrapper=com.example.myapp.freemarker.MyAppObjectWrapper(2.3.25)</programlisting>
+ <programlisting role="unspecified">object_wrapper=com.example.myapp.freemarker.MyAppObjectWrapper(2.3.27)</programlisting>
</section>
</section>
</chapter>
@@ -7961,7 +7961,7 @@ cfg.setObjectWrapper(new MyAppObjectWrapper(cfg.getIncompatibleImprovements()));
the configuration with the <literal>setSharedVariable</literal>
methods:</para>
- <programlisting role="unspecified">Configuration cfg = new Configuration(Configuration.VERSION_2_3_25);
+ <programlisting role="unspecified">Configuration cfg = new Configuration(Configuration.VERSION_2_3_27);
<replaceable>..</replaceable>.
cfg.setSharedVariable("warp", new WarpDirective());
cfg.setSharedVariable("company", "Foo Inc.");</programlisting>
@@ -8162,10 +8162,10 @@ cfg.setSharedVariable("company", "Foo Inc.");</programlisting>
the settings with the setter methods of the
<literal>Configuration</literal> object, fore example:</para>
- <programlisting role="unspecified">Configuration myCfg = new Configuration(Configuration.VERSION_2_3_25);
+ <programlisting role="unspecified">Configuration myCfg = new Configuration(Configuration.VERSION_2_3_27);
myCfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
myCfg.setDefaultEncoding("UTF-8");
-DefaultObjectWrapperBuilder owb = new DefaultObjectWrapperBuilder(Configuration.VERSION_2_3_25);
+DefaultObjectWrapperBuilder owb = new DefaultObjectWrapperBuilder(Configuration.VERSION_2_3_27);
owb.setForceLegacyNonListCollections(false);
owb.setDefaultDateType(TemplateDateModel.DATETIME);
myCfg.setObjectWrapper(owb.build());</programlisting>
@@ -8191,12 +8191,12 @@ myCfg.setObjectWrapper(owb.build());</programlisting>
class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">
<property name="freemarkerSettings">
<props>
- <prop key="incompatible_improvements">2.3.25</prop>
+ <prop key="incompatible_improvements">2.3.27</prop>
<prop key="template_exception_handler">rethrow</prop>
<prop key="default_encoding">UTF-8</prop>
<prop key="object_wrapper">
DefaultObjectWrapper(
- 2.3.25,
+ 2.3.27,
forceLegacyNonListCollections = false,
defaultDateType = freemarker.template.TemplateDateModel.DATETIME)
</prop>
@@ -8208,11 +8208,11 @@ myCfg.setObjectWrapper(owb.build());</programlisting>
which looks for a <literal>freemarker.properties</literal> in the
classpath:</para>
- <programlisting role="unspecified">incompatible_improvements=2.3.25
+ <programlisting role="unspecified">incompatible_improvements=2.3.27
template_exception_handler=rethrow
default_encoding=UTF-8
object_wrapper=DefaultObjectWrapper( \
- 2.3.25, \
+ 2.3.27, \
forceLegacyNonListCollections = false, \
defaultDateType = freemarker.template.TemplateDateModel.DATETIME)</programlisting>
@@ -10049,14 +10049,14 @@ cfg.setNumberFormat("@ua 0.####;; roundingMode=halfUp");</programlisting>
<literal>freemarker.template.Configuration</literal> object
like:</para>
- <programlisting role="unspecified">... = new Configuration(Configuration.VERSION_2_3_25)</programlisting>
+ <programlisting role="unspecified">... = new Configuration(Configuration.VERSION_2_3_27)</programlisting>
</listitem>
<listitem>
<para>Or, alter the <literal>Configuration</literal> singleton
where you initialize its other settings like:</para>
- <programlisting role="unspecified">cfg.setIncompatibleImprovements(Configuration.VERSION_2_3_25)</programlisting>
+ <programlisting role="unspecified">cfg.setIncompatibleImprovements(Configuration.VERSION_2_3_27)</programlisting>
</listitem>
<listitem>
@@ -10064,7 +10064,7 @@ cfg.setNumberFormat("@ua 0.####;; roundingMode=halfUp");</programlisting>
(<literal>*.properties</literal> file or
<literal>java.util.Properties</literal> object), add:</para>
- <programlisting role="unspecified">incompatible_improvements=2.3.25</programlisting>
+ <programlisting role="unspecified">incompatible_improvements=2.3.27</programlisting>
</listitem>
<listitem>
@@ -10075,7 +10075,7 @@ cfg.setNumberFormat("@ua 0.####;; roundingMode=halfUp");</programlisting>
<programlisting role="unspecified"><init-param>
<param-name>incompatible_improvements</param-name>
- <param-value>2.3.25</param-value>
+ <param-value>2.3.27</param-value>
</init-param></programlisting>
</listitem>
</itemizedlist>
@@ -11281,7 +11281,7 @@ TemplateHashModel roundingModeEnums =
<!-- FreeMarker engine settings: -->
<init-param>
<param-name>incompatible_improvements</param-name>
- <param-value>2.3.25</param-value>
+ <param-value>2.3.27</param-value>
<!--
Recommended to set to a high value.
See: http://freemarker.org/docs/pgui_config_incompatible_improvements.html
[3/3] incubator-freemarker git commit: Merge remote-tracking branch
'origin/2.3-gae' into 2.3
Posted by dd...@apache.org.
Merge remote-tracking branch 'origin/2.3-gae' into 2.3
Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/commit/9459a40c
Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/tree/9459a40c
Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/diff/9459a40c
Branch: refs/heads/2.3
Commit: 9459a40cb5a248c395eae1dc041ae61cc0873971
Parents: a86146b 17c3d4e
Author: ddekany <dd...@apache.org>
Authored: Sat Sep 30 12:45:37 2017 +0200
Committer: ddekany <dd...@apache.org>
Committed: Sat Sep 30 12:45:37 2017 +0200
----------------------------------------------------------------------
.../freemarker/template/SimpleCollection.java | 21 +++++++++--
src/manual/en_US/book.xml | 38 ++++++++++----------
2 files changed, 37 insertions(+), 22 deletions(-)
----------------------------------------------------------------------
[2/3] incubator-freemarker git commit: Fixed binary compatibility
mistake.
Posted by dd...@apache.org.
Fixed binary compatibility mistake.
Project: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/commit/17c3d4e5
Tree: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/tree/17c3d4e5
Diff: http://git-wip-us.apache.org/repos/asf/incubator-freemarker/diff/17c3d4e5
Branch: refs/heads/2.3
Commit: 17c3d4e50bb01716609473c0e68972876c84dae1
Parents: a367195
Author: ddekany <dd...@apache.org>
Authored: Sat Sep 30 12:45:09 2017 +0200
Committer: ddekany <dd...@apache.org>
Committed: Sat Sep 30 12:45:09 2017 +0200
----------------------------------------------------------------------
.../freemarker/template/SimpleCollection.java | 21 +++++++++++++++++---
1 file changed, 18 insertions(+), 3 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/incubator-freemarker/blob/17c3d4e5/src/main/java/freemarker/template/SimpleCollection.java
----------------------------------------------------------------------
diff --git a/src/main/java/freemarker/template/SimpleCollection.java b/src/main/java/freemarker/template/SimpleCollection.java
index b29c110..46e8671 100644
--- a/src/main/java/freemarker/template/SimpleCollection.java
+++ b/src/main/java/freemarker/template/SimpleCollection.java
@@ -55,9 +55,7 @@ implements TemplateCollectionModel, Serializable {
}
/**
- * @param iterable Note that this was a {@link Collection} before 2.3.27, not an {@link Iterable}
- *
- * @deprecated Use {@link #SimpleCollection(Iterable, ObjectWrapper)}
+ * @deprecated Use {@link #SimpleCollection(Iterable, ObjectWrapper)} instead.
*/
@Deprecated
public SimpleCollection(Iterable iterable) {
@@ -65,6 +63,23 @@ implements TemplateCollectionModel, Serializable {
iterator = null;
}
+ /**
+ * Same as {@link SimpleCollection#SimpleCollection(Iterable)}; kept for binary compatibility.
+ *
+ * @deprecated Use {@link #SimpleCollection(Iterable, ObjectWrapper)} instead.
+ */
+ @Deprecated
+ public SimpleCollection(Collection collection) {
+ this((Iterable) collection);
+ }
+
+ /**
+ * Same as {@link SimpleCollection#SimpleCollection(Iterable, ObjectWrapper)}; kept for binary compatibility.
+ */
+ public SimpleCollection(Collection collection, ObjectWrapper wrapper) {
+ this((Iterable) collection, wrapper);
+ }
+
public SimpleCollection(Iterator iterator, ObjectWrapper wrapper) {
super(wrapper);
this.iterator = iterator;