Merge branch 'dev' into clarify_basic_delete

Author: JPryce-Aklundh

antora.yml

@@ -1,11 +1,9 @@
 name: cypher-manual
 title: Cypher Manual
-version: '2025'
+version: '5'
 start_page: ROOT:introduction/index.adoc
 nav:
 - modules/ROOT/content-nav.adoc
 asciidoc:
   attributes:
-    neo4j-version: '2025'
-    neo4j-version-minor: '2025.01'
-    neo4j-version-exact: '2025.01'
+    neo4j-version: '2025.01'

modules/ROOT/pages/appendix/tutorials/advanced-query-tuning.adoc

@@ -669,7 +669,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -711,7 +711,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -776,7 +776,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -823,7 +823,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -878,7 +878,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 

modules/ROOT/pages/appendix/tutorials/basic-query-tuning.adoc

@@ -623,7 +623,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -680,7 +680,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -747,7 +747,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 

modules/ROOT/pages/appendix/tutorials/shortestpath-planning.adoc

@@ -81,7 +81,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 
@@ -158,7 +158,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 1024
 
@@ -261,7 +261,7 @@ Planner COST
 
 Runtime PIPELINED
 
-Runtime version {neo4j-version-minor}
+Runtime version {neo4j-version}
 
 Batch size 128
 

modules/ROOT/pages/clauses/call.adoc

@@ -86,7 +86,7 @@ CALL dbms.checkConfigValue('server.bolt.enabled', 'true')
 | "valid" | "message"
 | true | "requires restart"
 
-1+d|Rows: 2
+2+d|Rows: 2
 |===
 
 ====
@@ -118,7 +118,7 @@ CALL dbms.checkConfigValue($setting, $value)
 | "valid" | "message"
 | true | "requires restart"
 
-1+d|Rows: 2
+2+d|Rows: 2
 |===
 
 [NOTE]
@@ -153,7 +153,7 @@ CALL dbms.checkConfigValue($setting, 'true')
 | "valid" | "message"
 | true | "requires restart"
 
-1+d|Rows: 2
+2+d|Rows: 2
 |===
 
 ====
@@ -189,6 +189,8 @@ CALL db.labels() YIELD *
 If the procedure has deprecated return columns, those columns are also returned.
 
 Note that `YIELD *` is only valid in standalone procedure calls.
+Variables must be explicitly named in a `YIELD` clause if other clauses than a single procedure `CALL` are present.
+This restriction simplifies query logic and protects against output variables from the procedure accidentally clashing with other query variables.
 For example, the following is not valid:
 
 .Not allowed
@@ -204,7 +206,7 @@ RETURN count(*) AS results
 ====
 
 `YIELD` can be used to filter for specific results.
-This requires knowing the names of the arguments within a procedure's signature, which can either be found in the link:{neo4j-docs-base-uri}/operations-manual/{page-version}/reference/procedures/[Operations Manual -> Procedures] or returned by a `SHOW PROCEDURES` query.
+This requires knowing the names of the arguments within a procedure's signature, which can either be found in the link:{neo4j-docs-base-uri}/operations-manual/{page-version}/reference/procedures/[Operations Manual -> Procedures] or in the `signature` column returned by a `SHOW PROCEDURES` command (see example below).
 
 .Find the argument names of `db.propertyKeys`
 [source, cypher]

modules/ROOT/pages/clauses/finish.adoc

@@ -3,17 +3,19 @@
 [[query-finish]]
 = FINISH
 
-A query ending in `FINISH` — instead of `RETURN` — has no result but executes all its side effects.
+A query ending in `FINISH` -- instead of `RETURN` -- has no result but executes all its side effects.
 `FINISH` was introduced as part of Cypher's xref:appendix/gql-conformance/index.adoc[].
 
 The following read query successfully executes but has no results:
 
 .Query
+// tag::clauses_finish_match[]
 [source, cypher]
 ----
 MATCH (p:Person)
 FINISH
 ----
+// end::clauses_finish_match[]
 
 The following query has no result but creates one node with the label `Person`:
 

modules/ROOT/pages/clauses/foreach.adoc

@@ -33,15 +33,17 @@ CREATE
 [[foreach-mark-all-nodes-along-a-path]]
 == Mark all nodes along a path
 
-This query will set the property `marked` to `true` on all nodes along a path.
+This query sets the property `marked` to `true` on all nodes along a path.
 
 .Query
+// tag::clauses_foreach_node[]
 [source, cypher, indent=0]
 ----
 MATCH p=(start)-[*]->(finish)
 WHERE start.name = 'A' AND finish.name = 'D'
 FOREACH (n IN nodes(p) | SET n.marked = true)
 ----
+// end::clauses_foreach_node[]
 
 .Result
 [role="queryresult",options="footer",cols="1*<m"]
@@ -51,3 +53,47 @@ d|Rows: 0 +
 Properties set: 4
 |===
 
+
+[[foreach-mark-all-relationships-along-a-path]]
+== Mark all relationships along a path
+
+This query sets the property `marked` to `true` on all relationships along a path.
+
+// tag::clauses_foreach_relationship[]
+[source, cypher, indent=0]
+----
+MATCH p=(start)-[*]->(finish)
+WHERE start.name = 'A' AND finish.name = 'D'
+FOREACH ( r IN relationships(p) | SET r.marked = true )
+----
+// end::clauses_foreach_relationship[]
+
+.Result
+[role="queryresult",options="footer",cols="1*<m"]
+|===
+|(empty result)
+d|Rows: 0 +
+Properties set: 3
+|===
+
+[[foreach-create-new-nodes-form-a-list]]
+== Create new nodes from a list of name labels
+
+This query creates a new node for each label in a list.
+
+.Query
+// tag::clauses_foreach_create[]
+[source, cypher, indent=0]
+----
+WITH ['E', 'F', 'G'] AS names
+FOREACH ( value IN names | CREATE (:Person {name: value}) )
+----
+// end::clauses_foreach_create[]
+
+.Result
+[role="queryresult",options="footer",cols="1*<m"]
+|===
+1+|(empty result)
+1+d|Rows: 0 +
+Nodes created: 3
+|===

modules/ROOT/pages/clauses/limit.adoc

@@ -166,12 +166,14 @@ Properties set: 1
 `LIMIT` can be used as a standalone clause, or in conjunction with xref:clauses/order-by.adoc[`ORDER BY`] or xref:clauses/skip.adoc[`SKIP`]/xref:clauses/skip.adoc#offset-synonym[`OFFSET`].
 
 .Standalone use of `LIMIT`
+// tag::clauses_limit_standalone[]
 [source, cypher]
 ----
 MATCH (n)
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
+// end::clauses_limit_standalone[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -185,6 +187,7 @@ The following query orders all nodes by `name` descending, skips the two first r
 It then xref:functions/aggregating.adoc#functions-collect[collects] the results in a list.
 
 .`LIMIT` used in conjunction with `ORDER BY` and `SKIP`
+// tag::clauses_limit[]
 [source, cypher]
 ----
 MATCH (n)
@@ -193,6 +196,7 @@ SKIP 2
 LIMIT 2
 RETURN collect(n.name) AS names
 ----
+// end::clauses_limit[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]

modules/ROOT/pages/clauses/load-csv.adoc

@@ -46,12 +46,14 @@ By default, paths are resolved relative to the Neo4j import directory.
 ----
 
 .Query
+// tag::clauses_load_csv_local_files[]
 [source, cypher]
 ----
 LOAD CSV FROM 'file:///artists.csv' AS row
 MERGE (a:Artist {name: row[1], year: toInteger(row[2])})
 RETURN a.name, a.year
 ----
+// end::clauses_load_csv_local_files[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -112,12 +114,14 @@ However, this means that insecure URLs on virtual hosts will not function unless
 ----
 
 .Query
+// tag::clauses_load_csv_remote_locations[]
 [source, cypher]
 ----
 LOAD CSV FROM 'https://data.neo4j.com/bands/artists.csv' AS row
 MERGE (a:Artist {name: row[1], year: toInteger(row[2])})
 RETURN a.name, a.year
 ----
+// end::clauses_load_csv_remote_locations[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -705,10 +709,11 @@ person_tmdbId,bio,born,bornIn,died,person_imdbId,name,person_poster,person_url
 ----
 
 [NOTE]
-The below query uses a xref:subqueries/call-subquery.adoc#variable-scope-clause[variable scope clause] (introduced in Neo4j 5.23) to import variables into the `CALL` subquery.
+The query below uses a xref:subqueries/call-subquery.adoc#variable-scope-clause[variable scope clause] (introduced in Neo4j 5.23) to import variables into the `CALL` subquery.
 If you are using an older version of Neo4j, use an xref:subqueries/call-subquery.adoc#importing-with[importing `WITH` clause] instead.
 
 .Query
+// tag::clauses_load_csv_transactions[]
 [source, cypher]
 ----
 LOAD CSV WITH HEADERS FROM 'https://data.neo4j.com/importing-cypher/persons.csv' AS row
@@ -717,6 +722,7 @@ CALL (row) {
   SET p.name = row.name, p.born = row.born
 } IN TRANSACTIONS OF 200 ROWS
 ----
+// end::clauses_load_csv_transactions[]
 
 .Result
 [source, role="queryresult"]
@@ -751,11 +757,13 @@ A common use case for this function is to generate sequential unique IDs for CSV
 ----
 
 .Query
+// tag::clauses_load_csv_linenumber[]
 [source, cypher]
 ----
 LOAD CSV FROM 'file:///artists.csv' AS row
 RETURN linenumber() AS number, row
 ----
+// end::clauses_load_csv_linenumber[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -786,11 +794,13 @@ The xref:functions/load-csv.adoc#functions-file[`file()`] function provides the
 ----
 
 .Query
+// tag::clauses_load_csv_file[]
 [source, cypher, role=test-result-skip]
 ----
 LOAD CSV FROM 'file:///artists.csv' AS row
 RETURN DISTINCT file() AS path
 ----
+// end::clauses_load_csv_file[]
 
 .Result
 [role="queryresult",options="header,footer",cols="1*<m"]
@@ -837,6 +847,7 @@ Id,Name,Year
 ----
 
 .Query
+// tag::clauses_load_csv_headers[]
 [source, cypher]
 ----
 LOAD CSV WITH HEADERS FROM 'file:///artists-with-headers.csv' AS row
@@ -845,6 +856,7 @@ RETURN
   a.name AS name,
   a.year AS year
 ----
+// end::clauses_load_csv_headers[]
 
 .Result
 [role="queryresult",options="header,footer",cols="2*<m"]
@@ -880,11 +892,13 @@ If you try to import a file that doesn't use `,` as field delimiter and you also
 ----
 
 .Query
+// tag::clauses_load_csv_field_terminator[]
 [source, cypher]
 ----
 LOAD CSV FROM 'file:///artists-fieldterminator.csv' AS row FIELDTERMINATOR ';'
 MERGE (:Artist {name: row[1], year: toInteger(row[2])})
 ----
+// end::clauses_load_csv_field_terminator[]
 
 .Result
 [source, role="queryresult"]