diff --git a/Hipmunk.cabal b/Hipmunk.cabal
--- a/Hipmunk.cabal
+++ b/Hipmunk.cabal
@@ -3,7 +3,7 @@
 Tested-With:   GHC
 Category:      Physics, Game
 Name:          Hipmunk
-Version:       5.2.0
+Version:       5.2.0.1
 Stability:     provisional
 License:       OtherLicense
 License-File:  LICENSE
@@ -20,6 +20,10 @@
       completely self-contained.  Please see
       <http://hackage.haskell.org/package/HipmunkPlayground>
       for a demonstration of this library.
+      .
+      New in version 5.2.0.1:
+      .
+      * Minor documentation fixes.
       .
       New in version 5.2.0:
       .
diff --git a/NEWS b/NEWS
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,7 @@
+Version 5.2.0.1
+===============
+ - Minor documentation fixes.
+
 Version 5.2.0
 =============
  - Use package StateVar for all variables.
diff --git a/Physics/Hipmunk/Constraint.hsc b/Physics/Hipmunk/Constraint.hsc
--- a/Physics/Hipmunk/Constraint.hsc
+++ b/Physics/Hipmunk/Constraint.hsc
@@ -14,10 +14,10 @@
 
 module Physics.Hipmunk.Constraint
     (-- * Common interface
+     Constraint,
      newConstraint,
      redefineC,
      setBiasCoefC,
-     Constraint,
      -- ** Forgetting the phantom type
      -- $phantom
      Unknown,
diff --git a/Physics/Hipmunk/Internal.hsc b/Physics/Hipmunk/Internal.hsc
--- a/Physics/Hipmunk/Internal.hsc
+++ b/Physics/Hipmunk/Internal.hsc
@@ -131,7 +131,7 @@
 -- | Type of generic constraint initializar.
 type ConstraintInit = ConstraintPtr -> BodyPtr -> BodyPtr -> IO ()
 
--- | Class implemented by all constraint types.
+-- | Internal.  Class implemented by all constraint types.
 class ConstraintType a where
   size  :: a -> Int
   init_ :: a -> ConstraintInit
@@ -140,7 +140,7 @@
 
 
 -- | A space is where the simulation really occurs. You add
---   bodies, shapes and constraints to a space and then step it
+--   bodies, shapes and constraints to a space and then @step@ it
 --   to update it as whole.
 data Space = P !(ForeignPtr Space)
                !(IORef Entities)   -- Active and static entities
diff --git a/Physics/Hipmunk/Shape.hsc b/Physics/Hipmunk/Shape.hsc
--- a/Physics/Hipmunk/Shape.hsc
+++ b/Physics/Hipmunk/Shape.hsc
@@ -202,11 +202,9 @@
 --   calculated by multiplying the elasticity of both shapes.
 --   (default is zero)
 --
---   /IMPORTANT:/ by default old-style elastic iterations are
---   done when the space @step@s, which may result in a
---   not-so-good simulation.  It may be a good idea to use
---   @setElasticIterations@ with something greater than zero,
---   maybe @10@.
+--   By default old-style elastic iterations are done when the
+--   space @step@s.  This used to result in a not-so-good
+--   simulation, but now this is the recommended setting.
 type Elasticity = CpFloat
 elasticity :: Shape -> StateVar Elasticity
 elasticity (S shape _) = makeStateVar getter setter
diff --git a/Physics/Hipmunk/Space.hsc b/Physics/Hipmunk/Space.hsc
--- a/Physics/Hipmunk/Space.hsc
+++ b/Physics/Hipmunk/Space.hsc
@@ -253,6 +253,9 @@
 -- | The number of elastic iterations to use when solving
 --   constraints.  If @0@, then old-style elastic code is used.
 --   (default is 0).
+--
+--   This property is deprecated.  You should no longer need to
+--   set any value other than the default.
 type ElasticIterations = CInt
 {-# DEPRECATED elasticIterations "Elastic iterations should no longer be needed" #-}
 elasticIterations :: Space -> StateVar ElasticIterations