update removals & deprecations for graph references #1315
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Comment on lines
749
to
760
| | In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated in versions 5.26 to 2025.05 unless the `.` is used to indicate that the database or alias belongs to a composite database. | ||
|
|
||
| However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations. | ||
| The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25. | ||
| For more information, see: | ||
|
|
||
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references] | ||
|
|
||
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[update to graph functions] | ||
|
|
||
| * xref::values-and-types/graph-references.adoc#rules[graph reference rules] | ||
|
|
There was a problem hiding this comment.
Suggested change
| | In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated in versions 5.26 to 2025.05 unless the `.` is used to indicate that the database or alias belongs to a composite database. | |
| However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations. | |
| The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25. | |
| For more information, see: | |
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references] | |
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[update to graph functions] | |
| * xref::values-and-types/graph-references.adoc#rules[graph reference rules] | |
| a| The use of unquoted `.` characters in xref:clauses/use.adoc[`USE`] clauses when specifying databases and aliases was deprecated in 5.26, except when `.` indicated that the database or alias belonged to a composite database. | |
| However, this deprecation was withdrawn in Neo4j 2025.06, and replaced by the following updates in Cypher 25: | |
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Removed support for quoted name parts in graph references] | |
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Update to graph functions] | |
| This because the previous quoting rules were inconsistent and ambiguous. | |
| The rules are clarified and improved in Cypher 25. | |
| For more information, see: | |
| * xref::values-and-types/graph-references.adoc#rules[Graph reference rules] |
Comment on lines
3379
to
3388
| Creating a database with dots in the name has been deprecated in versions 5.26 to 2025.05. | ||
| However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations. | ||
| The reason for this change is that the previous quoting rules have been found inconsistent and ambiguous, and will be improved starting from Cypher 25. | ||
| For more information, see: | ||
|
|
||
| [source, cypher, role="noheader"] | ||
| ---- | ||
| CREATE DATABASE `databaseName.withDot` ... | ||
| ---- | ||
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[removed support for quoted name parts in graph references] | ||
|
|
||
| * xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[update to graph functions] | ||
|
|
||
| * xref::values-and-types/graph-references.adoc#rules[graph reference rules] |
There was a problem hiding this comment.
Creating a database with . characters was deprecated in 5.0.
However, this deprecation was withdrawn in 2025.06, and replaced by the following updates in Cypher 25:
- xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_removed_name_parts_quoting[Removed support for quoted name parts in graph references]
- xref::deprecations-additions-removals-compatibility.adoc#_graph_reference_updated_graph_by_name_quotes[Update to graph functions]
This because the previous quoting rules were inconsistent and ambiguous.
The rules are clarified and improved in Cypher 25.
For more information, see:
- xref::values-and-types/graph-references.adoc#rules[Graph reference rules]
| For example, `USE `my.db`` is valid. | ||
| | In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated in versions 5.26 to 2025.05 unless the `.` is used to indicate that the database or alias belongs to a composite database. | ||
|
|
||
| However, starting from version 2025.06, this deprecation has been withdrawn, and replaced by two new deprecations. |
There was a problem hiding this comment.
None of the links point to a change marked as a deprecation
JPryce-Aklundh
approved these changes
Jun 24, 2025
|
Thanks for the documentation updates. The preview documentation has now been torn down - reopening this PR will republish it. |
JPryce-Aklundh
added a commit
that referenced
this pull request
Jun 24, 2025
see also: neo4j/docs-status-codes#340 --------- Co-authored-by: Jens Pryce-Åklundh <[email protected]>
JPryce-Aklundh
added a commit
that referenced
this pull request
Jun 24, 2025
see also: * #1315 * https://github.com/neo4j/docs-status-codes/pull/340/files * #1295 --------- Co-authored-by: Jens Pryce-Åklundh <[email protected]>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
see also: neo4j/docs-status-codes#340