You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@velocity.apache.org by "Cesar Alvernaz (Jira)" <ji...@apache.org> on 2022/11/09 08:51:00 UTC

[jira] [Updated] (VELOCITY-960) Documentation inconsistency for use of dashes on identifiers

     [ https://issues.apache.org/jira/browse/VELOCITY-960?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Cesar Alvernaz updated VELOCITY-960:
------------------------------------
    Description: 
Regarding the use of dashes on identifiers, the documentation doesn't look consistent. Which one is recommended? 

[Here|https://velocity.apache.org/engine/2.3/configuration.html] states the following:

*{{parser.allow_hyphen_in_identifiers = false}}*
{quote}This is a backward compatibility option, false by default, which allows the '{*}{{-}}{*}' character inside variable identifiers (available since 2.1). If enabled, be warned that you will have to surround the mathematical minus sign with spaces for it to be correctly interpreted.
{quote}
 

But [here|https://velocity.apache.org/engine/2.3/vtl-reference.html], the configuration is different: 
{quote}{{If the *parser.allows.dash.identifiers*}} configuration value is set to true, then the *-* dash is also allowed in identifiers (and must be surrounded by spaces to be interpreted as an arithmetic minus operator).}}
{quote}

  was:
Regarding the use of dashes on identifiers, the documentation doesn't look consistent. Which one is recommended? 

[Here|[https://velocity.apache.org/engine/2.3/configuration.html]] states the following:

*{{parser.allow_hyphen_in_identifiers = false}}*
{quote}This is a backward compatibility option, false by default, which allows the '{*}{{-}}{*}' character inside variable identifiers (available since 2.1). If enabled, be warned that you will have to surround the mathematical minus sign with spaces for it to be correctly interpreted.
{quote}
 

But [here|[https://velocity.apache.org/engine/2.3/vtl-reference.html]], the configuration is different: 
{quote}{{If the {{*parser.allows.dash.identifiers*}} configuration value is set to true, then the *-* dash is also allowed in identifiers (and must be surrounded by spaces to be interpreted as an arithmetic minus operator).}}
{quote}

         Labels: doc  (was: )

> Documentation inconsistency for use of dashes on identifiers 
> -------------------------------------------------------------
>
>                 Key: VELOCITY-960
>                 URL: https://issues.apache.org/jira/browse/VELOCITY-960
>             Project: Velocity
>          Issue Type: Bug
>            Reporter: Cesar Alvernaz
>            Priority: Major
>              Labels: doc
>
> Regarding the use of dashes on identifiers, the documentation doesn't look consistent. Which one is recommended? 
> [Here|https://velocity.apache.org/engine/2.3/configuration.html] states the following:
> *{{parser.allow_hyphen_in_identifiers = false}}*
> {quote}This is a backward compatibility option, false by default, which allows the '{*}{{-}}{*}' character inside variable identifiers (available since 2.1). If enabled, be warned that you will have to surround the mathematical minus sign with spaces for it to be correctly interpreted.
> {quote}
>  
> But [here|https://velocity.apache.org/engine/2.3/vtl-reference.html], the configuration is different: 
> {quote}{{If the *parser.allows.dash.identifiers*}} configuration value is set to true, then the *-* dash is also allowed in identifiers (and must be surrounded by spaces to be interpreted as an arithmetic minus operator).}}
> {quote}



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@velocity.apache.org
For additional commands, e-mail: dev-help@velocity.apache.org