Update multiple properties at once

This change alters the `set` method so you can update multiple
properties at once, by passing an associative array top `set`.

1 files changed, 7 insertions, 1 deletions

diff --git a/README.markdown b/README.markdown
index 2e6e6b5..b40e5f1 100644
--- a/README.markdown
+++ b/README.markdown
@@ -333,7 +333,7 @@ The `as_array` method takes column names as optional arguments. If one or more o
 
 ### Updating records ###
 
-To update the database, change one or more of the properties of the object, then call the `save` method to commit the changes to the database. Again, you can change the values of the object's properties either by using the `set` method or by setting the value of the property directly:
+To update the database, change one or more of the properties of the object, then call the `save` method to commit the changes to the database. Again, you can change the values of the object's properties either by using the `set` method or by setting the value of the property directly. By using the `set` method it is also possible to update multiple properties at once, by passing in an associative array:
 
     $person = ORM::for_table('person')->find_one(5);
 
@@ -341,6 +341,12 @@ To update the database, change one or more of the properties of the object, then
     $person->set('name', 'Bob Smith');
     $person->age = 20;
 
+    // This is equivalent to the above two assignments
+    $person->set(array(
+        'name' => 'Bob Smith',
+        'age'  => 20,
+    ));
+
     // Syncronise the object with the database
     $person->save();