Update to Eng setup.xml + infostyle

This commit is contained in:
Mikhail Alferov
2024-07-10 15:58:03 +03:00
committed by GitHub
parent 1b726c91c8
commit d2d28bafb9

View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?> <?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6ec541d590b598769e62d9220121538f3a2925b2 Maintainer: tmn Status: ready --> <!-- EN-Revision: 765b2d6eec7dfbaeed900b32aa91a1360d73df42 Maintainer: tmn Status: ready -->
<!-- Reviewed: no --> <!-- Reviewed: no -->
<chapter xml:id="libxml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <chapter xml:id="libxml.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -9,8 +9,8 @@
<section xml:id="libxml.requirements"> <section xml:id="libxml.requirements">
&reftitle.required; &reftitle.required;
<para> <para>
Для работы этого модуля требуется библиотека <link xlink:href="&url.libxml;">libxml</link> &gt;= Для работы модуля с PHP 8.0 требуется библиотека <link xlink:href="&url.libxml;">libxml</link> &gt;=
2.9.0 с PHP 8.0, или libxml &gt;= 2.6.0 до PHP 8.0. 2.9.0 или libxml &gt;= 2.6.0 до PHP 8.0.
</para> </para>
</section> </section>
<!-- }}} --> <!-- }}} -->
@ -19,15 +19,15 @@
<section xml:id="libxml.installation"> <section xml:id="libxml.installation">
<title>Установка для PHP &gt;= 7.4</title> <title>Установка для PHP &gt;= 7.4</title>
<para> <para>
Модуль libxml включён по умолчанию, но может быть отключён при указании директивы Модуль libxml включён по умолчанию, но модуль можно отключить опцией
<option role="configure">--without-libxml</option>. <option role="configure">--without-libxml</option>.
</para> </para>
<para> <para>
PHP использует утилиту <literal>pkg-config</literal> для выбора правильного файла библиотеки, заголовочных файлов PHP использует утилиту <literal>pkg-config</literal> для выбора правильного файла библиотеки, заголовочных файлов
и флагов компиляции для работы с модулем libxml2. и флагов компиляции для работы с модулем libxml2.
Чтобы убедиться, что выбрана желаемая версия модуля libxml2, Чтобы убедиться в правильности выбора версии модуля libxml2,
можно перед запуском сценария настройки через переменную окружения <envar>PKG_CONFIG_PATH</envar> перед запуском сценария настройки через переменную окружения <envar>PKG_CONFIG_PATH</envar>
указать утилите <literal>pkg-config</literal> путь для поиска нужной версии модуля: указывают утилите <literal>pkg-config</literal> путь для поиска необходимой версии модуля:
<![CDATA[PKG_CONFIG_PATH="/path/to/libxml2/prefix/lib/pkgconfig:/lib/pkgconfig"]]> <![CDATA[PKG_CONFIG_PATH="/path/to/libxml2/prefix/lib/pkgconfig:/lib/pkgconfig"]]>
</para> </para>
</section> </section>
@ -37,21 +37,21 @@
<section xml:id="libxml.installation_old"> <section xml:id="libxml.installation_old">
<title>Установка для PHP &lt; 7.4</title> <title>Установка для PHP &lt; 7.4</title>
<para> <para>
Модуль libxml включён по умолчанию, но может быть отключён Модуль libxml включён по умолчанию, но модуль можно отключить
посредством директивы <option role="configure">--disable-libxml</option>. опцией <option role="configure">--disable-libxml</option>.
</para> </para>
<para> <para>
Необязательная директива <option role="configure">--with-libxml-dir</option> Необязательная директива <option role="configure">--with-libxml-dir</option>
используется для задания расположения модуля <literal>libxml</literal> в системах, указывает расположение модуля <literal>libxml</literal> в системе,
на которых PHP скомпилирован, если директива не используется, поиск в которой компилируется PHP, иначе сканируются
будет производиться только по стандартным путям. Процесс <literal>configure</literal> только расположения по умолчанию. Процесс <literal>configure</literal>
производит поиск libxml (особенно, <literal>xml2-config</literal>) ищет модуль libxml (в частности, скрипт <literal>xml2-config</literal>)
по путям в следующем порядке: по путям в следующем порядке:
</para> </para>
<orderedlist> <orderedlist>
<listitem> <listitem>
<para> <para>
Расположение ([DIR]), указанное с помощью директивы Расположение ([DIR]), которое указали директивой
<option role="configure">--with-libxml-dir</option> <option role="configure">--with-libxml-dir</option>
([DIR]=<filename>/bin/xml2-config</filename>) ([DIR]=<filename>/bin/xml2-config</filename>)
</para> </para>
@ -68,21 +68,14 @@
</listitem> </listitem>
</orderedlist> </orderedlist>
<para> <para>
Если <literal>configure</literal> не найдёт <filename>xml2-config</filename> Если <literal>configure</literal> не найдёт скрипт <filename>xml2-config</filename>
в директории, заданной директивой в директории, которую задали в директиве
<option role="configure">--with-libxml-dir</option>, он продолжит <option role="configure">--with-libxml-dir</option>, процесс продолжит
поиск по стандартным путям. поиск по стандартным путям.
</para> </para>
</section> </section>
<!-- }}} --> <!-- }}} -->
<!-- {{{ Configuration -->
<section xml:id="libxml.configuration">
&reftitle.runtime;
&no.config;
</section>
<!-- }}} -->
<!-- {{{ Resources --> <!-- {{{ Resources -->
<section xml:id="libxml.resources"> <section xml:id="libxml.resources">
&reftitle.resources; &reftitle.resources;