[DOC-CVS] [doc-en] master: enchant: fix XML to get remove of useless wrapping para tags (#5113)

[email protected] (Gina Peter Banyard via GitHub)
Newsgroups php.doc.cvs
Message-ID <[email protected]>
Author: Gina Peter Banyard (Girgias)
Committer: GitHub (web-flow)
Pusher: Girgias
Date: 2026-01-15T22:36:23Z

Commit: https://github.com/php/doc-en/commit/9ee6a360c83bc83ee0f78d853278742d2ad9c3cd
Raw diff: https://github.com/php/doc-en/commit/9ee6a360c83bc83ee0f78d853278742d2ad9c3cd.diff

enchant: fix XML to get remove of useless wrapping para tags (#5113)

Changed paths:
  M  reference/enchant/constants.xml
  M  reference/enchant/functions/enchant-broker-describe.xml
  M  reference/enchant/functions/enchant-broker-dict-exists.xml
  M  reference/enchant/functions/enchant-broker-free-dict.xml
  M  reference/enchant/functions/enchant-broker-free.xml
  M  reference/enchant/functions/enchant-broker-get-dict-path.xml
  M  reference/enchant/functions/enchant-broker-get-error.xml
  M  reference/enchant/functions/enchant-broker-init.xml
  M  reference/enchant/functions/enchant-broker-list-dicts.xml
  M  reference/enchant/functions/enchant-broker-request-dict.xml
  M  reference/enchant/functions/enchant-broker-request-pwl-dict.xml
  M  reference/enchant/functions/enchant-broker-set-dict-path.xml
  M  reference/enchant/functions/enchant-broker-set-ordering.xml
  M  reference/enchant/functions/enchant-dict-add-to-session.xml
  M  reference/enchant/functions/enchant-dict-add.xml
  M  reference/enchant/functions/enchant-dict-check.xml
  M  reference/enchant/functions/enchant-dict-describe.xml
  M  reference/enchant/functions/enchant-dict-get-error.xml
  M  reference/enchant/functions/enchant-dict-is-added.xml
  M  reference/enchant/functions/enchant-dict-quick-check.xml
  M  reference/enchant/functions/enchant-dict-store-replacement.xml
  M  reference/enchant/functions/enchant-dict-suggest.xml


Diff:

diff --git a/reference/enchant/constants.xml b/reference/enchant/constants.xml
index a9dc6d18a94b..3e847d698aeb 100644
--- a/reference/enchant/constants.xml
+++ b/reference/enchant/constants.xml
@@ -1,54 +1,50 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-
-<appendix xml:id="enchant.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="enchant.constants">
  &reftitle.constants;
- <para>
-  <variablelist>
-   <varlistentry xml:id="constant.libenchant-version">
-    <term>
-     <constant>LIBENCHANT_VERSION</constant>
-     (<type>string</type>)
-    </term>
-    <listitem>
-     <simpara>
-      The version of libenchant.
-      Available as of PHP 8.0.0.
-     </simpara>
-    </listitem>
-   </varlistentry>
-   <varlistentry xml:id="constant.enchant-myspell">
-    <term>
-     <constant>ENCHANT_MYSPELL</constant>
-     (<type>int</type>)
-    </term>
-    <listitem>
-     <simpara>
-      Dictionary type for MySpell. Used with
-      <function>enchant_broker_get_dict_path</function> and
-      <function>enchant_broker_set_dict_path</function>.
-      Deprecated as of PHP 8.0.0.
-     </simpara>
-    </listitem>
-   </varlistentry>
-   <varlistentry xml:id="constant.enchant-ispell">
-    <term>
-     <constant>ENCHANT_ISPELL</constant>
-     (<type>int</type>)
-    </term>
-    <listitem>
-     <simpara>
-      Dictionary type for Ispell. Used with
-      <function>enchant_broker_get_dict_path</function> and
-      <function>enchant_broker_set_dict_path</function>.
-      Deprecated as of PHP 8.0.0.
-     </simpara>
-    </listitem>
-   </varlistentry>
-  </variablelist>
- </para>
+ <variablelist>
+  <varlistentry xml:id="constant.libenchant-version">
+   <term>
+    <constant>LIBENCHANT_VERSION</constant>
+    (<type>string</type>)
+   </term>
+   <listitem>
+    <simpara>
+     The version of libenchant.
+     Available as of PHP 8.0.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.enchant-myspell">
+   <term>
+    <constant>ENCHANT_MYSPELL</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Dictionary type for MySpell. Used with
+     <function>enchant_broker_get_dict_path</function> and
+     <function>enchant_broker_set_dict_path</function>.
+     Deprecated as of PHP 8.0.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry xml:id="constant.enchant-ispell">
+   <term>
+    <constant>ENCHANT_ISPELL</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Dictionary type for Ispell. Used with
+     <function>enchant_broker_get_dict_path</function> and
+     <function>enchant_broker_set_dict_path</function>.
+     Deprecated as of PHP 8.0.0.
+    </simpara>
+   </listitem>
+  </varlistentry>
+ </variablelist>
 </appendix>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
@@ -69,4 +65,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-
diff --git a/reference/enchant/functions/enchant-broker-describe.xml b/reference/enchant/functions/enchant-broker-describe.xml
index 250a86f23cf2..edb3436539c1 100644
--- a/reference/enchant/functions/enchant-broker-describe.xml
+++ b/reference/enchant/functions/enchant-broker-describe.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-describe" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-describe">
  <refnamediv>
   <refname>enchant_broker_describe</refname>
   <refpurpose>Enumerates the Enchant providers</refpurpose>
@@ -19,11 +19,9 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -58,10 +56,9 @@
 
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>List the backends provided by the given broker</title>
-    <programlisting role="php">
+  <example>
+   <title>List the backends provided by the given broker</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 $r = enchant_broker_init();
@@ -71,9 +68,9 @@ print_r($bprovides);
 
 ?>
 ]]>
-    </programlisting>
-    &example.outputs.similar;
-    <screen>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
 <![CDATA[
 Current broker provides the following backend(s):
 Array
@@ -108,9 +105,8 @@ Array
 
 )
 ]]>
-    </screen>
-   </example>
-  </para>
+   </screen>
+  </example>
  </refsect1>
 
 
diff --git a/reference/enchant/functions/enchant-broker-dict-exists.xml b/reference/enchant/functions/enchant-broker-dict-exists.xml
index b22dbf6d8ada..45829a11cf5a 100644
--- a/reference/enchant/functions/enchant-broker-dict-exists.xml
+++ b/reference/enchant/functions/enchant-broker-dict-exists.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-dict-exists" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-dict-exists">
  <refnamediv>
   <refname>enchant_broker_dict_exists</refname>
   <refpurpose>Whether a dictionary exists or not. Using non-empty tag</refpurpose>
@@ -18,19 +18,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-    <varlistentry>
-     <term><parameter>tag</parameter></term>
-     <listitem>
-      <para>
-       non-empty tag in the LOCALE format, ex: us_US, ch_DE, etc.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+   <varlistentry>
+    <term><parameter>tag</parameter></term>
+    <listitem>
+     <para>
+      non-empty tag in the LOCALE format, ex: us_US, ch_DE, etc.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -59,10 +57,9 @@
 
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>A <function>enchant_broker_dict_exists</function> example</title>
-    <programlisting role="php">
+  <example>
+   <title>A <function>enchant_broker_dict_exists</function> example</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 $tag = 'en_US';
@@ -72,19 +69,16 @@ if (enchant_broker_dict_exists($r,$tag)) {
 }
 ?>
 ]]>
-    </programlisting>
-   </example>
-  </para>
+   </programlisting>
+  </example>
  </refsect1>
 
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_describe</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_describe</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-broker-free-dict.xml b/reference/enchant/functions/enchant-broker-free-dict.xml
index 96f90ae8266e..3bf38a218920 100644
--- a/reference/enchant/functions/enchant-broker-free-dict.xml
+++ b/reference/enchant/functions/enchant-broker-free-dict.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-free-dict" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-free-dict">
  <refnamediv>
   <refname>enchant_broker_free_dict</refname>
   <refpurpose>Free a dictionary resource</refpurpose>
@@ -24,11 +24,9 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -69,12 +67,10 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_request_dict</function></member>
-    <member><function>enchant_broker_request_pwl_dict</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_request_dict</function></member>
+   <member><function>enchant_broker_request_pwl_dict</function></member>
+  </simplelist>
  </refsect1>
 
 
diff --git a/reference/enchant/functions/enchant-broker-free.xml b/reference/enchant/functions/enchant-broker-free.xml
index 00233842a33f..a9a34eafbd59 100644
--- a/reference/enchant/functions/enchant-broker-free.xml
+++ b/reference/enchant/functions/enchant-broker-free.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-free" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-free">
  <refnamediv>
   <refname>enchant_broker_free</refname>
   <refpurpose>Free the broker resource and its dictionaries</refpurpose>
@@ -25,11 +25,9 @@
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -64,11 +62,9 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_init</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_init</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-broker-get-dict-path.xml b/reference/enchant/functions/enchant-broker-get-dict-path.xml
index f9230cf18f09..bd707c70f4cf 100644
--- a/reference/enchant/functions/enchant-broker-get-dict-path.xml
+++ b/reference/enchant/functions/enchant-broker-get-dict-path.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-get-dict-path" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-get-dict-path">
  <refnamediv>
   <refname>enchant_broker_get_dict_path</refname>
   <refpurpose>Get the directory path for a given backend</refpurpose>
  </refnamediv>
- 
+
  <refsynopsisdiv>
    &warn.deprecated.function-8-0-0;
  </refsynopsisdiv>
@@ -22,23 +22,21 @@
    Get the directory path for a given backend.
   </para>
  </refsect1>
- 
+
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-    <varlistentry>
-     <term><parameter>type</parameter></term>
-     <listitem>
-      <para>
-       The type of the dictionaries, i.e. <constant>ENCHANT_MYSPELL</constant>
-       or <constant>ENCHANT_ISPELL</constant>.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+   <varlistentry>
+    <term><parameter>type</parameter></term>
+    <listitem>
+     <para>
+      The type of the dictionaries, i.e. <constant>ENCHANT_MYSPELL</constant>
+      or <constant>ENCHANT_ISPELL</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -83,11 +81,9 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_set_dict_path</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_set_dict_path</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/enchant/functions/enchant-broker-get-error.xml b/reference/enchant/functions/enchant-broker-get-error.xml
index 007e6cb4f534..c70cf121a7ad 100644
--- a/reference/enchant/functions/enchant-broker-get-error.xml
+++ b/reference/enchant/functions/enchant-broker-get-error.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-get-error" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-get-error">
  <refnamediv>
   <refname>enchant_broker_get_error</refname>
   <refpurpose>Returns the last error of the broker</refpurpose>
@@ -18,11 +18,9 @@
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
diff --git a/reference/enchant/functions/enchant-broker-init.xml b/reference/enchant/functions/enchant-broker-init.xml
index 50daeff8e355..1bf7ee8ebcb8 100644
--- a/reference/enchant/functions/enchant-broker-init.xml
+++ b/reference/enchant/functions/enchant-broker-init.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-init" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-init">
  <refnamediv>
   <refname>enchant_broker_init</refname>
   <refpurpose>Create a new broker object capable of requesting</refpurpose>
@@ -50,11 +50,9 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_free</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_free</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-broker-list-dicts.xml b/reference/enchant/functions/enchant-broker-list-dicts.xml
index 27fe06d7abac..4aa1a707230d 100644
--- a/reference/enchant/functions/enchant-broker-list-dicts.xml
+++ b/reference/enchant/functions/enchant-broker-list-dicts.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-list-dicts" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-list-dicts">
  <refnamediv>
   <refname>enchant_broker_list_dicts</refname>
   <refpurpose>Returns a list of available dictionaries</refpurpose>
@@ -18,11 +18,9 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -57,10 +55,9 @@
 
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>List all available dictionaries for one broker</title>
-    <programlisting role="php">
+  <example>
+   <title>List all available dictionaries for one broker</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 $r = enchant_broker_init();
@@ -68,9 +65,9 @@ $dicts = enchant_broker_list_dicts($r);
 print_r($dicts);
 ?>
 ]]>
-    </programlisting>
-    &example.outputs.similar;
-    <screen>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
 <![CDATA[
 Array
 (
@@ -124,18 +121,15 @@ Array
 
 )
 ]]>
-    </screen>
-   </example>
-  </para>
+   </screen>
+  </example>
  </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_describe</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_describe</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/enchant/functions/enchant-broker-request-dict.xml b/reference/enchant/functions/enchant-broker-request-dict.xml
index bf7cf81f8feb..d32b800c498b 100644
--- a/reference/enchant/functions/enchant-broker-request-dict.xml
+++ b/reference/enchant/functions/enchant-broker-request-dict.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-request-dict" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-request-dict">
  <refnamediv>
   <refname>enchant_broker_request_dict</refname>
   <refpurpose>Create a new dictionary using a tag</refpurpose>
@@ -19,19 +19,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-    <varlistentry>
-     <term><parameter>tag</parameter></term>
-     <listitem>
-      <para>
-       A tag describing the locale, for example en_US, de_DE
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+   <varlistentry>
+    <term><parameter>tag</parameter></term>
+    <listitem>
+     <para>
+      A tag describing the locale, for example en_US, de_DE
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -90,13 +88,11 @@ if (enchant_broker_dict_exists($broker,$tag)) {
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_dict_describe</function></member>
-    <member><function>enchant_broker_dict_exists</function></member>
-    <member><function>enchant_broker_free_dict</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_dict_describe</function></member>
+   <member><function>enchant_broker_dict_exists</function></member>
+   <member><function>enchant_broker_free_dict</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-broker-request-pwl-dict.xml b/reference/enchant/functions/enchant-broker-request-pwl-dict.xml
index 7bf0e24b1ff7..c6d664fd2b0e 100644
--- a/reference/enchant/functions/enchant-broker-request-pwl-dict.xml
+++ b/reference/enchant/functions/enchant-broker-request-pwl-dict.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-request-pwl-dict" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-request-pwl-dict">
  <refnamediv>
   <refname>enchant_broker_request_pwl_dict</refname>
   <refpurpose>Creates a dictionary using a PWL file</refpurpose>
@@ -19,20 +19,18 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-    <varlistentry>
-     <term><parameter>filename</parameter></term>
-     <listitem>
-      <para>
-       Path to the PWL file.
-       If there is no such file, a new one will be created if possible.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+   <varlistentry>
+    <term><parameter>filename</parameter></term>
+    <listitem>
+     <para>
+      Path to the PWL file.
+      If there is no such file, a new one will be created if possible.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -68,13 +66,11 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_dict_describe</function></member>
-    <member><function>enchant_broker_dict_exists</function></member>
-    <member><function>enchant_broker_free_dict</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_dict_describe</function></member>
+   <member><function>enchant_broker_dict_exists</function></member>
+   <member><function>enchant_broker_free_dict</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-broker-set-dict-path.xml b/reference/enchant/functions/enchant-broker-set-dict-path.xml
index e160af9c31e0..6b0db94c9e92 100644
--- a/reference/enchant/functions/enchant-broker-set-dict-path.xml
+++ b/reference/enchant/functions/enchant-broker-set-dict-path.xml
@@ -1,11 +1,11 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-set-dict-path" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-set-dict-path">
  <refnamediv>
   <refname>enchant_broker_set_dict_path</refname>
   <refpurpose>Set the directory path for a given backend</refpurpose>
  </refnamediv>
- 
+
  <refsynopsisdiv>
    &warn.deprecated.function-8-0-0;
  </refsynopsisdiv>
@@ -23,31 +23,29 @@
    Set the directory path for a given backend.
   </para>
  </refsect1>
- 
+
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-    <varlistentry>
-     <term><parameter>type</parameter></term>
-     <listitem>
-      <para>
-       The type of the dictionaries, i.e. <constant>ENCHANT_MYSPELL</constant>
-       or <constant>ENCHANT_ISPELL</constant>.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>path</parameter></term>
-     <listitem>
-      <para>
-       The path of the dictionary directory.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+   <varlistentry>
+    <term><parameter>type</parameter></term>
+    <listitem>
+     <para>
+      The type of the dictionaries, i.e. <constant>ENCHANT_MYSPELL</constant>
+      or <constant>ENCHANT_ISPELL</constant>.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>path</parameter></term>
+    <listitem>
+     <para>
+      The path of the dictionary directory.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -91,11 +89,9 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_get_dict_path</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_get_dict_path</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/enchant/functions/enchant-broker-set-ordering.xml b/reference/enchant/functions/enchant-broker-set-ordering.xml
index 9f6dff3a5e75..9406bfb76bb4 100644
--- a/reference/enchant/functions/enchant-broker-set-ordering.xml
+++ b/reference/enchant/functions/enchant-broker-set-ordering.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-broker-set-ordering" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-broker-set-ordering">
  <refnamediv>
   <refname>enchant_broker_set_ordering</refname>
   <refpurpose>Declares a preference of dictionaries to use for the language</refpurpose>
@@ -24,29 +24,27 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.broker;
-    <varlistentry>
-     <term><parameter>tag</parameter></term>
-     <listitem>
-      <para>
-       Language tag. The special "*" tag can be used as a language tag
-       to declare a default ordering for any language that does not
-       explicitly declare an ordering.
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>ordering</parameter></term>
-     <listitem>
-      <para>
-       Comma delimited list of provider names
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.broker;
+   <varlistentry>
+    <term><parameter>tag</parameter></term>
+    <listitem>
+     <para>
+      Language tag. The special "*" tag can be used as a language tag
+      to declare a default ordering for any language that does not
+      explicitly declare an ordering.
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>ordering</parameter></term>
+    <listitem>
+     <para>
+      Comma delimited list of provider names
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
diff --git a/reference/enchant/functions/enchant-dict-add-to-session.xml b/reference/enchant/functions/enchant-dict-add-to-session.xml
index 51ad6fc75d0c..20ed9c3b7a96 100644
--- a/reference/enchant/functions/enchant-dict-add-to-session.xml
+++ b/reference/enchant/functions/enchant-dict-add-to-session.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-add-to-session" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-add-to-session">
  <refnamediv>
   <refname>enchant_dict_add_to_session</refname>
   <refpurpose>Add 'word' to this spell-checking session</refpurpose>
@@ -20,19 +20,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>word</parameter></term>
-     <listitem>
-      <para>
-       The word to add
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>word</parameter></term>
+    <listitem>
+     <para>
+      The word to add
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
@@ -61,11 +59,9 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_request_dict</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_request_dict</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-dict-add.xml b/reference/enchant/functions/enchant-dict-add.xml
index db82c696c7e6..21e473d1dbf1 100644
--- a/reference/enchant/functions/enchant-dict-add.xml
+++ b/reference/enchant/functions/enchant-dict-add.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-add" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-add">
  <refnamediv>
   <refname>enchant_dict_add</refname>
   <refpurpose>Add a word to personal word list</refpurpose>
@@ -18,19 +18,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>word</parameter></term>
-     <listitem>
-      <para>
-       The word to add
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>word</parameter></term>
+    <listitem>
+     <para>
+      The word to add
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
@@ -38,7 +36,7 @@
    &return.success;
   </para>
  </refsect1>
- 
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -80,12 +78,10 @@ enchant_dict_add($dict, $word);
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_broker_request_pwl_dict</function></member>
-    <member><function>enchant_broker_request_dict</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_broker_request_pwl_dict</function></member>
+   <member><function>enchant_broker_request_dict</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-dict-check.xml b/reference/enchant/functions/enchant-dict-check.xml
index 01dce2f0826d..e8bcebc176cc 100644
--- a/reference/enchant/functions/enchant-dict-check.xml
+++ b/reference/enchant/functions/enchant-dict-check.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-check" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-check">
  <refnamediv>
   <refname>enchant_dict_check</refname>
   <refpurpose>Check whether a word is correctly spelled or not</refpurpose>
@@ -19,19 +19,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>word</parameter></term>
-     <listitem>
-      <para>
-       The word to check
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>word</parameter></term>
+    <listitem>
+     <para>
+      The word to check
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
diff --git a/reference/enchant/functions/enchant-dict-describe.xml b/reference/enchant/functions/enchant-dict-describe.xml
index 71594da27ee9..47e744707eac 100644
--- a/reference/enchant/functions/enchant-dict-describe.xml
+++ b/reference/enchant/functions/enchant-dict-describe.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-describe" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-describe">
  <refnamediv>
   <refname>enchant_dict_describe</refname>
   <refpurpose>Describes an individual dictionary</refpurpose>
@@ -18,11 +18,9 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+  </variablelist>
  </refsect1>
 
  <refsect1 role="returnvalues">
diff --git a/reference/enchant/functions/enchant-dict-get-error.xml b/reference/enchant/functions/enchant-dict-get-error.xml
index e2c69f2886f8..7f5307b83281 100644
--- a/reference/enchant/functions/enchant-dict-get-error.xml
+++ b/reference/enchant/functions/enchant-dict-get-error.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-get-error" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-get-error">
  <refnamediv>
   <refname>enchant_dict_get_error</refname>
   <refpurpose>Returns the last error of the current spelling-session</refpurpose>
@@ -18,11 +18,9 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
diff --git a/reference/enchant/functions/enchant-dict-is-added.xml b/reference/enchant/functions/enchant-dict-is-added.xml
index a0491549a3b9..0586d3a65e0e 100644
--- a/reference/enchant/functions/enchant-dict-is-added.xml
+++ b/reference/enchant/functions/enchant-dict-is-added.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-is-added" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-is-added">
  <refnamediv>
   <refname>enchant_dict_is_added</refname>
   <refpurpose>Whether or not 'word' exists in this spelling-session</refpurpose>
@@ -18,19 +18,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>word</parameter></term>
-     <listitem>
-      <para>
-       The word to lookup
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>word</parameter></term>
+    <listitem>
+     <para>
+      The word to lookup
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
@@ -58,11 +56,9 @@
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_dict_add_to_session</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_dict_add_to_session</function></member>
+  </simplelist>
  </refsect1>
 
 </refentry>
diff --git a/reference/enchant/functions/enchant-dict-quick-check.xml b/reference/enchant/functions/enchant-dict-quick-check.xml
index 2ff4570d1f2c..b08bca785c21 100644
--- a/reference/enchant/functions/enchant-dict-quick-check.xml
+++ b/reference/enchant/functions/enchant-dict-quick-check.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-quick-check" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-quick-check">
  <refnamediv>
   <refname>enchant_dict_quick_check</refname>
   <refpurpose>Check the word is correctly spelled and provide suggestions</refpurpose>
@@ -20,28 +20,26 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>word</parameter></term>
-     <listitem>
-      <para>
-       The word to check
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>suggestions</parameter></term>
-     <listitem>
-      <para>
-       If the word is not correctly spelled, this variable will
-       contain an array of suggestions.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>word</parameter></term>
+    <listitem>
+     <para>
+      The word to check
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>suggestions</parameter></term>
+    <listitem>
+     <para>
+      If the word is not correctly spelled, this variable will
+      contain an array of suggestions.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
@@ -69,10 +67,9 @@
 
  <refsect1 role="examples">
   &reftitle.examples;
-  <para>
-   <example>
-    <title>A <function>enchant_dict_quick_check</function> example</title>
-    <programlisting role="php">
+  <example>
+   <title>A <function>enchant_dict_quick_check</function> example</title>
+   <programlisting role="php">
 <![CDATA[
 <?php
 $tag = 'en_US';
@@ -85,9 +82,9 @@ if (enchant_broker_dict_exists($r,$tag)) {
 }
 ?>
 ]]>
-    </programlisting>
-    &example.outputs.similar;
-    <screen>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
 <![CDATA[
 Array
 (
@@ -118,19 +115,16 @@ Array
     [24] => song's
 )
 ]]>
-    </screen>
-   </example>
-  </para>
+   </screen>
+  </example>
  </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_dict_check</function></member>
-    <member><function>enchant_dict_suggest</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_dict_check</function></member>
+   <member><function>enchant_dict_suggest</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
diff --git a/reference/enchant/functions/enchant-dict-store-replacement.xml b/reference/enchant/functions/enchant-dict-store-replacement.xml
index 0f9013471359..25841b1600be 100644
--- a/reference/enchant/functions/enchant-dict-store-replacement.xml
+++ b/reference/enchant/functions/enchant-dict-store-replacement.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-store-replacement" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-store-replacement">
  <refnamediv>
   <refname>enchant_dict_store_replacement</refname>
   <refpurpose>Add a correction for a word</refpurpose>
@@ -22,27 +22,25 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>misspelled</parameter></term>
-     <listitem>
-      <para>
-       The work to fix
-      </para>
-     </listitem>
-    </varlistentry>
-    <varlistentry>
-     <term><parameter>correct</parameter></term>
-     <listitem>
-      <para>
-       The correct word
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>misspelled</parameter></term>
+    <listitem>
+     <para>
+      The work to fix
+     </para>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>correct</parameter></term>
+    <listitem>
+     <para>
+      The correct word
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
diff --git a/reference/enchant/functions/enchant-dict-suggest.xml b/reference/enchant/functions/enchant-dict-suggest.xml
index d1c20a12a927..2d646e721b6e 100644
--- a/reference/enchant/functions/enchant-dict-suggest.xml
+++ b/reference/enchant/functions/enchant-dict-suggest.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<refentry xml:id="function.enchant-dict-suggest" xmlns="http://docbook.org/ns/docbook">
+<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.enchant-dict-suggest">
  <refnamediv>
   <refname>enchant_dict_suggest</refname>
   <refpurpose>Will return a list of values if any of those pre-conditions are not met</refpurpose>
@@ -17,19 +17,17 @@
  </refsect1>
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    &enchant.param.dictionary;
-    <varlistentry>
-     <term><parameter>word</parameter></term>
-     <listitem>
-      <para>
-       Word to use for the suggestions.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   &enchant.param.dictionary;
+   <varlistentry>
+    <term><parameter>word</parameter></term>
+    <listitem>
+     <para>
+      Word to use for the suggestions.
+     </para>
+    </listitem>
+   </varlistentry>
+  </variablelist>
  </refsect1>
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
@@ -83,12 +81,10 @@ if (enchant_broker_dict_exists($r,$tag)) {
 
  <refsect1 role="seealso">
   &reftitle.seealso;
-  <para>
-   <simplelist>
-    <member><function>enchant_dict_check</function></member>
-    <member><function>enchant_dict_quick_check</function></member>
-   </simplelist>
-  </para>
+  <simplelist>
+   <member><function>enchant_dict_check</function></member>
+   <member><function>enchant_dict_quick_check</function></member>
+  </simplelist>
  </refsect1>
 </refentry>
 <!-- Keep this comment at the end of the file
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.