From ad7d582a656b9627bb746fc0ca09b099018155e3 Mon Sep 17 00:00:00 2001
From: Kalle Sommer Nielsen <kalle@php.net>
Date: Tue, 19 Aug 2008 23:18:42 +0000
Subject: [PATCH] Document that each() also accepts objects, but may return
 unexpected results + add link to object iteration

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@265142 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/array/functions/each.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/reference/array/functions/each.xml b/reference/array/functions/each.xml
index 5eea15f184..83c21d074a 100644
--- a/reference/array/functions/each.xml
+++ b/reference/array/functions/each.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.20 $ -->
+<!-- $Revision: 1.21 $ -->
 <refentry xml:id="function.each" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>each</refname>
@@ -150,6 +150,13 @@ c => cranberry
     loop.
    </para>
   </caution>
+  <warning>
+   <para>
+    <function>each</function> will also accept objects, but may return unexpected 
+    results. Its therefore not recommeded to iterate though object properties 
+    with <function>each</function>.
+   </para>
+  </warning>
  </refsect1>
  <refsect1 role="seealso">
   &reftitle.seealso;
@@ -162,6 +169,7 @@ c => cranberry
     <member><function>next</function></member>
     <member><function>prev</function></member>
     <member><link linkend="control-structures.foreach">foreach</link></member>
+    <member><link linkend="oop5.iterations">Object Iteration</link></member>
    </simplelist>
   </para>
  </refsect1>