Skip to content

Commit fd51c2e

Browse files
committed
Documented JEP-12 legacy syntax deprecation.
1 parent e1a6909 commit fd51c2e

File tree

1 file changed

+9
-0
lines changed

1 file changed

+9
-0
lines changed

GRAMMAR.ABNF

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -650,6 +650,15 @@ literal = "`" json-text "`" ;; # Literal Expressions
650650
;; literal values. Note that the \` character must now be escaped in a json-value which means implementations need to
651651
;; handle this case before passing the resulting string to a JSON parser.
652652
;;
653+
;; ```note
654+
;; When [JEP-12](https://github.com/jmespath-community/jmespath.spec/blob/main/jep-012-raw-string-literals.md) was introduced,
655+
;; the `literal` rule has been changed to more strictly follow the JSON specification.
656+
;; As a result, the _legacy_ syntax using strings with elided quotes `` `foo` `` was being deprecated and users
657+
;; were encouraged to either use `raw-string` literals or use the more compliant `` `"foo"` `` syntax instead.
658+
;;
659+
;; In this version of the specification, _legacy_ syntax is now fully deprecated.
660+
;; ```
661+
;;
653662
;; ## Examples
654663
;; ```
655664
;; search(`"foo"`, "anything") -> "foo"

0 commit comments

Comments
 (0)