summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBen Gamari <ben@smart-cactus.org>2016-01-21 11:36:00 +0100
committerBen Gamari <ben@smart-cactus.org>2016-01-21 14:59:06 +0100
commitf23b578f792a357fa754604188eea46ca46cf613 (patch)
tree776b74eaad38b9e76e21df7eac19141267ff62cb
parentede055eb230ac33da276f1416678f99e32e83da2 (diff)
downloadhaskell-f23b578f792a357fa754604188eea46ca46cf613.tar.gz
user-guide:: Improve -D description
-rw-r--r--docs/users_guide/phases.rst9
1 files changed, 6 insertions, 3 deletions
diff --git a/docs/users_guide/phases.rst b/docs/users_guide/phases.rst
index 0428956276..bc4e90f3a9 100644
--- a/docs/users_guide/phases.rst
+++ b/docs/users_guide/phases.rst
@@ -161,11 +161,14 @@ Options affecting the C pre-processor
large system with significant doses of conditional compilation, you
really shouldn't need it.
-.. ghc-flag:: -D ⟨symbol⟩[=⟨value⟩]
+.. ghc-flag:: -D <symbol>[=<value>]
Define macro ⟨symbol⟩ in the usual way. NB: does *not* affect ``-D``
- macros passed to the C compiler when compiling via C! For those, use
- the ``-optc-Dfoo`` hack… (see :ref:`forcing-options-through`).
+ macros passed to the C compiler when compiling with :ghc-flag:`-fvia-C`! For
+ those, use the ``-optc-Dfoo`` hack… (see :ref:`forcing-options-through`).
+
+ When no value is given, the value is taken to be ``1``. For instance,
+ ``-DUSE_MYLIB`` is equivalent to ``-DUSE_MYLIB=1``.
.. ghc-flag:: -U ⟨symbol⟩