[commit: ghc] master: Tweak Haddock markup in GHC.Magic (a2ac57b)
git at git.haskell.org
git at git.haskell.org
Sat Aug 9 19:44:44 UTC 2014
Repository : ssh://git@git.haskell.org/ghc
On branch : master
Link : http://ghc.haskell.org/trac/ghc/changeset/a2ac57b4026380467304823a225fea05dcba1abc/ghc
>---------------------------------------------------------------
commit a2ac57b4026380467304823a225fea05dcba1abc
Author: Reid Barton <rwbarton at gmail.com>
Date: Fri Aug 8 22:29:51 2014 -0400
Tweak Haddock markup in GHC.Magic
>---------------------------------------------------------------
a2ac57b4026380467304823a225fea05dcba1abc
libraries/ghc-prim/GHC/Magic.hs | 12 ++++++------
1 file changed, 6 insertions(+), 6 deletions(-)
diff --git a/libraries/ghc-prim/GHC/Magic.hs b/libraries/ghc-prim/GHC/Magic.hs
index f616343..081b838 100644
--- a/libraries/ghc-prim/GHC/Magic.hs
+++ b/libraries/ghc-prim/GHC/Magic.hs
@@ -19,15 +19,15 @@
module GHC.Magic ( inline, lazy ) where
--- | The call '(inline f)' arranges that 'f' is inlined, regardless of
--- its size. More precisely, the call '(inline f)' rewrites to the
--- right-hand side of 'f'\'s definition. This allows the programmer to
+-- | The call @inline f@ arranges that 'f' is inlined, regardless of
+-- its size. More precisely, the call @inline f@ rewrites to the
+-- right-hand side of @f@'s definition. This allows the programmer to
-- control inlining from a particular call site rather than the
-- definition site of the function (c.f. 'INLINE' pragmas).
--
-- This inlining occurs regardless of the argument to the call or the
--- size of 'f'\'s definition; it is unconditional. The main caveat is
--- that 'f'\'s definition must be visible to the compiler; it is
+-- size of @f@'s definition; it is unconditional. The main caveat is
+-- that @f@'s definition must be visible to the compiler; it is
-- therefore recommended to mark the function with an 'INLINABLE'
-- pragma at its definition so that GHC guarantees to record its
-- unfolding regardless of size.
@@ -39,7 +39,7 @@ inline :: a -> a
inline x = x
-- | The 'lazy' function restrains strictness analysis a little. The
--- call '(lazy e)' means the same as 'e', but 'lazy' has a magical
+-- call @lazy e@ means the same as 'e', but 'lazy' has a magical
-- property so far as strictness analysis is concerned: it is lazy in
-- its first argument, even though its semantics is strict. After
-- strictness analysis has run, calls to 'lazy' are inlined to be the
More information about the ghc-commits
mailing list