diff --git a/lib/Pipes/Cliff/Core.hs b/lib/Pipes/Cliff/Core.hs
--- a/lib/Pipes/Cliff/Core.hs
+++ b/lib/Pipes/Cliff/Core.hs
@@ -455,9 +455,12 @@
   withLock (csLock cnsl) $
     modifyVar_ (csReleasers cnsl) (\ls -> return (rel : ls))
 
--- | Terminates a process.  Cleans up all associated resources.  Use
--- this with 'Control.Exception.bracket' to ensure proper cleanup of
--- resources.
+-- | Terminates a process.  Sends the process a @SIGTERM@, which does
+-- not absolutely guarantee that it will exit.  Closes any 'Handle's
+-- that were created for the process through Cliff, and terminates any
+-- associated background threads that were moving data to and from the
+-- process.  Use this function this with 'Control.Exception.bracket'
+-- to ensure proper cleanup of resources.
 terminateProcess :: ProcessHandle -> IO ()
 terminateProcess pnl = mask_ $ do
   cnsl <- phConsole pnl
diff --git a/lib/Pipes/Cliff/Examples.hs b/lib/Pipes/Cliff/Examples.hs
--- a/lib/Pipes/Cliff/Examples.hs
+++ b/lib/Pipes/Cliff/Examples.hs
@@ -37,15 +37,12 @@
     go i = yield ((BS8.pack . show $ i) `BS8.snoc` '\n')
       >> go (succ i)
 
--- | Streams an infinite list of numbers to @less@.
--- The 'Effect' that streams values to the process is run in the
--- background by using 'conveyor', even though there is only one
--- subprocess.  This is typically what you want.  Shows off how you
--- can use "Pipes.Cliff" even for non-finite 'Producer's.  Don't try
--- to go to the end of the input in @less@, though.  When you quit
--- @less@, you will get broken pipe warnings printed to standard
--- error.  This is normal.  To suppress them, see the 'handler'
--- option.
+-- | Streams an infinite list of numbers to @less@.  Shows off how
+-- you can use "Pipes.Cliff" even for non-finite 'Producer's.  Don't
+-- try to go to the end of the input in @less@, though.  When you
+-- quit @less@, you will get broken pipe warnings printed to
+-- standard error.  This is normal.  To suppress them, see the
+-- 'handler' option.
 
 numsToLess :: IO (Maybe ExitCode, ExitCode)
 numsToLess = do
diff --git a/pipes-cliff.cabal b/pipes-cliff.cabal
--- a/pipes-cliff.cabal
+++ b/pipes-cliff.cabal
@@ -3,11 +3,11 @@
 -- http://www.github.com/massysett/cartel
 --
 -- Script name used to generate: genCabal.hs
--- Generated on: 2015-03-29 12:57:28.11669 EDT
+-- Generated on: 2015-03-29 13:40:34.092315 EDT
 -- Cartel library version: 0.14.2.6
 
 name: pipes-cliff
-version: 0.8.0.0
+version: 0.8.0.2
 cabal-version: >= 1.18
 license: BSD3
 license-file: LICENSE