2
0
mirror of https://gitlab.isc.org/isc-projects/kea synced 2025-08-30 21:45:37 +00:00

[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

This commit is contained in:
Francis Dupont
2019-02-04 16:22:09 +01:00
parent 5494082762
commit 11483d5d73

View File

@@ -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>