added a note as suggested in bug #21318

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

reference/strings/functions/str-pad.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.3 $ -->
+<!-- $Revision: 1.4 $ -->
 <!-- splitted from ./en/functions/strings.xml, last change in rev 1.26 -->
   <refentry id="function.str-pad">
    <refnamediv>
@@ -51,6 +51,13 @@ print str_pad($input, 10, "_", STR_PAD_BOTH);   // produces "__Alien___"
       </programlisting>
      </example>
     </para>
+    <note>
+     <para>
+      The <parameter>pad_string</parameter> may be truncated if the
+      required number of padding characters can't be evenly diveded by
+      the padding strings length.
+     </para>
+    </note>
    </refsect1>
   </refentry>