Fix grammar in PDO documentation.

Author: kamil-tekiela

appendices/migration72/new-features.xml

@@ -156,13 +156,13 @@ $db->quote('über', PDO::PARAM_STR | PDO::PARAM_STR_NATL);
  <sect2 xml:id="migration72.new-features.additional-emulated-prepares-debugging-info">
   <title>Additional emulated prepares debugging information for <link linkend="book.pdo">PDO</link></title>
 
-  <para>
+  <simpara>
    The <function>PDOStatement::debugDumpParams</function> method has been
    updated to include the SQL being sent to the DB, where the full, raw query
-   (including the replaced placeholders with their bounded values) will be
+   (including the replaced placeholders with their bound values) will be
    shown. This has been added to aid with debugging emulated prepares (and so
    it will only be available when emulated prepares are turned on).
-  </para>
+  </simpara>
  </sect2>
 
  <sect2 xml:id="migration72.new-features.extended-ops-in-ldap">

reference/pdo/configure.xml

@@ -9,14 +9,14 @@
  <procedure xml:id="pdo.install.unix51up">
   <title>Installing PDO on Unix systems</title>
   <step>
-   <para>
+   <simpara>
     PDO and the <link linkend="ref.pdo-sqlite">PDO_SQLITE</link> driver
-    is enabled by default. You may need
+    are enabled by default. You may need
     to enable the PDO driver for your database of choice; consult the
     documentation for
     <link linkend="pdo.drivers">database-specific PDO drivers</link>
     to find out more about that.
-   </para>
+   </simpara>
    <note>
     <para>
      When building PDO as a shared extension (<emphasis>not

reference/pdo/connections.xml

@@ -114,13 +114,13 @@ $dbh = new PDO('mysql:host=localhost;dbname=test', $user, $pass, array(
    </programlisting>
   </example>
  </para>
- <para>
+ <simpara>
   The value of the <constant>PDO::ATTR_PERSISTENT</constant> option is converted
   to &boolean; (enable/disable persistent connections), unless it is a non-numeric
-  &string;, in which case it allows to use multiple persistent connection pools.
+  &string;, in which case it allows the use of multiple persistent connection pools.
   This is useful if different connections use incompatible settings, for instance,
   different values of <constant>PDO::MYSQL_ATTR_USE_BUFFERED_QUERY</constant>.
- </para>
+ </simpara>
  <note>
   <para>
    If you wish to use persistent connections, you must set

reference/pdo/constants.xml

@@ -425,7 +425,10 @@
     </term>
     <listitem>
      <simpara>
-      Sets the class name of which statements are returned as.
+      Sets the class name and constructor arguments for the extension of the
+      <classname>PDOStatement</classname> object. The first
+      element of the array is the class name, and the second element is an
+      array of constructor arguments.
      </simpara>
     </listitem>
    </varlistentry>
@@ -518,8 +521,9 @@
     </term>
     <listitem>
      <simpara>
-      Sets the default string parameter type, this can be one of <constant>PDO::PARAM_STR_NATL</constant>
-      and <constant>PDO::PARAM_STR_CHAR</constant>.
+      Sets the default string parameter type, which can be either
+      <constant>PDO::PARAM_STR_NATL</constant>
+      or <constant>PDO::PARAM_STR_CHAR</constant>.
      </simpara>
      <simpara>
       Available as of PHP 7.2.0.

reference/pdo/ini.xml

@@ -39,7 +39,7 @@
    </term>
    <listitem>
     <para>
-     Defines DSN alias. See <methodname>PDO::__construct</methodname> for
+     Defines a DSN alias. See <methodname>PDO::__construct</methodname> for
      thorough explanation.
     </para>
    </listitem>

reference/pdo/pdo/connect.xml

@@ -17,7 +17,7 @@
   <simpara>
    Creates an instance of a <classname>PDO</classname> subclass for the
    database being connected to, if it exists,
-   otherwise return a generic <classname>PDO</classname> instance.
+   otherwise returns a generic <classname>PDO</classname> instance.
   </simpara>
  </refsect1>
 

reference/pdo/pdo/errorcode.xml

@@ -23,17 +23,17 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Returns an SQLSTATE, a five characters alphanumeric identifier defined in
+  <simpara>
+   Returns an SQLSTATE, a five-character alphanumeric identifier defined in
    the ANSI SQL-92 standard.  Briefly, an SQLSTATE consists of a
-   two characters class value followed by a three characters subclass value. A
+   two-character class value followed by a three-character subclass value. A
    class value of 01 indicates a warning and is accompanied by a return code
    of SQL_SUCCESS_WITH_INFO. Class values other than '01', except for the
    class 'IM', indicate an error.  The class 'IM' is specific to warnings
    and errors that derive from the implementation of PDO (or perhaps ODBC,
    if you're using the ODBC driver) itself.  The subclass value '000' in any
    class indicates that there is no subclass for that SQLSTATE.
-  </para>
+  </simpara>
   <para>
    <methodname>PDO::errorCode</methodname> only retrieves error codes for operations
    performed directly on the database handle. If you create a PDOStatement

reference/pdo/pdo/errorinfo.xml

@@ -38,7 +38,7 @@
      <tbody>
       <row>
        <entry>0</entry>
-       <entry>SQLSTATE error code (a five characters alphanumeric identifier defined
+       <entry>SQLSTATE error code (a five-character alphanumeric identifier defined
                in the ANSI SQL standard).</entry>
       </row>
       <row>

reference/pdo/pdo/getavailabledrivers.xml

@@ -20,7 +20,7 @@
   </methodsynopsis>
   <para>
    This function returns all currently available PDO drivers which can be used
-   in <parameter>DSN</parameter> parameter of
+   in the <parameter>DSN</parameter> parameter of
    <methodname>PDO::__construct</methodname>.
   </para>
 

reference/pdo/pdo/prepare.xml

@@ -32,12 +32,12 @@
    statement, unless emulation mode is on.
   </para>
   <note>
-   <para>
+   <simpara>
     Parameter markers can represent a complete data literal only.
-    Neither part of literal, nor keyword, nor identifier, nor whatever arbitrary query 
-    part can be bound using parameters. For example, you cannot bind multiple values 
+    Neither part of a literal, nor keyword, nor identifier, nor whatever arbitrary query
+    part can be bound using parameters. For example, you cannot bind multiple values
     to a single parameter in the IN() clause of an SQL statement.
-   </para>
+   </simpara>
   </note>
   <para>
    Calling <methodname>PDO::prepare</methodname> and
@@ -113,10 +113,10 @@
    <classname>PDOException</classname> (depending on <link linkend="pdo.error-handling">error handling</link>).
   </para>
   <note>
-   <para>
-    Emulated prepared statements does not communicate with the database server
+   <simpara>
+    Emulated prepared statements do not communicate with the database server
     so <methodname>PDO::prepare</methodname> does not check the statement.
-   </para>
+   </simpara>
   </note>
  </refsect1>