From f5cf724823d42771298854a25d33d5e656972ab6 Mon Sep 17 00:00:00 2001
From: Adam Harvey <aharvey@php.net>
Date: Thu, 9 Sep 2010 05:45:41 +0000
Subject: [PATCH] Fix (doc) bug #52748 (bcpow() - scale parameter doesn't
 influensce the result string) by adding a clarifying note about bcpow's exact
 behaviour when dealing with scale.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@303202 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/bc/functions/bcpow.xml | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/reference/bc/functions/bcpow.xml b/reference/bc/functions/bcpow.xml
index e238574d01..c5e1a768d1 100644
--- a/reference/bc/functions/bcpow.xml
+++ b/reference/bc/functions/bcpow.xml
@@ -67,6 +67,28 @@ echo bcpow('4.2', '3', 2); // 74.08
    </programlisting>
   </example>
  </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    <function>bcpow</function> may return a result with fewer digits after the
+    decimal point than the <parameter>scale</parameter> parameter would
+    indicate. This only occurs when the result doesn't require all of the
+    precision allowed by the <parameter>scale</parameter>. For example:
+    <example>
+     <title><function>bcpow</function> scale example</title>
+     <programlisting role="php">
+<![CDATA[
+<?php
+echo bcpow('5', '2', 2);     // prints "25", not "25.00"
+?>
+]]>
+     </programlisting>
+    </example>
+   </para>
+  </note>
+ </refsect1>
  
  <refsect1 role="seealso">
   &reftitle.seealso;