many bugs

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328365 c90b9560-bf6c-de11-be94-00142212c4b1

reference/bc/functions/bcscale.xml

@@ -13,7 +13,7 @@
    <methodparam><type>int</type><parameter>scale</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Sets the default scale parameter for all subsequent bc math functions that
+   Sets the default scale parameter for all subsequent calls to bc math functions that
    do not explicitly specify a scale parameter.
   </para>
  </refsect1>

reference/curl/functions/curl-setopt.xml

@@ -92,8 +92,9 @@
             on secure transfers.
            </entry>
            <entry valign="top">
-            Available since PHP 5.3.2. Requires <constant>CURLOPT_VERBOSE</constant> to be 
-            on to have an effect.
+            Added in cURL 7.19.1. 
+            Available since PHP 5.3.2. 
+            Requires <constant>CURLOPT_VERBOSE</constant> to be on to have an effect.
            </entry>
           </row>
           <row>
@@ -454,7 +455,7 @@
             timeouts with a minimum timeout allowed of one second.
            </entry>
            <entry valign="top">
-            Added in cURL 7.16.3. Available since PHP 5.2.3.
+            Added in cURL 7.16.2. Available since PHP 5.2.3.
            </entry>
           </row>
           <row>
@@ -721,7 +722,7 @@
             timeouts with a minimum timeout allowed of one second.
            </entry>
            <entry valign="top">
-            Added in cURL 7.16.3. Available since PHP 5.2.3.
+            Added in cURL 7.16.2. Available since PHP 5.2.3.
            </entry>
           </row>
           <row>

reference/datetime/datetime/construct.xml

@@ -45,7 +45,7 @@
     <listitem>
      <para>
       A <classname>DateTimeZone</classname> object representing the
-      desired time zone.
+      timezone of <parameter>$time</parameter>.
      </para>
      <para>
       If <parameter>$timezone</parameter> is omitted,

reference/datetime/functions/gmmktime.xml

@@ -149,7 +149,7 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-// Prints: July 1, 2000 is on a Friday
+// Prints: July 1, 2000 is on a Saturday
 echo "July 1, 2000 is on a " . date("l", gmmktime(0, 0, 0, 7, 1, 2000));
 ?>
 ]]>

reference/geoip/functions/geoip-country-code-by-name.xml

@@ -68,6 +68,15 @@ This host is located in: US
    </example>
   </para>
  </refsect1>
+ 
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <caution>
+   <para>
+    Please see <link>http://www.maxmind.com/en/iso3166</link> for a complete list of possible return values, including special codes.
+   </para>
+  </caution>
+ </refsect1>
 
  <refsect1 role="seealso">
   &reftitle.seealso;

reference/geoip/functions/geoip-database-info.xml

@@ -52,9 +52,9 @@
   &reftitle.examples;
   <para>
    <example>
-    <title>A <function>geoip_region_by_name</function> example</title>
+    <title>A <function>geoip_database_info</function> example</title>
     <para>
-     This will output the current database version string.
+     This will output information regarding the database.
     </para>
     <programlisting role="php">
 <![CDATA[

reference/imagick/imagick/setimagealphachannel.xml

@@ -54,6 +54,7 @@
   <para>
    <simplelist>
     <member><function>Imagick::setImageMatte</function></member>
+    <member> <link linkend="imagick.constants.alphachannel">Imagick Alpha Channel Constants</link></member>
    </simplelist>
   </para>
  </refsect1>

reference/mbstring/functions/mb-output-handler.xml

@@ -75,7 +75,7 @@
          <itemizedlist>
           <listitem>
            <simpara>
-            Does not set <literal>Content-Type</literal>, using <function>header</function>.
+            <literal>Content-Type</literal> has not been set, using <function>header</function>.
            </simpara>
           </listitem>
           <listitem>
@@ -120,23 +120,17 @@ ob_start("mb_output_handler");
   &reftitle.notes;
   <note>
    <para>
-    If you want to output some binary data such as image from PHP
-    script with PHP 4.3.0 or later, Content-Type: header must be send
-    using <function>header</function> before any binary data was send
-    to client (e.g. header("Content-Type: image/png")).
-    If Content-Type: header was send, output character encoding
-    conversion will not be performed.
+    If you want to output binary data, such as an image, using PHP 4.3.0 or later,
+    a Content-Type: header must be set using <function>header</function> 
+    before any binary data is sent to the client (e.g. header("Content-Type: image/png")).
+    If Content-Type: header is sent, output character encoding conversion will not be performed.
    </para>
    <para>
-    Note that if 'Content-Type: text/*' was send using
-    <function>header</function>, the sending data is regarded as text,
-    encoding conversion will be performed using character encoding
-    settings.
+    Note that if 'Content-Type: text/*' is sent, the content body is regarded as text; conversion will take place.
    </para>
    <para>
-    If you want to output some binary data such as image from PHP
-    script with PHP 4.2.x or earlier, you must set output encoding to
-    &quot;pass&quot; using <function>mb_http_output</function>.
+    If you want to output binary data, such as an image, using PHP 4.2.x or earlier, 
+    you must set output encoding to &quot;pass&quot; using <function>mb_http_output</function>.
    </para>
   </note>
  </refsect1>

reference/mysqli/mysqli/close.xml

@@ -51,7 +51,7 @@
   &reftitle.seealso;
   <para>
    <simplelist>
-    <member><function>mysqli_connect</function></member>
+    <member><methodname>mysqli::__construct</methodname></member>
     <member><function>mysqli_init</function></member>
     <member><function>mysqli_real_connect</function></member>
    </simplelist>

reference/mysqli/mysqli/poll.xml

@@ -84,7 +84,7 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Returns number of ready connections in success, &false; otherwise.
+   Returns number of ready connections upon success, &false; otherwise.
   </para>
  </refsect1>
 
@@ -111,9 +111,10 @@ do {
     foreach ($links as $link) {
         if ($result = $link->reap_async_query()) {
             print_r($result->fetch_row());
-            mysqli_free_result($result);
-            $processed++;
-        }
+            if (is_object($result))
+                mysqli_free_result($result);   
+        } else die(sprintf("MySQLi Error: %s", mysqli_error($link)));
+        $processed++;
     }
 } while ($processed < count($all_links));
 ?>

reference/mysqli/quickstart.xml

@@ -362,13 +362,9 @@ mysqli.default_socket=/tmp/mysql.sock
    calling <function>mysqli_real_query</function>
    followed by <function>mysqli_store_result</function>.
   </para>
-  <para>
-   The <function>mysqli_multi_query</function> function is used
-   with multiple statements.
-  </para>
   <para>
    <example>
-    <title>Bad coding style</title>
+    <title>Connecting to MySQL</title>
     <programlisting role="php">
 <![CDATA[
 <?php
@@ -465,7 +461,7 @@ Result set order...
   </para>
   <para>
    <example>
-    <title>Navigation through buffered results</title>
+    <title>Navigation through unbuffered results</title>
     <programlisting role="php">
 <![CDATA[
 <?php

reference/pcntl/functions/pcntl-signal.xml

@@ -155,7 +155,7 @@ pcntl_signal(SIGUSR1, "sig_handler");
 // or use an object, available as of PHP 4.3.0
 // pcntl_signal(SIGUSR1, array($obj, "do_something"));
 
-echo "Generating signal SIGTERM to self...\n";
+echo"Generating signal SIGTERM to self...\n";
 
 // send SIGUSR1 to current process id
 posix_kill(posix_getpid(), SIGUSR1);

reference/pcre/pattern.syntax.xml

@@ -185,10 +185,6 @@
      <term><emphasis>-</emphasis></term>
      <listitem><simpara>indicates character range</simpara></listitem>
     </varlistentry>
-    <varlistentry>
-     <term><emphasis>]</emphasis></term>
-     <listitem><simpara>terminates the character class</simpara></listitem>
-    </varlistentry>
    </variablelist>
    
    The following sections describe the use of each of the

reference/svn/functions/svn-commit.xml

@@ -12,14 +12,14 @@
    <type>array</type><methodname>svn_commit</methodname>
    <methodparam><type>string</type><parameter>log</parameter></methodparam>
    <methodparam><type>array</type><parameter>targets</parameter></methodparam>
-   <methodparam choice="opt"><type>bool</type><parameter>dontrecurse</parameter><initializer>false</initializer></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>recursive</parameter><initializer>true</initializer></methodparam>
   </methodsynopsis>
   <para>
    Commits changes made in the local working copy files enumerated in
    the <parameter>targets</parameter> array to the repository, with the
    log message <parameter>log</parameter>. Directories in the <parameter>targets</parameter>
-   array will be recursively committed unless <parameter>dontrecurse</parameter>
-   is set to true.
+   array will be recursively committed unless <parameter>recursive</parameter>
+   is set to false.
   </para>
   <note>
    <simpara>
@@ -57,12 +57,12 @@
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>dontrecurse</parameter></term>
+     <term><parameter>recursive</parameter></term>
      <listitem>
       <para>
        Boolean flag to disable recursive committing of
        directories in the <parameter>targets</parameter> array.
-       Default is &false;.
+       Default is &true;.
       </para>
      </listitem>
     </varlistentry>

reference/url/functions/urldecode.xml

@@ -50,13 +50,14 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$a = explode('&', $QUERY_STRING);
-$i = 0;
-while ($i < count($a)) {
-    $b = split('=', $a[$i]);
-    echo 'Value for parameter ', htmlspecialchars(urldecode($b[0])),
-         ' is ', htmlspecialchars(urldecode($b[1])), "<br />\n";
-    $i++;
+$query = "my=apples&are=green+and+red";
+
+foreach (explode('&', $query) as $chunk) {
+    $param = explode("=", $chunk);
+
+    if ($param) {
+        printf("Value for parameter \"%s\" is \"%s\"<br/>\n", urldecode($param[0]), urldecode($param[1]));
+    }
 }
 ?>
 ]]>

reference/var/functions/floatval.xml

@@ -38,6 +38,12 @@
    The float value of the given variable. Empty arrays return 0, non-empty
    arrays return 1.
   </para>
+  <para>
+   Strings will most likely return 0 although this depends on the 
+   leftmost characters of the string. The common rules of 
+   <link linkend="language.types.float.casting">float casting</link> 
+   apply.
+  </para>
  </refsect1>
  <refsect1 role="examples">
   &reftitle.examples;