diff --git a/replace-megaparsec.cabal b/replace-megaparsec.cabal
--- a/replace-megaparsec.cabal
+++ b/replace-megaparsec.cabal
@@ -1,5 +1,5 @@
 name:                replace-megaparsec
-version:             1.3.0.0
+version:             1.3.1.0
 cabal-version:       1.18
 synopsis:            Find, replace, and edit text patterns with Megaparsec parsers
 homepage:            https://github.com/jamesdbrock/replace-megaparsec
diff --git a/src/Replace/Megaparsec.hs b/src/Replace/Megaparsec.hs
--- a/src/Replace/Megaparsec.hs
+++ b/src/Replace/Megaparsec.hs
@@ -72,18 +72,18 @@
 --
 -- === Output
 --
--- The input stream is separated into a list of sections:
+-- The input stream is separated and output into a list of sections:
 --
--- * sections which can parsed by the pattern @sep@ will be captured as
---   matching sections in 'Right'
--- * non-matching sections of the stream will be captured in 'Left'.
+-- * Sections which can parsed by the pattern @sep@ will be parsed and captured
+--   as 'Right'.
+-- * Non-matching sections of the stream will be captured in 'Left'.
 --
--- There are two constraints on the output:
+-- The output list also has these properties:
 --
--- * The output list will non-empty. If there are no pattern matches, then
+-- * If the input is @""@ then the output list will be @[]@.
+-- * If there are no pattern matches, then
 --   the entire input stream will be returned as one non-matching 'Left' section.
---   If the input is @""@ then the output list will be @[Left ""]@.
--- * The output list will not contain two consecutive 'Left's.
+-- * The output list will not contain two consecutive 'Left' sections.
 --
 -- === Zero-width matches forbidden
 --