author ross Fri, 10 Sep 2004 22:43:20 +0000 (22:43 +0000) committer ross Fri, 10 Sep 2004 22:43:20 +0000 (22:43 +0000)
doc tweaks

index b66a6ce..c2b1669 100644 (file)
@@ -10,8 +10,8 @@
--
--
--- For more details, see Levent Erkok's thesis,
--- /Value Recursion in Monadic Computations/, 2002.
+-- For a detailed discussion, see Levent Erkok's thesis,
--
-----------------------------------------------------------------------------

@@ -25,31 +25,32 @@ module Control.Monad.Fix (
import Prelude
import System.IO

--- | @'fix' f@ is the least fixed point of the function @f@.
+-- | @'fix' f@ is the least fixed point of the function @f@,
+-- i.e. the least defined @x@ such that @f x = x@.
fix :: (a -> a) -> a
fix f = let x = f x in x

--- | Monads having fixed points with a \`knot-tying\' semantics.
--- Instances of 'MonadFix' should satisfy the laws
+-- | Monads having fixed points with a \'knot-tying\' semantics.
+-- Instances of 'MonadFix' should satisfy the following laws:
--
--- [purity]
+-- [/purity/]
--     @'mfix' ('return' . h)  =  'return' ('fix' h)@
--
--- [left shrinking (or tightening)]
---     @'mfix' (\x -> a >>= \y -> f x y)  =  \y -> 'mfix' (\x -> f x y)@
+-- [/left shrinking/ (or /tightening/)]
+--     @'mfix' (\\x -> a >>= \\y -> f x y)  =  \\y -> 'mfix' (\\x -> f x y)@
--
--- [sliding]
+-- [/sliding/]
--     @'mfix' ('Control.Monad.liftM' h . f)  =  'Control.Monad.liftM' h ('mfix' (f . h))@,
--     for strict @h@.
--
--- [nesting]
---     @'mfix' (\x -> 'mfix' (\y -> f x y))  =  'mfix' (\x -> f x x)@
+-- [/nesting/]
+--     @'mfix' (\\x -> 'mfix' (\\y -> f x y))  =  'mfix' (\\x -> f x x)@
--
-- This class is used in the translation of the recursive @do@ notation
-- supported by GHC and Hugs.