From ddc8aa6425fd3a65aad9c85a48ff81bea65385f3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Nadja=20M=C3=BCller?=
 <73830555+nadja-muller@users.noreply.github.com>
Date: Tue, 7 Jan 2025 15:26:22 +0100
Subject: [PATCH] document deprecation of graph names with unesacped dots in
 USE clauses (#1145)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-authored-by: Jens Pryce-Åklundh <112686610+JPryce-Aklundh@users.noreply.github.com>
---
 ...eprecations-additions-removals-compatibility.adoc | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
index 50047fdc6..1b97862d8 100644
--- a/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
+++ b/modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc
@@ -150,6 +150,18 @@ CREATE DATABASE db OPTIONS { storeFormat: 'high_limit' }
 | The `standard` and `high_limit` store formats have been deprecated.
 Creating databases with these formats is therefore also deprecated.
 For more information on the deprecation of these formats, see link:{neo4j-docs-base-uri}/operations-manual/{page-version}/database-internals/store-formats/#format-deprecations[Store formats -> Format deprecations].
+
+a|
+label:functionality[]
+label:deprecated[]
+[source, cypher, role="noheader"]
+----
+USE my.db ...
+
+----
+| In xref:clauses/use.adoc[`USE`] clauses, databases and aliases with unquoted `.` are deprecated unless the `.` is used to indicate that the database or alias belongs to a composite database.
+Names containing `.` should be quoted using backticks. 
+For example, `USE `my.db`` is valid.
 |===