Fix RST formatting; reword a notice about -d:release in .nims

1 files changed, 5 insertions, 3 deletions

diff --git a/doc/nims.rst b/doc/nims.rst
index a0756eb13..94c788bad 100644
--- a/doc/nims.rst
+++ b/doc/nims.rst
@@ -42,9 +42,6 @@ Here are few examples of using the ``switch`` proc:
   # command-line: --forceBuild
   switch("forceBuild")
 
-*Note that specifically the ``-d:release`` define cannot be set using
-``switch`` in NimScripts.*
-
 NimScripts also support ``--`` templates for convenience, which look
 like command-line switches written as-is in the NimScript file. So the
 above example can be rewritten as:
@@ -54,6 +51,11 @@ above example can be rewritten as:
   --define:foo
   --forceBuild
 
+**Note**: In general, the *define* switches can also be set in
+NimScripts using ``switch`` or ``--``, as shown in above
+examples. Only the ``release`` define (``-d:release``) cannot be set
+in NimScripts.
+
 
 NimScript as a build tool
 =========================