diff --git a/README.md b/README.md
index d338efb..e6ab838 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,7 @@
-# headers
\ No newline at end of file
+# headers
+
+This is a "fake" library that installs the Boost headers on
+`b2 libs/headers/build//install`.
+
+It also creates a CMake target `Boost::headers`, on which the
+non-header library targets such as `Boost::filesystem` depend.