Added example to Imagick::setImageIterations as well as clarified parameter.

-- 
Provided by anonymous 33522 (Danack@basereality.com)

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

reference/imagick/imagick/setimageiterations.xml

@@ -13,7 +13,7 @@
    <methodparam><type>int</type><parameter>iterations</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Sets the image iterations.
+   Sets the number of iterations an animated image is repeated.
   </para>
  </refsect1>
 
@@ -25,6 +25,8 @@
      <term><parameter>iterations</parameter></term>
      <listitem>
       <para>
+       The number of iterations the image should loop over. Set to '0' to loop
+       continuously.
       </para>
      </listitem>
     </varlistentry>
@@ -46,6 +48,30 @@
   </para>
  </refsect1>
 
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>Basic <function>Imagick::setImageIterations</function> usage</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+
+$imagick = new Imagick(realpath("Test.gif"));
+
+$imagick = $imagick->coalesceImages();
+$imagick->setImageIterations(1);
+$imagick = $imagick->deconstructImages();
+
+$imagick->writeImages('/path/to/save/OnceOnly.gif', true);
+
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
 </refentry>
 
 <!-- Keep this comment at the end of the file