diff --git a/README b/README
new file mode 100644
index 0000000000000000000000000000000000000000..bab14a488dacf8835352f4e5ec814e5fd781f97f
--- /dev/null
+++ b/README
@@ -0,0 +1,8 @@
+This Cabal darcs repository contains multiple packages:
+
+ * cabal/          -- the Cabal library package
+ * cabal-install/  -- the cabal-install package containing the 'cabal' tool.
+
+See the README in each subdir for more details.
+
+The canonical upstream repo lives at http://darcs.haskell.org/cabal/