diff -r 1631a31aa805 index.rst
--- a/index.rst	Mon Apr 13 11:29:54 2015 -0400
+++ b/index.rst	Mon Apr 13 16:48:52 2015 -0400
@@ -19,7 +19,8 @@
       hg clone https://hg.python.org/cpython
 
 2. :ref:`Build Python <compiling>`.  On all platforms, install build
-   dependencies (such as compilers), then on :ref:`UNIX <unix-compiling>`::
+   dependencies (such as compilers). On :ref:`UNIX <unix-compiling>`
+   (including Mac OS X)::
 
       ./configure --with-pydebug && make -j2
 
@@ -27,6 +28,10 @@
 
       PCbuild\build.bat -e -d
 
+   If the build outputs warnings or errors, :ref:`build-dependencies` provides
+   detail on standard library extensions that depend on installing third-party
+   libraries for some operating systems.
+
 3. :doc:`Run the tests <runtests>`::
 
    ./python -m test -j3
diff -r 1631a31aa805 setup.rst
--- a/setup.rst	Mon Apr 13 11:29:54 2015 -0400
+++ b/setup.rst	Mon Apr 13 16:48:52 2015 -0400
@@ -85,6 +85,8 @@
 one should not skip.
 
 
+.. _build-dependencies:
+
 Build dependencies
 ''''''''''''''''''
 
@@ -272,7 +274,7 @@
 dependencies.
 
 Once built you might want to set Python as a startup project. Pressing F5 in
-Visual Studio, or choosing :menuselection:`Start Debugging` from the 
+Visual Studio, or choosing :menuselection:`Start Debugging` from the
 :menuselection:`Debug` menu, will launch the interpreter.
 
 .. _win-python.exe: