From 6898976218c814ea73e88bda9b865c6bcb9df804 Mon Sep 17 00:00:00 2001
From: Ray Speth <speth@mit.edu>
Date: Tue, 10 Mar 2015 22:41:37 +0000
Subject: [PATCH] [Doc] Update compilation documentation

---
 doc/sphinx/compiling.rst | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/doc/sphinx/compiling.rst b/doc/sphinx/compiling.rst
index 6525235f0..662206fd2 100644
--- a/doc/sphinx/compiling.rst
+++ b/doc/sphinx/compiling.rst
@@ -161,6 +161,11 @@ General
 
 * run ``scons help`` to see a list all configuration options for Cantera, or
   see :ref:`scons-config`.
+* Configuration options are specified as additional arguments to the ``scons``
+  command, e.g.::
+
+    scons build -j4 blas_lapack_libs=lapack,blas
+
 * If the prerequisites are installed in standard locations, the default values
   should work.
 * If you installed Sundials to a non-standard location (e.g. the libraries
@@ -186,6 +191,12 @@ General
 
     option_name=
 
+* Sometimes, changes in your environment can cause SCons's configuration tests
+  (e.g. checking for libraries or compiler capabilities) to unexpectedly fail.
+  To force SCons to re-run these tests rather than trusting the cached results,
+  run scons with the option ``--config=force``.
+
+
 Python Module
 -------------
 
@@ -327,6 +338,19 @@ Compile Cantera & Test
     * Messages printed to the console while running scons test
     * Output files generated by the tests
 
+Building Documentation
+----------------------
+
+* To build the Cantera HTML documentation, run the commands::
+
+    scons doxygen
+    scons sphinx
+
+  or append the options `sphinx_docs=y` and `doxygen_docs=y` to the build
+  command, e.g.::
+
+    scons build doxygen_docs=y sphinx_docs=y
+
 MinGW Compilation problems
 --------------------------