Nits: incomplete and broken sentences

appendices/migration81/deprecated.xml

@@ -208,14 +208,14 @@ $arr[] = 2;
  <sect2 xml:id="migration81.deprecated.hash">
   <title>Hash</title>
 
-  <para>
+  <simpara>
    The <function>mhash</function>,
    <function>mhash_keygen_s2k</function>,
    <function>mhash_count</function>,
    <function>mhash_get_block_size</function>,
-   and <function>mhash_get_hash_name</function> have been deprecated.
+   and <function>mhash_get_hash_name</function> functions have been deprecated.
    Use the <literal>hash_*()</literal> functions instead.
-  </para>
+  </simpara>
  </sect2>
 
  <sect2 xml:id="migration81.deprecated.imap">

appendices/migration81/incompatible.xml

@@ -287,12 +287,12 @@ ArgumentCountError - makeyogurt(): Argument #1 ($container) not passed
    EC private keys will now be exported in <acronym>PKCS</acronym>#8 format rather than
    traditional format, just like all other keys.
   </para>
-  <para>
+  <simpara>
    <function>openssl_pkcs7_encrypt</function> and
-   <function>openssl_cms_encrypt</function> will now to default using
+   <function>openssl_cms_encrypt</function> will now default to using
    AES-128-CBC rather than RC2-40. The RC2-40 cipher is considered
    insecure and not enabled by default by OpenSSL 3.
-  </para>
+  </simpara>
  </sect2>
 
  <sect2 xml:id="migration81.incompatible.pdo">

faq/build.xml

@@ -157,13 +157,13 @@
      </para>
     </question>
     <answer>
-     <para>
-      Some old versions of make that don't correctly put the compiled
+     <simpara>
+      Some old versions of make don't correctly put the compiled
       versions of the files in the functions directory into that same
       directory. Try running <command>cp *.o functions</command> and then
       re-running <command>make</command> to see if that helps. If it does, you should really
       upgrade to a recent version of GNU make.
-     </para>
+     </simpara>
     </answer>
    </qandaentry>
 

install/unix/lighttpd-14.xml

@@ -51,7 +51,7 @@ fastcgi.server = ( ".php" =>
    </screen>
   </example>
 
-  <para>
+  <simpara>
    The <filename>bin-path</filename> directive allows lighttpd to spawn FastCGI processes dynamically.
    PHP will spawn children according to the <envar>PHP_FCGI_CHILDREN</envar> environment
    variable. The <literal>bin-environment</literal> directive sets the environment for the
@@ -60,9 +60,9 @@ fastcgi.server = ( ".php" =>
    <literal>min-procs</literal> and <literal>max-procs</literal> should generally be avoided with PHP. PHP
    manages its own children and opcode caches like APC will only share among
    children managed by PHP. If <literal>min-procs</literal> is set to something greater than <literal>1</literal>,
-   the total number of php responders will be multiplied <envar>PHP_FCGI_CHILDREN</envar>
+   the total number of php responders will be multiplied by <envar>PHP_FCGI_CHILDREN</envar>
    (2 min-procs * 16 children gives 32 responders).
-  </para>
+  </simpara>
  </sect2>
 
  <sect2 xml:id="install.unix.lighttpd-14.spawn-fcgi">

language/oop5/property-hooks.xml

@@ -489,7 +489,7 @@ class PositivePoint extends Point
    <simpara>
     Each hook overrides parent implementations independently of each other.
     If a child class adds hooks, any default value set on the property is removed, and must be redeclared.
-    That is the same consistent with how inheritance works on hook-less properties.
+    That is consistent with how inheritance works on hook-less properties.
    </simpara>
   </sect3>
   <sect3>

language/types/type-system.xml

@@ -171,17 +171,17 @@
 
   <sect3 xml:id="language.types.type-system.composite.union">
    <title>Union types</title>
-   <para>
+   <simpara>
     A union type accepts values of multiple different types,
     rather than a single one.
     Individual types which form the union type are joined by the
     <literal>|</literal> symbol. Therefore, a union type comprised
     of the types <literal>T</literal>, <literal>U</literal>, and
     <literal>V</literal> will be written as <literal>T|U|V</literal>.
     If one of the types is an intersection type, it needs to be bracketed
-    with parenthesis for it to written in <acronym>DNF</acronym>:
+    with parenthesis for it to be written in <acronym>DNF</acronym>:
     <literal>T|(X&amp;Y)</literal>.
-   </para>
+   </simpara>
   </sect3>
  </sect2>
 

reference/array/functions/array-all.xml

@@ -36,6 +36,7 @@
     <listitem>
      <para>
       The callback function to call to check each element, which must be
+      of the following signature:
       <methodsynopsis>
        <type>bool</type><methodname><replaceable>callback</replaceable></methodname>
        <methodparam><type>mixed</type><parameter>value</parameter></methodparam>

reference/array/functions/array-any.xml

@@ -36,6 +36,7 @@
     <listitem>
      <para>
       The callback function to call to check each element, which must be
+      of the following signature:
       <methodsynopsis>
        <type>bool</type><methodname><replaceable>callback</replaceable></methodname>
        <methodparam><type>mixed</type><parameter>value</parameter></methodparam>

reference/array/functions/array-find-key.xml

@@ -36,6 +36,7 @@
     <listitem>
      <para>
       The callback function to call to check each element, which must be
+      of the following signature:
       <methodsynopsis>
        <type>bool</type><methodname><replaceable>callback</replaceable></methodname>
        <methodparam><type>mixed</type><parameter>value</parameter></methodparam>

reference/array/functions/array-find.xml

@@ -36,6 +36,7 @@
     <listitem>
      <para>
       The callback function to call to check each element, which must be
+      of the following signature:
       <methodsynopsis>
        <type>bool</type><methodname><replaceable>callback</replaceable></methodname>
        <methodparam><type>mixed</type><parameter>value</parameter></methodparam>

reference/com/constants.xml

@@ -323,7 +323,7 @@
    </term>
    <listitem>
     <simpara>
-     A pointer to an object that implements the IUnknown interface.
+     A pointer to an object that implements the <interfacename>IUnknown</interfacename> interface.
     </simpara>
    </listitem>
   </varlistentry>
@@ -334,7 +334,7 @@
    </term>
    <listitem>
     <simpara>
-     A pointer to a pointer to an object was specified.
+     A pointer to an object that implements the <interfacename>IDispatch</interfacename> interface.
     </simpara>
    </listitem>
   </varlistentry>

reference/cubrid/constants.xml

@@ -64,7 +64,7 @@
       </row>
       <row>
        <entry><constant>CUBRID_OBJECT</constant></entry>
-       <entry>Get query result an object.</entry>
+       <entry>Get query result as an object.</entry>
       </row>
       <row>
        <entry><constant>CUBRID_LOB</constant></entry>

reference/cubrid/functions/cubrid-connect-with-url.xml

@@ -76,7 +76,7 @@
    </member>
    <member>
     query_timeout : Timeout value (unit: msec.) for query request. Upon timeout,
-    a message to cancel requesting a query transferred to server is sent. The return
+    a message to cancel the requested query is sent to the server. The return
     value can depend on the disconnect_on_query_timeout configuration; even though the
     message to cancel a request is sent to server, that request may succeed.
    </member>

reference/ds/ds.hashable.xml

@@ -11,13 +11,13 @@
 <!-- {{{ Ds\Hashable intro -->
   <section xml:id="ds-hashable.intro">
    &reftitle.intro;
-   <para>
+   <simpara>
         Hashable is an interface which allows objects to be used as keys.
         It’s an alternative to <function>spl_object_hash</function>,
         which determines an object’s hash based on its handle:
         this means that two objects that are considered equal by an implicit
-        definition would not treated as equal because they are not the same instance.
-   </para>
+        definition would not be treated as equal because they are not the same instance.
+   </simpara>
    <para>
         <function>hash</function> is used to return a scalar value to be used as
         the object's hash value, which determines where it goes in the hash table.

reference/ds/ds/deque/allocate.xml

@@ -13,10 +13,10 @@
    <modifier>public</modifier> <type>void</type><methodname>Ds\Deque::allocate</methodname>
    <methodparam><type>int</type><parameter>capacity</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
     Ensures that enough memory is allocated for a required capacity.
-    This removes the need to reallocate the internal as values are added.
-  </para>
+    This removes the need to reallocate the internal buffer as values are added.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">

reference/ds/ds/map/haskey.xml

@@ -35,9 +35,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-    Returns &true; if the key could found, &false; otherwise.
-  </para>
+  <simpara>
+    Returns &true; if the key could be found, &false; otherwise.
+  </simpara>
  </refsect1>
 
  <refsect1 role="examples">

reference/ds/ds/map/hasvalue.xml

@@ -35,9 +35,9 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-    Returns &true; if the value could found, &false; otherwise.
-  </para>
+  <simpara>
+    Returns &true; if the value could be found, &false; otherwise.
+  </simpara>
  </refsect1>
 
  <refsect1 role="examples">

reference/ds/ds/map/toarray.xml

@@ -19,9 +19,9 @@
     Converts the map to an &array;.
   </para>
   <caution>
-        <para>
-            Maps where non-scalar keys are can't be converted to an &array;.
-        </para>
+        <simpara>
+            Maps with non-scalar keys can't be converted to an &array;.
+        </simpara>
     </caution>
     <caution>
         <para>

reference/ds/ds/priorityqueue/allocate.xml

@@ -13,10 +13,10 @@
    <modifier>public</modifier> <type>void</type><methodname>Ds\PriorityQueue::allocate</methodname>
    <methodparam><type>int</type><parameter>capacity</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
     Ensures that enough memory is allocated for a required capacity.
-    This removes the need to reallocate the internal as values are added.
-  </para>
+    This removes the need to reallocate the internal buffer as values are added.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">

reference/ds/ds/queue/allocate.xml

@@ -13,10 +13,10 @@
    <modifier>public</modifier> <type>void</type><methodname>Ds\Queue::allocate</methodname>
    <methodparam><type>int</type><parameter>capacity</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
     Ensures that enough memory is allocated for a required capacity.
-    This removes the need to reallocate the internal as values are added.
-  </para>
+    This removes the need to reallocate the internal buffer as values are added.
+  </simpara>
   <note>
     <para>
         Capacity will always be rounded up to the nearest power of 2.

reference/ds/ds/sequence/allocate.xml

@@ -13,10 +13,10 @@
    <modifier>abstract</modifier> <modifier>public</modifier> <type>void</type><methodname>Ds\Sequence::allocate</methodname>
    <methodparam><type>int</type><parameter>capacity</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
     Ensures that enough memory is allocated for a required capacity.
-    This removes the need to reallocate the internal as values are added.
-  </para>
+    This removes the need to reallocate the internal buffer as values are added.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">

reference/ds/ds/stack/allocate.xml

@@ -13,10 +13,10 @@
    <modifier>public</modifier> <type>void</type><methodname>Ds\Stack::allocate</methodname>
    <methodparam><type>int</type><parameter>capacity</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
     Ensures that enough memory is allocated for a required capacity.
-    This removes the need to reallocate the internal as values are added.
-  </para>
+    This removes the need to reallocate the internal buffer as values are added.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">

reference/ds/ds/vector/allocate.xml

@@ -13,10 +13,10 @@
    <modifier>public</modifier> <type>void</type><methodname>Ds\Vector::allocate</methodname>
    <methodparam><type>int</type><parameter>capacity</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
     Ensures that enough memory is allocated for a required capacity.
-    This removes the need to reallocate the internal as values are added.
-  </para>
+    This removes the need to reallocate the internal buffer as values are added.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">

reference/eio/functions/eio-fallocate.xml

@@ -70,7 +70,7 @@
     <term><parameter>length</parameter></term>
     <listitem>
      <simpara>
-     Specifies length the byte range.
+     Specifies length of the byte range.
      </simpara>
     </listitem>
    </varlistentry>

reference/eio/functions/eio-open.xml

@@ -19,7 +19,8 @@
   </methodsynopsis>
   <simpara>
   <function>eio_open</function> opens file specified by
-  <parameter>path</parameter> in access mode <parameter>mode</parameter> with
+  <parameter>path</parameter> in access mode <parameter>mode</parameter> with the
+  given <parameter>flags</parameter>.
   </simpara>
 
 

reference/eio/functions/eio-poll.xml

@@ -3,7 +3,7 @@
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.eio-poll">
  <refnamediv>
   <refname>eio_poll</refname>
-  <refpurpose>Can be to be called whenever there are pending requests that need finishing</refpurpose>
+  <refpurpose>Can be called whenever there are pending requests that need finishing</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">

reference/enchant/functions/enchant-broker-dict-exists.xml

@@ -3,7 +3,7 @@
 <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>
+  <refpurpose>Whether a dictionary exists or not</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;

reference/enchant/functions/enchant-broker-init.xml

@@ -3,7 +3,7 @@
 <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>
+  <refpurpose>Create a new broker object</refpurpose>
  </refnamediv>
  <refsect1 role="description">
   &reftitle.description;

reference/enchant/functions/enchant-broker-request-pwl-dict.xml

@@ -13,7 +13,7 @@
    <methodparam><type>string</type><parameter>filename</parameter></methodparam>
   </methodsynopsis>
   <simpara>
-   Creates a dictionary using a PWL file. A PWL file is personal word file one word per line.
+   Creates a dictionary using a PWL file. A PWL file is a personal word file with one word per line.
   </simpara>
 
  </refsect1>

reference/ev/ev/recommendedbackends.xml

@@ -29,7 +29,7 @@
    systems and will not be auto-detected unless it is requested explicitly.
    This is the set of backends that
    <literal>libev</literal>
-   will probe no backends specified explicitly.
+   will probe when no backends are specified explicitly.
   </simpara>
  </refsect1>
  <refsect1 role="parameters">

reference/ev/evprepare/construct.xml

@@ -25,7 +25,7 @@
   </constructorsynopsis>
   <simpara>
    Constructs EvPrepare watcher object. And starts the watcher automatically.
-   If need a stopped watcher consider using
+   If a stopped watcher is needed, consider using
    <methodname>EvPrepare::createStopped</methodname>
   </simpara>
  </refsect1>