add deprecation for graph function string arguments

Author: nadja-muller

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

@@ -152,6 +152,25 @@ Several  xref:clauses/transaction-clauses.adoc#query-listing-transactions[`SHOW
 * `startTime` and `currentQueryStartTime` now return a `ZONED DATETIME` instead of a `STRING` representation of a temporal value.
 * `clientAddress` and `outerTransactionId` now return `null` instead of an empty `STRING` when unavailable.
 * The current query-related columns — `currentQuery`, `currentQueryId`, `parameters`, `planner`, `runtime`, `indexes`, `currentQueryStartTime`, `currentQueryElapsedTime`, `currentQueryCpuTime`, `currentQueryIdleTime`, and `currentQueryStatus` — now return `null` when no query is executing.
+
+a|
+label:functionality[]
+label:deprecated[]
+[source, cypher, role="noheader"]
+----
+USE graph.byName('tom`s-database')
+USE graph.propertiesByName('database.with.dot')
+----
+|  The xref::queries/expressions.adoc#graphreferences[graph references] expressed in the passed arguments of the functions xref:functions/graph.adoc#functions-graph-byname[`graph.byName`] and xref:functions/graph.adoc#functions-graph-propertiesByName[`graph.propertiesByName`] are parsed as static references in Cypher 25.
+Graph name parts that contain unsupported characters for unescaped identifiers require backtick escaping.
+Graph name parts with special characters may require additional escaping of those characters:
+
+* `++USE graph.byName('`tom``s-database`')++`
+
+* `++USE graph.propertiesByName('database.with.dot')++`
+
+Note that escaping graph names within the graph functions string argument is not supported in Cypher 5.
+
 |===
 
 === New features