entity.rb in gcloud-0.2.0

- old
+ new

@@ -56,22 +56,24 @@
       #
       # === Example
       #
       # Properties can be retrieved with a string name:
       #
-      #   require "gcloud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
-      #   user = datastore.find "User", "heidi"
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
+      #   user = dataset.find "User", "heidi"
       #   user["name"] #=> "Heidi Henderson"
       #
       # Or with a symbol name:
       #
-      #   require "gcloud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
-      #   user = datastore.find "User", "heidi"
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
+      #   user = dataset.find "User", "heidi"
       #   user[:name] #=> "Heidi Henderson"
       #
       def [] prop_name
         @properties[prop_name]
       end
@@ -88,22 +90,24 @@
       #
       # === Example
       #
       # Properties can be set with a string name:
       #
-      #   require "gcloud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
-      #   user = datastore.find "User", "heidi"
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
+      #   user = dataset.find "User", "heidi"
       #   user["name"] = "Heidi H. Henderson"
       #
       # Or with a symbol name:
       #
-      #   require "gcloud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
-      #   user = datastore.find "User", "heidi"
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
+      #   user = dataset.find "User", "heidi"
       #   user[:name] = "Heidi H. Henderson"
       #
       def []= prop_name, prop_value
         @properties[prop_name] = prop_value
       end
@@ -147,23 +151,25 @@
       #
       # === Example
       #
       # The Key can be set before the entity is saved.
       #
-      #   require "glcoud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
       #   entity = Gcloud::Datastore::Entity.new
       #   entity.key = Gcloud::Datastore::Key.new "User"
       #   dataset.save entity
       #
       # Once the entity is saved, the key is frozen and immutable.
       # Trying to set a key when immutable will raise a +RuntimeError+.
       #
-      #   require "gcloud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
       #   entity = dataset.find "User", "heidi"
       #   entity.persisted? #=> true
       #   entity.key = Gcloud::Datastore::Key.new "User" #=> RuntimeError
       #   entity.key.frozen? #=> true
       #   entity.key.id = 9876543221 #=> RuntimeError
@@ -176,12 +182,13 @@
       ##
       # Indicates if the record is persisted. Default is false.
       #
       # === Example
       #
-      #   require "gcloud/datastore"
+      #   require "gcloud"
       #
-      #   dataset = Gcloud.datastore
+      #   gcloud = Gcloud.new
+      #   dataset = gcloud.datastore
       #
       #   new_entity = Gcloud::Datastore::Entity.new
       #   new_entity.persisted? #=> false
       #
       #   found_entity = dataset.find "User", "heidi"