diff --git a/cypher/cypher-docs/src/docs/dev/deprecations-additions-and-compatibility.asciidoc b/cypher/cypher-docs/src/docs/dev/deprecations-additions-and-compatibility.asciidoc index 343b7adbb0a..dccbc2e14e0 100644 --- a/cypher/cypher-docs/src/docs/dev/deprecations-additions-and-compatibility.asciidoc +++ b/cypher/cypher-docs/src/docs/dev/deprecations-additions-and-compatibility.asciidoc @@ -7,58 +7,79 @@ Cypher is a language that is constantly evolving. New features get added to the language continuously, and occasionally, some features become deprecated and are subsequently removed. -- -* <> - ** <> - ** <> - ** <> - ** <> - ** <> -* <> -* <> +This section list all of the features that have been removed, deprecated, added, or extended in different Cypher versions. +Replacement syntax for deprecated and removed features are also indicated. -[[cypher-deprecations-additions-removals]] -== Removals, deprecations, additions and extensions +[[cypher-deprecations-additions-removals-3.5]] +== Version 3.5 -The following tables lists all the features which have been removed, deprecated, added or extended in Cypher. -Replacement syntax for deprecated and removed features are also indicated. +=== Deprecated features +[cols="2", options="header"] +|=== +| Feature +| Details + +a| +label:functionality[] +label:deprecated[] + +Compiled runtime: +[source, cypher, role="noheader"] +---- +CYPHER runtime=compiled +---- +a| +The compiled runtime will be discontinued in the next major release. It might still be used for default queries in order to not cause regressions, but explicitly requesting it will not be possible. -[[cypher-deprecations-additions-removals-3.0]] -=== Version 3.0 +a| +label:function[] +label:deprecated[] +[source, cypher, role="noheader"] +---- +extract() +---- +a| +Replaced by <>. + +a| +label:function[] +label:deprecated[] +[source, cypher, role="noheader"] +---- +filter() +---- +a| +Replaced by <>. +|=== + +[[cypher-deprecations-additions-removals-3.4]] +=== Version 3.4 [options="header"] |=== | Feature | Type | Change | Details -| `has()` | Function | Removed | Replaced by <> -| `str()` | Function | Removed | Replaced by <> -| `+{parameter}+` | Syntax | Deprecated | Replaced by <> -| <> | Function | Added | -| <> | Clause | Added | -| <> | Function | Added | -| <> | Function | Added | -| <> | Function | Added | -| <> | Functionality | Added | -| <> | Function | Extended | Now also allows Boolean values as input +| <> | Functionality | Amendment | A point -- irrespective of which Coordinate Reference System is used -- can be stored as a property and is able to be backed by an index. Prior to this, a point was a virtual property only. +| <> | Function | Added | +| <> | Function | Added | +| <> | Function | Added | +| <> | Functionality | Added | Supports storing, indexing and working with the following temporal types: Date, Time, LocalTime, DateTime, LocalDateTime and Duration. +| <> | Functionality | Added | Functions allowing for the creation and manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_. +| <> | Functionality | Added | Operators allowing for the manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_. +| <> | Function | Extended | Now also allows temporal values as input (i.e. values of type _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ or _Duration_). |=== - -[[cypher-deprecations-additions-removals-3.1]] -=== Version 3.1 +[[cypher-deprecations-additions-removals-3.3]] +=== Version 3.3 [options="header"] |=== | Feature | Type | Change | Details -| `rels()` | Function | Deprecated | Replaced by <> -| `toInt()` | Function | Deprecated | Replaced by <> -| `lower()` | Function | Deprecated | Replaced by <> -| `upper()` | Function | Deprecated | Replaced by <> -| <> | Function | Added | -| <> | Syntax | Added | -| <> | Syntax | Added | -| <> | Functionality | Added | -| <> | Clause | Extended | Records returned by `YIELD` may be filtered further using `WHERE` +| `START` | Clause | Removed | As in Cypher 3.2, any queries using the `START` clause will revert back to Cypher 3.1 `planner=rule`. +However, there are <> for accessing explicit indexes that will enable users to use the current version of Cypher and the cost planner together with these indexes. +An example of this is `CALL db.index.explicit.searchNodes('my_index','email:me*')`. +| `CYPHER runtime=slotted` (Faster interpreted runtime) | Functionality | Added | Neo4j Enterprise Edition only +| <>, <> | Function | Extended | Now also supports aggregation over sets containing lists of strings and/or numbers, as well as over sets containing strings, numbers, and lists of strings and/or numbers |=== - [[cypher-deprecations-additions-removals-3.2]] === Version 3.2 [options="header"] @@ -79,42 +100,38 @@ Replacement syntax for deprecated and removed features are also indicated. | <>, <> | Function | Extended | Now also supports aggregation over a set containing both strings and numbers |=== - -[[cypher-deprecations-additions-removals-3.3]] -=== Version 3.3 +[[cypher-deprecations-additions-removals-3.1]] +=== Version 3.1 [options="header"] |=== | Feature | Type | Change | Details -| `START` | Clause | Removed | As in Cypher 3.2, any queries using the `START` clause will revert back to Cypher 3.1 `planner=rule`. -However, there are <> for accessing explicit indexes that will enable users to use the current version of Cypher and the cost planner together with these indexes. -An example of this is `CALL db.index.explicit.searchNodes('my_index','email:me*')`. -| `CYPHER runtime=slotted` (Faster interpreted runtime) | Functionality | Added | Neo4j Enterprise Edition only -| <>, <> | Function | Extended | Now also supports aggregation over sets containing lists of strings and/or numbers, as well as over sets containing strings, numbers, and lists of strings and/or numbers +| `rels()` | Function | Deprecated | Replaced by <> +| `toInt()` | Function | Deprecated | Replaced by <> +| `lower()` | Function | Deprecated | Replaced by <> +| `upper()` | Function | Deprecated | Replaced by <> +| <> | Function | Added | +| <> | Syntax | Added | +| <> | Syntax | Added | +| <> | Functionality | Added | +| <> | Clause | Extended | Records returned by `YIELD` may be filtered further using `WHERE` |=== -[[cypher-deprecations-additions-removals-3.4]] -=== Version 3.4 -[options="header"] -|=== -| Feature | Type | Change | Details -| <> | Functionality | Amendment | A point -- irrespective of which Coordinate Reference System is used -- can be stored as a property and is able to be backed by an index. Prior to this, a point was a virtual property only. -| <> | Function | Added | -| <> | Function | Added | -| <> | Function | Added | -| <> | Functionality | Added | Supports storing, indexing and working with the following temporal types: Date, Time, LocalTime, DateTime, LocalDateTime and Duration. -| <> | Functionality | Added | Functions allowing for the creation and manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_. -| <> | Functionality | Added | Operators allowing for the manipulation of values for each temporal type -- _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ and _Duration_. -| <> | Function | Extended | Now also allows temporal values as input (i.e. values of type _Date_, _Time_, _LocalTime_, _DateTime_, _LocalDateTime_ or _Duration_). -|=== +[[cypher-deprecations-additions-removals-3.0]] +=== Version 3.0 -[[cypher-deprecations-additions-removals-3.5]] -=== Version 3.5 [options="header"] |=== | Feature | Type | Change | Details -| `CYPHER runtime=compiled` (Compiled runtime) | Functionality | Deprecated | The compiled runtime will be discontinued in the next major release. It might still be used for default queries in order to not cause regressions, but explicitly requesting it will not be possible. -| `extract()` | Function | Deprecated | Replaced by <> -| `filter()` | Function | Deprecated | Replaced by <> +| `has()` | Function | Removed | Replaced by <> +| `str()` | Function | Removed | Replaced by <> +| `+{parameter}+` | Syntax | Deprecated | Replaced by <> +| <> | Function | Added | +| <> | Clause | Added | +| <> | Function | Added | +| <> | Function | Added | +| <> | Function | Added | +| <> | Functionality | Added | +| <> | Function | Extended | Now also allows Boolean values as input |=== [[cypher-compatibility]]