Merge pull request #121 from sempare/dev

v1.6.2 release

boss.json

@@ -1,7 +1,7 @@
 {
 	"name": "Sempare Template Engine",
 	"description": "Sempare Template Engine for Delphi allows for flexible text manipulation. It can be used for generating email, html, source code, xml, configuration, etc.",
-	"version": "1.6.0",
+	"version": "1.6.2",
 	"homepage": "https://github.com/sempare/sempare-delphi-template-engine",
 	"mainsrc": "./src/",
 	"projects": [],

docs/configuration.md

@@ -15,6 +15,8 @@ Copyright (c) 2019-2023 [Sempare Limited](http://www.sempare.ltd)
 - [Dynamic Template Resolution](#Dynamic_Template_Resolution)
 - [Ignoring Whitespace With Multi-Line Statements](#Ignoring_Whitespace_With_Multi_Line_Statements)
 - [Options](#Options)
+- [Decimal Separators](#Decimal_Separators)
+- [Value Separators](#Value_Separators)
 
 # Overview
 
@@ -159,3 +161,30 @@ The template engine allows for the following options:
   - strip any empty lines
 - eoPrettyPrint
   - use to review the parsed structure. output is to the console.
+
+### Decimal Separators
+
+Numbers are commonly formatted using comma and decimal point. e.g. 123.45
+
+However, in some regions, such as Germany, it the coma may be preferred. e.g. 123,45
+
+In order to accomodate this, the context configuration has a DecimalSeparator. These default based on locale.
+
+The DecimalSeparator may be set to '.' or ','. 
+
+### Value Separators
+
+The ValueSeparator may be set to ',' or ';'. It must be explicity set.
+
+The motivation for the behaviour is to avoid any confusion with decimal separators.
+```
+<% Add(1.23 , 4.56) %>
+```
+When the DecimalSeparator is ',', then the ValueSeparator becomes ';' as illustrated:
+```
+<% Add(1,23 ; 4,56) %>
+```
+However, the following does work:
+```
+<% Add(1,23 , 4,56) %>
+```

docs/debugging.md

@@ -10,3 +10,11 @@ writeln(Template.PrettyPrint(Template.Parse('<%if true%>true<%else%>false<%end%>
 ```
 
 Use the _eoPrettyPrint_ option on the _context_ to enable when evaluating or parsing a template.
+
+## Strange parser errors
+
+Parser errors could come from one of two locations:
+- the lexer - the code that breaks the stream into tokens
+- the parser - the code that validates that the tokens are in the correct order according to the gramatical rules
+
+