From: Wolfgang Bangerth <bangerth@colostate.edu>
Date: Sat, 18 May 2019 11:36:25 +0000 (-0600)
Subject: Update a comment in the doxygen options file.
X-Git-Tag: v9.2.0-rc1~1469^2
X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F8239%2Fhead;p=dealii.git

Update a comment in the doxygen options file.
---

diff --git a/doc/doxygen/options.dox.in b/doc/doxygen/options.dox.in
index 133ed43761..832764b0db 100644
--- a/doc/doxygen/options.dox.in
+++ b/doc/doxygen/options.dox.in
@@ -158,11 +158,14 @@ SEARCH_INCLUDES        = YES
 INCLUDE_PATH           = @CMAKE_SOURCE_DIR@/include @CMAKE_BINARY_DIR@/include @_inst_in_dirs@
 INCLUDE_FILE_PATTERNS  =
 
-# set a few variables that help us generate documentation for
-# things like the PETSc and Trilinos wrappers, even if they were
-# not configured
+# Set a few variables that help us generate documentation for things
+# like the PETSc and Trilinos wrappers, even if they were not
+# configured. We want to do that because we want the documentation to
+# reflect the most complete picture of the library, even if the system
+# on which the documentation was built doesn't actually have all
+# possible dependencies installed.
 #
-# in the case of DEAL_II_NAMESPACE_OPEN/CLOSE, just expand them
+# In the case of DEAL_II_NAMESPACE_OPEN/CLOSE, just expand them
 # to nothing so that they don't show up in the documentation
 # at all.
 PREDEFINED             = DOXYGEN=1 \