Change the literal delimiter to the vertical pipe character. (#359)

Closes #263.

Author: stasm

spec/formatting.md

@@ -44,7 +44,7 @@ These are divided into the following categories:
   ```
 
   ```
-  let $var = {(no message body)}
+  let $var = {|no message body|}
   ```
 
 - **Data Model errors** occur when a message is invalid due to
@@ -112,11 +112,11 @@ These are divided into the following categories:
     does not provide for the function `:func` to be successfully resolved:
 
     ```
-    {The value is {(horse) :func}.}
+    {The value is {|horse| :func}.}
     ```
 
     ```
-    match {(horse) :func}
+    match {|horse| :func}
     when 1 {The value is one.}
     when * {The value is not one.}
     ```
@@ -130,13 +130,13 @@ These are divided into the following categories:
     uses a `:plural` selector function which requires its input to be numeric:
 
     ```
-    match {(horse) :plural}
+    match {|horse| :plural}
     when 1 {The value is one.}
     when * {The value is not one.}
     ```
 
     ```
-    let $sel = {(horse) :plural}
+    let $sel = {|horse| :plural}
     match {$sel}
     when 1 {The value is one.}
     when * {The value is not one.}
@@ -157,7 +157,7 @@ These are divided into the following categories:
      an option `field` to be provided with a string value,
 
   ```
-  {Hello, {(horse) :get field=name}!}
+  {Hello, {|horse| :get field=name}!}
   ```
 
   ```
@@ -211,11 +211,11 @@ always starts with U+007B LEFT CURLY BRACKET `{`
 and ends with U+007D RIGHT CURLY BRACKET `}`.
 Between the brackets, the following contents are used:
 
-- Expression with Literal Operand: U+0028 LEFT PARENTHESIS `(`
+- Expression with Literal Operand: U+007C VERTICAL LINE `|`
   followed by the value of the Literal,
-  and then by U+0029 RIGHT PARENTHESIS `)`
+  and then by U+007C VERTICAL LINE `|`
 
-  Examples: `{(horse)}`, `{(42)}`
+  Examples: `{|horse|}`, `{|42|}`
 
 - Expression with Variable Operand: U+0024 DOLLAR SIGN `$`
   followed by the Variable Name of the Operand
@@ -249,17 +249,17 @@ For example, attempting to format either of the following messages within a cont
 does not provide for the function `:func` to be successfully resolved:
 
 ```
-let $var = {(horse) :func}
+let $var = {|horse| :func}
 {The value is {$var}.}
 ```
 
 ```
-let $var = {(horse)}
+let $var = {|horse|}
 {The value is {$var :func}.}
 ```
 
 would result in both cases with this formatted string representation:
 
 ```
-The value is {(horse)}.
+The value is {|horse|}.
 ```

spec/message.abnf

@@ -32,9 +32,9 @@ text-char = %x0-5B         ; omit \
           / %xE000-10FFFF
 
 literal = "(" *(literal-char / literal-escape) ")"
-literal-char = %x0-27         ; omit ( and )
-             / %x2A-5B        ; omit \
-             / %x5D-D7FF      ; omit surrogates
+literal-char = %x0-5B         ; omit \
+             / %x5D-7B        ; omit |
+             / %x7D-D7FF      ; omit surrogates
              / %xE000-10FFFF
 
 variable = "$" name
@@ -53,7 +53,7 @@ name-char = name-start / DIGIT / "-" / "." / %xB7
           / %x0300-036F / %x203F-2040
 
 text-escape    = backslash ( backslash / "{" / "}" )
-literal-escape = backslash ( backslash / "(" / ")" )
+literal-escape = backslash ( backslash / "|" )
 backslash      = %x5C ; U+005C REVERSE SOLIDUS "\"
 
 s = 1*( SP / HTAB / CR / LF )

spec/syntax.md

@@ -372,19 +372,15 @@ option = name [s] "=" [s] (literal / nmtoken / variable)
 Examples:
 
 ```
-(1.23)
+|1.23|
 ```
 
 ```
-(1.23) :number maxFractionDigits=1
+|1.23| :number maxFractionDigits=1
 ```
 
 ```
-(1970-01-01T13:37:00.000Z) :datetime weekday=long
-```
-
-```
-(Thu Jan 01 1970 14:37:00 GMT+0100 \(CET\)) :datetime weekday=long
+|Thu Jan 01 1970 14:37:00 GMT+0100 (CET)| :datetime weekday=long
 ```
 
 ```
@@ -433,7 +429,7 @@ when  = %x77.68.65.6E     ; "when"
 _Text_ is the translatable content of a _pattern_, and _Literal_ is used for matching
 variants and providing input to expressions.
 Any Unicode code point is allowed in either, with the exception of
-the relevant delimiters (`{` and `}` for Text, `(` and `)` for Literal),
+the relevant delimiters (`{` and `}` for Text, `|` for Literal),
 `\` (which starts an escape sequence), and
 surrogate code points U+D800 through U+DBFF (which cannot be encoded into UTF-8).
 
@@ -450,9 +446,9 @@ text-char = %x0-5B         ; omit \
 
 ```abnf
 literal = "(" *(literal-char / literal-escape) ")"
-literal-char = %x0-27         ; omit ( and )
-             / %x2A-5B        ; omit \
-             / %x5D-D7FF      ; omit surrogates
+literal-char = %x0-5B         ; omit \
+             / %x5D-7B        ; omit |
+             / %x7D-D7FF      ; omit surrogates
              / %xE000-10FFFF
 ```
 
@@ -501,7 +497,7 @@ They are allowed in translatable text as well as in literals.
 
 ```abnf
 text-escape    = backslash ( backslash / "{" / "}" )
-literal-escape = backslash ( backslash / "(" / ")" )
+literal-escape = backslash ( backslash / "|" )
 backslash      = %x5C ; U+005C REVERSE SOLIDUS "\"
 ```