Install docs.

2 files changed, 13 insertions, 3 deletions

diff --git a/docs/narr/install.rst b/docs/narr/install.rst
index bec8217f8..59f44ff84 100644
--- a/docs/narr/install.rst
+++ b/docs/narr/install.rst
@@ -10,8 +10,18 @@ primarily under Python 2.4, so that version is recommended.
 :mod:`repoze.bfg` does *not* run under any version of Python before
 2.4, and does *not* run under Python 3.X.
 
-You may install :mod:`repoze.bfg` into your Python environment using
-the following command::
+.. note:: To succesfully install :mod:``repoze.bfg``, you will need an
+   environment capable of compiling C code.  See the documentation
+   about installing, e.g. ``gcc`` for your system.  Additionally, the
+   Python development libraries for your Python version will need to
+   be installed and the ``lixbml2`` and ``libxslt`` development
+   libraries will need to be installed.  These requirements are often
+   satisfied by installing the ``python-devel``, ``libxml2-devel`` and
+   ``libxslt-devel`` packages into your system.
+
+After you've got the requisite dependencies installed, you may install
+:mod:`repoze.bfg` into your Python environment using the following
+command::
 
   $ easy_install -i http://dist.repoze.org/lemonade/dev/simple repoze.bfg
 
diff --git a/docs/tutorials/lxmlgraph/step04.rst b/docs/tutorials/lxmlgraph/step04.rst
index 35e0b9aa9..59b6e6003 100644
--- a/docs/tutorials/lxmlgraph/step04.rst
+++ b/docs/tutorials/lxmlgraph/step04.rst
@@ -41,7 +41,7 @@ current hop in the URL.  For ``repoze.lxmlgraph``, that "context"
 object is a node in the XML document, found by traversing node
 children.
 
-For the XSLT in Step 03, we passed in the context node.  From the
+For the XSLT in Step 3, we passed in the context node.  From the
 XSLT's perpective, the universe started at the context node.  It could
 only see information in that node and the children beneath it.