explain subqueries

Author: JPryce-Aklundh

modules/ROOT/pages/clauses/with.adoc

@@ -12,7 +12,6 @@ The `WITH` clause serves multiple purposes in Cypher:
 * xref:clauses/with.adoc#remove-duplicate-values[Remove duplicate values]
 * xref:clauses/with.adoc#ordering-and-pagination[Order and paginate results]
 * xref:clauses/with.adoc#filter-results[Filter results]
-* xref:clauses/with.adoc#linear-query-composition[Enable linear composition of multiple queries]
 
 [[example-graph]]
 == Example graph
@@ -164,6 +163,36 @@ RETURN s.name AS company,
 3+d|Rows: 5
 |===
 
+`WITH` cannot de-scope variables imported to a xref:subqueries/call-subquery.adoc[`CALL` subquery], because variables imported to a subquery are considered global to its inner scope.
+More specifically, a variable imported into a `CALL` subquery will be available to subsequent clauses even if a preceding `WITH` clause does not reference it.
+
+In the below example, the `x` variable is imported to the inside scope of a `CALL` subquery, and is successfully referenced  by the `RETURN` clause even though the preceding `WITH` neglects to list it.
+
+.Variables cannot be de-scoped in the inner scope of a subquery
+[source, cypher]
+----
+WITH 11 AS x
+CALL (x) {
+  UNWIND [2, 3] AS y
+  WITH y
+  RETURN x*y AS a
+}
+RETURN x, a
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="2*<m"]
+|===
+| x | a
+
+| 11 | 22
+| 11 | 33
+
+2+d|Rows: 2
+|===
+
+For more information, see xref:subqueries/call-subquery.adoc#import-variables[`CALL` subqueries -> Import variables].
+
 [[bind-values-to-variables]]
 == Bind values to variables
 
@@ -303,7 +332,7 @@ ORDER BY discountRates
 == Explicitly project values
 
 `WITH ALL` can be used to explicitly project all values bound to a variable.
-This functionality was introduced as part of Cypher's xref:appendix/gql-conformance/index.adoc[], and using it is functionally the same as using simple `WITH`.
+Using it is functionally the same as using simple `WITH`.
 
 .Explicit result projection using `WITH ALL`
 [source, cypher]
@@ -504,8 +533,3 @@ RETURN s.name AS supplier,
 [NOTE]
 The `FILTER` clause can be used as a more concise alternative to `WITH * WHERE <predicate>` constructs.
 For more information, see xref:clauses/filter.adoc#filter-with-where[`FILTER` as a substitute for `WITH * WHERE`].
-
-[[linear-query-composition]]
-== Linear composition of multiple queries
-
-