Use clearer notation for single and double quotes in docs

This handles geekosaur's review.

Author: tomsmeding

Cabal/src/Distribution/Simple/Setup/Benchmark.hs

@@ -118,7 +118,7 @@ benchmarkOptions' showOrParseArgs =
         []
         ["benchmark-options"]
         ( "give extra options to benchmark executables "
-            ++ "(split on spaces, \"quotes\" prevent splitting; "
+            ++ "(split on spaces, use \"\" to prevent splitting; "
             ++ "name templates can use $pkgid, $compiler, "
             ++ "$os, $arch, $benchmark)"
         )

Cabal/src/Distribution/Simple/Setup/Common.hs

@@ -316,7 +316,7 @@ programDbOptions progDb showOrParseArgs get set =
         [prog ++ "-options"]
         ( "give extra options to "
             ++ prog
-            ++ " (split on spaces, \"quotes\" prevent splitting)"
+            ++ " (split on spaces, use \"\" to prevent splitting)"
         )
         get
         set

Cabal/src/Distribution/Simple/Setup/Test.hs

@@ -245,7 +245,7 @@ testOptions' showOrParseArgs =
         []
         ["test-options"]
         ( "give extra options to test executables "
-            ++ "(split on spaces, \"quotes\" prevent splitting; "
+            ++ "(split on spaces, use \"\" to prevent splitting; "
             ++ "name templates can use $pkgid, $compiler, "
             ++ "$os, $arch, $test-suite)"
         )

doc/cabal-commands.rst

@@ -1069,7 +1069,7 @@ configuration from the 'cabal.project', 'cabal.project.local' and other files.
     ``--repl-options`` bypasses this and allows you to specify options to the
     invoked REPL without influencing the build configuration for other packages.
 
-    Note: ``--repl-options`` does not accept ``"quotes"`` to pass options
+    Note: ``--repl-options`` does not accept double quotes (``""``) to pass options
     containing spaces to the REPL.
 
 .. option:: --repl-no-load

doc/setup-commands.rst

@@ -210,11 +210,11 @@ files of a package:
     to Cabal can be used in place of *prog*. For example:
     ``--alex-options="--template=mytemplatedir/"``. The *options* is
     split into program options based on spaces. Any options containing
-    embedded spaces need to be quoted with "double quotes", for example
-    ``--foo-options='--bar="C:\Program Files\Bar"'``. (The ``'single'`` quotes
-    are for your shell, the ``"double"`` quotes are passed to Cabal.) As an
-    alternative that takes only one option at a time but avoids the need to
-    quote, use :option:`--PROG-option` instead.
+    embedded spaces need to be quoted with double quotes (``""``), for example
+    ``--foo-options='--bar="C:\Program Files\Bar"'``. (The single quotes
+    (``''``) are for your shell, the ``"double"`` quotes are passed to Cabal.)
+    As an alternative that takes only one option at a time but avoids the need
+    to quote, use :option:`--PROG-option` instead.
 
     Note: if *prog* is ``ghc``, then options that do not affect build
     artifacts, such as warning flags, are dropped. This is because
@@ -1459,7 +1459,7 @@ Flags for repl:
 
 .. option:: --PROG-options=OPTS
 
-    Give extra options to PROG (split on spaces, "quotes" prevent splitting).
+    Give extra options to PROG (split on spaces, use "" to prevent splitting).
 
 .. option:: --repl-no-load