From 59b15fe0be0ef5389df3b1af61408dc500f63add Mon Sep 17 00:00:00 2001
From: Paul Romano <paul.k.romano@gmail.com>
Date: Mon, 8 Jan 2018 08:34:57 -0600
Subject: [PATCH] Address a few @nelsonag comments in review

---
 docs/source/releasenotes.rst       |  3 +++
 docs/source/usersguide/install.rst | 24 +++++++++++++++---------
 2 files changed, 18 insertions(+), 9 deletions(-)

diff --git a/docs/source/releasenotes.rst b/docs/source/releasenotes.rst
index 4cacd4a7f0..28af52f5f4 100644
--- a/docs/source/releasenotes.rst
+++ b/docs/source/releasenotes.rst
@@ -26,6 +26,9 @@ of:
     mat.add_nuclide('H1', 1.0)
     mat.isotropic = ['H1']
 
+  To treat all nuclides in a material this way, the
+  :meth:`Material.make_isotropic_in_lab` method can still be used.
+
 - The initializers for :class:`openmc.Intersection` and :class:`openmc.Union`
   now expect an iterable.
 
diff --git a/docs/source/usersguide/install.rst b/docs/source/usersguide/install.rst
index 1fee22e71f..b595729236 100644
--- a/docs/source/usersguide/install.rst
+++ b/docs/source/usersguide/install.rst
@@ -116,21 +116,27 @@ Prerequisites
       OpenMC uses HDF5 for many input/output files. As such, you will need to
       have HDF5 installed on your computer. The installed version will need to
       have been compiled with the same compiler you intend to compile OpenMC
-      with. On Debian derivatives, HDF5 and/or parallel HDF5 can be installed
-      through the APT package manager:
-
-      .. code-block:: sh
+      with. If compiling with gcc from the APT repositories, users of Debian
+      derivatives can install HDF5 and/or parallel HDF5 through the package
+      manager::
 
           sudo apt install libhdf5-dev
 
+      Parallel versions of the HDF5 library called `libhdf5-mpich-dev` and
+      `libhdf5-openmpi-dev` exist which are built against MPICH and OpenMPI,
+      respectively. To link against a parallel HDF5 library, make sure to set
+      the HDF5_PREFER_PARALLEL CMake option, e.g.::
+
+          FC=mpifort.mpich cmake -DHDF5_PREFER_PARALLEL=on ..
+
       Note that the exact package names may vary depending on your particular
-      distribution and version. If you are using HDF5 in conjunction with MPI,
-      we recommend that your HDF5 installation be built with parallel I/O
+      distribution and version.
+
+      If you are using building HDF5 from source in conjunction with MPI, we
+      recommend that your HDF5 installation be built with parallel I/O
       features. An example of configuring HDF5_ is listed below::
 
-           FC=/opt/mpich/3.2/bin/mpif90 CC=/opt/mpich/3.2/bin/mpicc \
-           ./configure --prefix=/opt/hdf5/1.10.1 --enable-fortran \
-                       --enable-parallel
+           FC=mpifort ./configure --enable-fortran --enable-parallel
 
       You may omit ``--enable-parallel`` if you want to compile HDF5_ in serial.