Skip to content

Commit 743d09d

Browse files
Improved explaination of legacy syntax and its deprecation.
Co-authored-by: Richard Gibson <[email protected]>
1 parent fd51c2e commit 743d09d

File tree

1 file changed

+6
-5
lines changed

1 file changed

+6
-5
lines changed

GRAMMAR.ABNF

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -651,12 +651,13 @@ literal = "`" json-text "`" ;; # Literal Expressions
651651
;; handle this case before passing the resulting string to a JSON parser.
652652
;;
653653
;; ```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.
654+
;; When [JEP-12](https://github.com/jmespath-community/jmespath.spec/blob/main/jep-012-raw-string-literals.md)
655+
;; introduced raw string literals, a legacy behavior in which backtick literals
656+
;; containing invalid JSON text would be interpreted as if their contents were wrapped
657+
;; in double quotes (e.g., `` `foo` == `"foo"` ``) was deprecated but implementations
658+
;; were allowed to continue supporting it.
658659
;;
659-
;; In this version of the specification, _legacy_ syntax is now fully deprecated.
660+
;; In this version of the specification, that behavior has been fully removed.
660661
;; ```
661662
;;
662663
;; ## Examples

0 commit comments

Comments
 (0)