From b853d0a6728294346b943deb370687ceb6cd4d52 Mon Sep 17 00:00:00 2001 From: Mark Dixon <1756429+mnd999@users.noreply.github.com> Date: Mon, 11 Nov 2024 11:03:08 +0000 Subject: [PATCH] Document old deprecation for database naming Database names containing `.` have been deprecated since 5.0, and this has been documented in the operations manual. Document it here also for consistency. --- modules/ROOT/pages/syntax/naming.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/ROOT/pages/syntax/naming.adoc b/modules/ROOT/pages/syntax/naming.adoc index 6038ca3db..4f70b12f7 100644 --- a/modules/ROOT/pages/syntax/naming.adoc +++ b/modules/ROOT/pages/syntax/naming.adoc @@ -27,8 +27,8 @@ For example, `MATCH ( a ) RETURN a` is equivalent to `MATCH (a) RETURN a`. === Using special characters in names Non-alphabetic characters, including numbers, symbols and whitespace characters, *can* be used in names, but *must* be escaped using backticks. For example: `++`^n`++`, `++`1first`++`, `++`$$n`++`, and `++`my variable has spaces`++`. -Database names are an exception and may include dots without the need for escaping. -For example: naming a database `foo.bar.baz` is perfectly valid. +Database names are an exception and may include dots without the need for escaping, although this behavior is deprecated as it may introduce ambiguity when addressing composite databases. +For example: naming a database `foo.bar.baz` is valid, but deprecated. `++`foo.bar.baz`++` is valid. Within an escaped name, the following escaping sequences are allowed: