From 11483d5d73b5c88cf4905e6acad95888c238b808 Mon Sep 17 00:00:00 2001
From: Francis Dupont <fdupont@isc.org>
Date: Mon, 4 Feb 2019 16:22:09 +0100
Subject: [PATCH] 
 [117-configure-script-doesn-t-fail-when-enable-generate-docs-is-used-and-docbook-style-xsl-is-not-installed]
 Reviewed and completed generate docs description

---
 doc/guide/install.xml | 34 ++++++++++++----------------------
 1 file changed, 12 insertions(+), 22 deletions(-)

diff --git a/doc/guide/install.xml b/doc/guide/install.xml
index 9a63c30570..dfc847671f 100644
--- a/doc/guide/install.xml
+++ b/doc/guide/install.xml
@@ -409,20 +409,6 @@ Debian and Ubuntu:
           developers or people who want to extend Kea code or send patches:
           <variablelist>
 
-            <varlistentry>
-              <term>--enable-generate-docs</term>
-              <listitem>
-                <simpara>Enable the rebuilding Kea documentation. ISC publishes
-                Kea documentation for each release. However, in some cases you
-                may want to rebuild it. For example, if you want to change
-                something in the docs, or want to generate new one from git
-                sources that are not released yet.
-                <!-- @todo: describe what's needed here (xsltproc, also describe
-                     nonet variable -->
-                </simpara>
-              </listitem>
-            </varlistentry>
-
             <varlistentry>
               <term>--with-gtest, --with-gtest-source</term>
               <listitem>
@@ -444,8 +430,12 @@ Debian and Ubuntu:
                 may want to rebuild it. For example, if you want to change
                 something in the docs, or want to generate new one from git
                 sources that are not released yet.
-                <!-- @todo: describe what's needed here (xsltproc, also describe
-                     nonet variable -->
+
+                The build procedure uses the xsltproc tool with the
+                nonet argument which disables fetching missing sources, e.g
+                docbook.xsl, from the Internet. If you want anyway to use
+                the Internet please set the XSLTPROC_NET environment variable
+                in configure.
                 </simpara>
               </listitem>
             </varlistentry>
@@ -453,13 +443,13 @@ Debian and Ubuntu:
             <varlistentry>
               <term>--enable-generate-parser</term>
               <listitem>
-                <simpara>Many Kea components have parsers implemented using Flex
-                (.ll files) and Bison (.yy files). Kea sources have C++/h files
-                generated out from them. By default Kea does not use Flex or
-                Bison to avoid requiring installation of unnecessary
+                <simpara>Many Kea components have parsers implemented using flex
+                (.ll files) and bison (.yy files). Kea sources have C++/h files
+                generated out from them. By default Kea does not use flex or
+                bison to avoid requiring installation of unnecessary
                 dependencies for users. However, if you change anything in the
-                parses (such as add new parameter), you will need to use Flex
-                and Bison to regenerate parsers. This option lets you do that.
+                parses (such as add new parameter), you will need to use flex
+                and bison to regenerate parsers. This option lets you do that.
                 </simpara>
               </listitem>
             </varlistentry>
-- 
2.47.2