minor doc update
diff --git a/README.md b/README.md
index 21bdfc3..0898605 100644
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
[](https://travis-ci.org/wjakob/pybind11)
[](http://pybind11.readthedocs.org/en/latest/?badge=latest)
-**pybind11** is a lightweight header library that exposes C++ types in Python
+**pybind11** is a lightweight header-only library that exposes C++ types in Python
and vice versa, mainly to create Python bindings of existing C++ code. Its
goals and syntax are similar to the excellent
[Boost.Python](http://www.boost.org/doc/libs/1_58_0/libs/python/doc/) library
@@ -21,10 +21,10 @@
become an excessively large and unnecessary dependency.
Think of this library as a tiny self-contained version of Boost.Python with
-everything stripped away that isn't relevant for binding generation. The whole
-codebase requires less than 3000 lines of code and only depends on Python (2.7
-or 3.x) and the C++ standard library. This compact implementation was possible
-thanks to some of the new C++11 language features (tuples, lambda functions and
+everything stripped away that isn't relevant for binding generation. The core
+header files only require ~2K lines of code and depend on Python (2.7 or 3.x)
+and the C++ standard library. This compact implementation was possible thanks
+to some of the new C++11 language features (tuples, lambda functions and
variadic templates). Since its creation, this library has grown beyond
Boost.Python in many ways, leading to dramatically simpler binding code in many
common situations.
@@ -67,4 +67,5 @@
- Python's slice-based access and assignment operations can be supported with
just a few lines of code.
-
+- Everything is contained in just a few header files; there no need to link
+ against any additional libraries.
diff --git a/docs/index.rst b/docs/index.rst
index 253c2c2..21437a3 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -1,5 +1,5 @@
-Welcome to pybind11's documentation!
-====================================
+pybind11 --- Seamless operability between C++11 and Python
+==========================================================
Contents:
diff --git a/docs/intro.rst b/docs/intro.rst
index 738d937..0391173 100644
--- a/docs/intro.rst
+++ b/docs/intro.rst
@@ -1,6 +1,6 @@
About this project
==================
-**pybind11** is a lightweight header library that exposes C++ types in Python
+**pybind11** is a lightweight header-only library that exposes C++ types in Python
and vice versa, mainly to create Python bindings of existing C++ code. Its
goals and syntax are similar to the excellent `Boost.Python`_ library by David
Abrahams: to minimize boilerplate code in traditional extension modules by
@@ -17,10 +17,10 @@
become an excessively large and unnecessary dependency.
Think of this library as a tiny self-contained version of Boost.Python with
-everything stripped away that isn't relevant for binding generation. The whole
-codebase requires less than 3000 lines of code and only depends on Python (2.7
-or 3.x) and the C++ standard library. This compact implementation was possible
-thanks to some of the new C++11 language features (tuples, lambda functions and
+everything stripped away that isn't relevant for binding generation. The core
+header files only require ~2K lines of code and depend on Python (2.7 or 3.x)
+and the C++ standard library. This compact implementation was possible thanks
+to some of the new C++11 language features (tuples, lambda functions and
variadic templates). Since its creation, this library has grown beyond
Boost.Python in many ways, leading to dramatically simpler binding code in many
common situations.
@@ -62,3 +62,5 @@
- Python's slice-based access and assignment operations can be supported with
just a few lines of code.
+- Everything is contained in just a few header files; there no need to link
+ against any additional libraries.