diff --git a/parsec3.cabal b/parsec3.cabal
--- a/parsec3.cabal
+++ b/parsec3.cabal
@@ -1,5 +1,5 @@
 name:           parsec3
-version:        1.0.0.0
+version:        1.0.0.1
 cabal-version: >= 1.2.3
 license:        BSD3
 license-file:   LICENSE
@@ -18,6 +18,17 @@
         input stream type.
         .
         This package comes without the compatibility layer for parsec2.
+        .
+        Note, that the module names overlap with those of newer parsec
+        versions, therefore I do not recommend to unconditionally use parsec3
+        as dependency in cabal files of packages for hackage.  But you may
+        want to develop your code using this subset of parsec3 modules and
+        finally change the dependency from parsec3 to parsec-3.1.0 in order to
+        avoid module ambiguities for users just installing your package.  Your
+        own module ambiguities are best avoided by hiding packages.
+        .
+        This version only differs from the previous one by a changed
+        description.
 library
     exposed-modules:
         Text.Parsec,