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:
@@ -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>
|
||||
|
Reference in New Issue
Block a user