diff --git a/ChangeLog.md b/ChangeLog.md
--- a/ChangeLog.md
+++ b/ChangeLog.md
@@ -1,5 +1,9 @@
 # ChangeLog for typed-process
 
+## 0.2.6.2
+
+* Doc improvements
+
 ## 0.2.6.1
 
 * Doc improvements
diff --git a/src/System/Process/Typed.hs b/src/System/Process/Typed.hs
--- a/src/System/Process/Typed.hs
+++ b/src/System/Process/Typed.hs
@@ -68,24 +68,26 @@
     , mkStreamSpec
 
       -- * Launch a process
-    , startProcess
-    , stopProcess
+    , runProcess
+    , readProcess
+    , readProcessStdout
+    , readProcessStderr
+    , readProcessInterleaved
     , withProcessWait
-    , withProcessWait_
     , withProcessTerm
-    , withProcessTerm_
-    , withProcess
-    , withProcess_
-    , readProcess
-    , readProcess_
-    , runProcess
+    , startProcess
+    , stopProcess
+      -- ** Exception-throwing functions
+      -- | The functions ending in underbar (@_@) are the same as
+      -- their counterparts without underbar but instead of returning
+      -- an 'ExitCode' they throw 'ExitCodeException' on failure.
     , runProcess_
-    , readProcessStdout
+    , readProcess_
     , readProcessStdout_
-    , readProcessStderr
     , readProcessStderr_
-    , readProcessInterleaved
     , readProcessInterleaved_
+    , withProcessWait_
+    , withProcessTerm_
 
       -- * Interact with a process
 
@@ -107,6 +109,9 @@
     , ByteStringOutputException (..)
       -- * Unsafe functions
     , unsafeProcessHandle
+      -- * Deprecated functions
+    , withProcess
+    , withProcess_
     ) where
 
 import qualified Data.ByteString as S
@@ -684,7 +689,7 @@
 -- | Launch a process based on the given 'ProcessConfig'. You should
 -- ensure that you call 'stopProcess' on the result. It's usually
 -- better to use one of the functions in this module which ensures
--- 'stopProcess' is called, such as 'withProcess'.
+-- 'stopProcess' is called, such as 'withProcessWait'.
 --
 -- @since 0.1.0.0
 startProcess :: MonadIO m
@@ -825,7 +830,9 @@
 -- @since 0.2.5.0
 withProcessTerm :: (MonadUnliftIO m)
   => ProcessConfig stdin stdout stderr
+  -- ^
   -> (Process stdin stdout stderr -> m a)
+  -- ^
   -> m a
 withProcessTerm config = bracket (startProcess config) stopProcess
 
diff --git a/typed-process.cabal b/typed-process.cabal
--- a/typed-process.cabal
+++ b/typed-process.cabal
@@ -5,7 +5,7 @@
 -- see: https://github.com/sol/hpack
 
 name:           typed-process
-version:        0.2.6.1
+version:        0.2.6.2
 synopsis:       Run external processes, with strong typing of streams
 description:    Please see the tutorial at <https://haskell-lang.org/library/typed-process>
 category:       System