diff --git a/v2/doc/src/fragments.xml b/v2/doc/src/fragments.xml
index 3106ca62e..78438a0c1 100644
--- a/v2/doc/src/fragments.xml
+++ b/v2/doc/src/fragments.xml
@@ -6,53 +6,54 @@
   <section id="root_option">
     <varlistentry>
       <term><literal>root</literal></term>
-      
-      <!-- At present, this option is only used to set LD_LIBRARY_PATH
-      when running tests, and matters only if compiler's lib directory
-      is not in LD_LIBRARY_PATH -->
 
-      <listitem><para>Specifies root directory of the compiler
-      installation. This option is necessary only if it's not possible
-      to detect this information from the compiler command&#x2014;for
-      example if the specified compiler command is a user script. </para>
-      </listitem>
+      <!-- At present, this option is only used to set LD_LIBRARY_PATH when
+      running tests, and matters only if compiler's lib directory is not in
+      LD_LIBRARY_PATH. -->
+
+      <listitem><para>Specifies root directory of the compiler installation.
+      This option is necessary only if it is not possible to detect this
+      information from the compiler command&#x2014;for example if the specified
+      compiler command is a user script.</para></listitem>
     </varlistentry>
   </section>
 
   <section id="common_options">
-    
+
+    <!-- This most likely needs splitting into common_options,
+    common_cxx_options & common_fortran_options or something similar. We also
+    need to document the fortran specific fflags option. Possibly related Boost
+    Build code should be updated as well so that fortran options may not be
+    specified for non-fortran toolsets and C/C++ options may not be specified
+    for non-C/C++ ones. -->
+
     <varlistentry>
       <term><literal>cflags</literal></term>
-      
-      <listitem><para>Specifies additional compiler flags that
-      will be used when compiling C sources.</para>
-      </listitem>
+
+      <listitem><para>Specifies additional compiler flags that will be used when
+      compiling C sources.</para></listitem>
     </varlistentry>
-    
+
     <varlistentry>
       <term><literal>cxxflags</literal></term>
-      
-      <listitem><para>Specifies additional compiler flags that
-      will be used when compiling C++ sources.</para>
-      </listitem>
+
+      <listitem><para>Specifies additional compiler flags that will be used when
+      compiling C++ sources.</para></listitem>
     </varlistentry>
 
     <varlistentry>
       <term><literal>compileflags</literal></term>
-      
-      <listitem><para>Specifies additional compiler flags that
-      will be used when compiling both C and C++ sources.</para>
-      </listitem>
+
+      <listitem><para>Specifies additional compiler flags that will be used when
+      compiling both C and C++ sources.</para></listitem>
     </varlistentry>
 
     <varlistentry>
       <term><literal>linkflags</literal></term>
-      
-      <listitem><para>Specifies additional command line options
-      that will be passed to the linker.</para>
+
+      <listitem><para>Specifies additional command line options that will be
+      passed to the linker.</para>
       </listitem>
     </varlistentry>
-
   </section>
-
 </chapter>