From 24d43f6705762a02c96e530e3604cd65c7a4d3d5 Mon Sep 17 00:00:00 2001
From: Ben Sherman <bentshermann@gmail.com>
Date: Tue, 26 Nov 2024 08:26:22 -0600
Subject: [PATCH] Update syntax docs

Signed-off-by: Ben Sherman <bentshermann@gmail.com>
---
 docs/reference/syntax.md | 10 -----
 docs/vscode.md           | 90 +++++++++++++++++++++++++---------------
 2 files changed, 57 insertions(+), 43 deletions(-)

diff --git a/docs/reference/syntax.md b/docs/reference/syntax.md
index bb7cd098dd..fb06ccdded 100644
--- a/docs/reference/syntax.md
+++ b/docs/reference/syntax.md
@@ -632,16 +632,6 @@ A *slashy string* is enclosed by slashes instead of quotes:
 /no escape!/
 ```
 
-Slashy strings can also span multiple lines:
-
-```nextflow
-/
-Patterns in the code,
-Symbols dance to match and find,
-Logic unconfined.
-/
-```
-
 :::{note}
 A slashy string cannot be empty because it would become a line comment.
 :::
diff --git a/docs/vscode.md b/docs/vscode.md
index c889ddb27c..be7cd4459f 100644
--- a/docs/vscode.md
+++ b/docs/vscode.md
@@ -229,38 +229,6 @@ if (aligner == 'bowtie2') {
 }
 ```
 
-**Slashy dollar strings**
-
-Groovy supports a wide variety of strings, including multi-line strings, dynamic strings, slashy strings, multi-line dynamic slashy strings, and more.
-
-The Nextflow language specification supports single- and double-quoted strings, multi-line strings, and slashy strings. Dynamic slashy strings are not supported:
-
-```groovy
-def logo = /--cl-config 'custom_logo: "${multiqc_logo}"'/
-```
-
-Use a double-quoted string instead:
-
-```nextflow
-def logo = "--cl-config 'custom_logo: \"${multiqc_logo}\"'"
-```
-
-Slashy dollar strings are not supported:
-
-```groovy
-$/
-echo "Hello world!"
-/$
-```
-
-Use a multi-line string instead:
-
-```nextflow
-"""
-echo "Hello world!"
-"""
-```
-
 **Implicit environment variables**
 
 In Nextflow DSL1 and DSL2, you can reference environment variables directly in strings:
@@ -333,6 +301,62 @@ To ease the migration of existing scripts, the language server only reports warn
 Type annotations and static type checking will be addressed in a future version of the Nextflow language specification.
 :::
 
+**Strings**
+
+Groovy supports a wide variety of strings, including multi-line strings, dynamic strings, slashy strings, multi-line dynamic slashy strings, and more.
+
+The Nextflow language specification supports single- and double-quoted strings, multi-line strings, and slashy strings.
+
+Slashy strings cannot be interpolated:
+
+```nextflow
+def id = 'SRA001'
+assert 'SRA001.fastq' ~= /${id}\.f(?:ast)?q/
+```
+
+Use a double-quoted string instead:
+
+```nextflow
+def id = 'SRA001'
+assert 'SRA001.fastq' ~= "${id}\\.f(?:ast)?q"
+```
+
+Slashy strings cannot span multiple lines:
+
+```groovy
+/
+Patterns in the code,
+Symbols dance to match and find,
+Logic unconfined.
+/
+```
+
+Use a multi-line string instead:
+
+```nextflow
+"""
+Patterns in the code,
+Symbols dance to match and find,
+Logic unconfined.
+"""
+```
+
+Dollar slashy strings are not supported:
+
+```groovy
+$/
+echo "Hello world!"
+/$
+```
+
+Use a multi-line string instead:
+
+```nextflow
+"""
+echo "Hello world!"
+"""
+```
+
 **Process env inputs/outputs**
 
 In Nextflow DSL1 and DSL2, the name of a process `env` input/output can be specified with or without quotes:
@@ -472,7 +496,7 @@ includeConfig ({
         return 'large.config'
     else
         return '/dev/null'
-})()
+}())
 ```
 
 The include source is a closure that is immediately invoked. It includes a different config file based on the return value of the closure. Including `/dev/null` is equivalent to including nothing.