Re #2210 Provide further examples for arguments

Author: mpilgrem

doc/commands/build_command.md

@@ -601,10 +601,19 @@ do not contain space or `"` characters) or quoted (`""`). Quoted arguments can
 include 'escaped' characters, escaped with an initial `\` character.
 
 Account may need to be taken of the shell's approach to the processing of
-command line arguments. For example, to pass `'a single quoted string'`:
+command line arguments:
 
 === "Unix-like (Bash or Zsh)"
 
+    For example, to pass `word` and `words with spaces` in Bash, or Zsh:
+
+    `stack test --benchmark-arguments 'word "words with spaces"'`
+
+    The content of single quotes is taken literally, but cannot contain a single
+    quote.
+
+    For example, to pass `'a single quoted string'`:
+
     In Bash, or Zsh (if `RC_QUOTES` option not set):
 
     `stack bench --benchmark-arguments \"\''a single quoted string'\'\"`
@@ -622,7 +631,13 @@ command line arguments. For example, to pass `'a single quoted string'`:
 
 === "Windows"
 
-    In PowerShell:
+    For example, to pass `word` and `words with spaces` in PowerShell:
+
+    `stack test --benchmark-arguments 'word "words with spaces"'`
+
+    The content of single quotes is taken literally.
+
+    For example, to pass `'a single quoted string'` in PowerShell:
 
     `stack bench --benchmark-arguments '"''a single quoted string''"'`
 
@@ -644,10 +659,19 @@ do not contain space or `"` characters) or quoted (`""`). Quoted arguments can
 include 'escaped' characters, escaped with an initial `\` character.
 
 Account may need to be taken of the shell's approach to the processing of
-command line arguments. For example, to pass `'a single quoted string'`:
+command line arguments:
 
 === "Unix-like (Bash or Zsh)"
 
+    For example, to pass `word` and `words with spaces` in Bash, or Zsh:
+
+    `stack build --exec '<command> word "words with spaces"'`
+
+    The content of single quotes is taken literally, but cannot contain a single
+    quote.
+
+    For example, to pass `'a single quoted string'`:
+
     In Bash, or Zsh (if `RC_QUOTES` option not set):
 
     `stack build --exec '<command> '\"\''a single quoted string'\'\"`
@@ -665,7 +689,13 @@ command line arguments. For example, to pass `'a single quoted string'`:
 
 === "Windows"
 
-    In PowerShell:
+    For example, to pass `word` and `words with spaces` in PowerShell:
+
+    `stack build --exec '<command> word "words with spaces"'`
+
+    The content of single quotes is taken literally.
+
+    For example, to pass `'a single quoted string'` in PowerShell:
 
     `stack build --exec '<command> "''a single quoted string''"'`
 
@@ -702,10 +732,19 @@ do not contain space or `"` characters) or quoted (`""`). Quoted arguments can
 include 'escaped' characters, escaped with an initial `\` character.
 
 Account may need to be taken of the shell's approach to the processing of
-command line arguments. For example, to pass `'a single quoted string'`:
+command line arguments:
 
 === "Unix-like (Bash or Zsh)"
 
+    For example, to pass `word` and `words with spaces` in Bash, or Zsh:
+
+    `stack test --test-arguments 'word "words with spaces"'`
+
+    The content of single quotes is taken literally, but cannot contain a single
+    quote.
+
+    For example, to pass `'a single quoted string'`:
+
     In Bash, or Zsh (if `RC_QUOTES` option not set):
 
     `stack test --test-arguments \"\''a single quoted string'\'\"`
@@ -723,7 +762,13 @@ command line arguments. For example, to pass `'a single quoted string'`:
 
 === "Windows"
 
-    In PowerShell:
+    For example, to pass `word` and `words with spaces` in PowerShell:
+
+    `stack test --test-arguments 'word "words with spaces"'`
+
+    The content of single quotes is taken literally.
+
+    For example, to pass `'a single quoted string'` in PowerShell:
 
     `stack test --test-arguments '"''a single quoted string''"'`