From 75b604c34aaf61a4befa23d495c9a02483cb2132 Mon Sep 17 00:00:00 2001
From: Kristina Chodorow <kristina@php.net>
Date: Thu, 27 Aug 2009 22:50:20 +0000
Subject: [PATCH] snapshot and example

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@287824 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mongo/mongocollection/insert.xml | 50 ++++++++++++++++++++++
 reference/mongo/versions.xml               |  3 ++
 2 files changed, 53 insertions(+)

diff --git a/reference/mongo/mongocollection/insert.xml b/reference/mongo/mongocollection/insert.xml
index f004bea770..2a089f3712 100644
--- a/reference/mongo/mongocollection/insert.xml
+++ b/reference/mongo/mongocollection/insert.xml
@@ -39,6 +39,56 @@
    Returns if the array was not empty (an empty array will not be inserted).
   </para>
  </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;  
+  <para>
+   Returns if the arrays were saved.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title><function>MongoCollection::insert</function> _id example</title>
+   <para>
+    Inserting an object will add an _id field to it, unless it is passed by reference.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$a = array('x' => 1);
+$collection->insert($a);
+var_dump($a)
+
+$b = array('x' => 1);
+$ref = &$b;
+$collection->insert($ref);
+var_dump($ref);
+
+?>
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+array(2) {
+  ["x"]=>
+  int(1)
+  ["_id"]=>
+  object(MongoId)#4 (0) {
+  }
+}
+array(1) {
+  ["x"]=>
+  int(1)
+}
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
 </refentry>
 <!-- Keep this comment at the end of the file
 Local variables:
diff --git a/reference/mongo/versions.xml b/reference/mongo/versions.xml
index b3bd5940d3..e468b611e3 100644
--- a/reference/mongo/versions.xml
+++ b/reference/mongo/versions.xml
@@ -77,6 +77,9 @@
  <function name='mongocursor::key' from='PECL mongo &gt;=0.9.0'/>
  <function name='mongocursor::count' from='PECL mongo &gt;=0.9.2'/>
  <function name='mongocursor::explain' from='PECL mongo &gt;=0.9.2'/>
+ <function name='mongocursor::tailable' from='PECL mongo &gt;=0.9.4'/>
+ <function name='mongocursor::slaveokay' from='PECL mongo &gt;=0.9.4'/>
+ <function name='mongocursor::snapshot' from='PECL mongo &gt;=0.9.4'/>
  <!-- MongoGridFS -->
  <function name='mongogridfs::__construct' from='PECL mongo &gt;=0.9.0'/>
  <function name='mongogridfs::find' from='PECL mongo &gt;=0.9.0'/>