Deprecate prefer and avoid

metaborg · Oct 8, 2020 · f613417 · f613417
1 parent 5b2be0d
commit f613417
Show file tree

Hide file tree

Showing 2 changed files with 10 additions and 1 deletion.
diff --git a/source/langdev/meta/lang/sdf3/reference.rst b/source/langdev/meta/lang/sdf3/reference.rst
@@ -453,7 +453,7 @@ The following syntax-related attributes exist:
 -  ``left``, ``right``, ``non-assoc``, ``assoc`` are disambiguation
    constructs used to define the associativity of productions. See
    associativity_.
--  ``prefer`` and ``avoid`` are disambiguation constructs to define
+-  ``prefer`` and ``avoid`` are **deprecated** disambiguation constructs to define
    preference of one derivation over others. See preferences_.
 -  ``reject`` is a disambiguation construct that implements language
    difference. It is used for keyword reservation. See rejections_.
@@ -690,6 +690,10 @@ a post parse filter to parse forests. The attributes ``prefer``
 and ``avoid`` are the only disambiguation constructs that compare
 alternative derivations after parsing.
 
+.. warning::
+
+  ``prefer`` and ``avoid`` are deprecated and will be removed in a future version of Spoofax.
+
 The following definition assumes that derivations are represented using
 parse forests with "packaged ambiguity nodes". This means that whenever
 in a derivation there is a choice for several sub-derivations, at that

diff --git a/source/release/note/vnext.rst b/source/release/note/vnext.rst
@@ -30,6 +30,11 @@ Statix
 
 Analysis times of large, multi-file Statix specifications has improved significantly.
 
+SDF3
+~~~~
+
+``prefer`` and ``avoid`` are now deprecated. Usages of the operators will be marked with a deprecation warning.
+
 Eclipse
 ~~~~~~~