aboutsummaryrefslogtreecommitdiff
path: root/velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java
diff options
context:
space:
mode:
Diffstat (limited to 'velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java')
-rw-r--r--velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java20
1 files changed, 15 insertions, 5 deletions
diff --git a/velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java b/velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java
index 9b640e8d..89d3c41f 100644
--- a/velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java
+++ b/velocity-engine-core/src/main/java/org/apache/velocity/runtime/RuntimeConstants.java
@@ -331,11 +331,21 @@ public interface RuntimeConstants extends DeprecatedRuntimeConstants
String VM_ARGUMENTS_STRICT = "velocimacro.arguments.strict";
/**
- * When displaying null or invalid non-quiet references, use the argument literal reference
- * instead of the one in the macro block. Defaults to false.
- * @since 2.1
- **/
- String VM_PRESERVE_ARGUMENTS_LITERALS = "velocimacro.arguments.preserve_literals";
+ * This flag enable the 1.7 backward compatible mode for velocimacros (defaults to false):
+ * <ul>
+ * <li>
+ * preserve argument literals: when displaying null or invalid non-quiet references,
+ * use the argument literal reference instead of the one in the macro block. Defaults to false.
+ * </li>
+ * <li>
+ * use global values for missing arguments: when calling a macro with fewer arguments than declared,
+ * if those arguments don't have an explicit default value in the macro definition, default values will
+ * be looked for in the global context
+ * </li>
+ * </ul>
+ * @since 2.2
+ */
+ String VM_ENABLE_BC_MODE = "velocimacro.enable_bc_mode";
/**
* Specify the maximum depth for macro calls