 	<cfreturn returnValue>
 </cffunction>
 
-<cffunction name="isNew" returntype="boolean" access="public" output="false" hint="Returns `true` if this object hasn't been saved yet (in other words no record exists in the database yet). Returns `false` if a record exists.">
+<cffunction name="isNew" returntype="boolean" access="public" output="false"
+	hint="Returns `true` if this object hasn't been saved yet (in other words no record exists in the database yet). Returns `false` if a record exists."
+	examples=
+	'
+		<!--- Create a new object and then check if it's new (yes, this example is ridiculous. It makes more sense in the context of callbacks for example) --->
+		<cfset anEmployee = model("employee").new()>
+		<cfif anEmployee.isNew()>
+			<!--- Do something... --->
+		</cfif>
+	'
+	categories="model-object" chapters="" functions="">
 	<cfscript>
 		var loc = {};
 		// if no values have ever been saved to the database this object is new

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="reload" returntype="void" access="public" output="false" hint="Reloads the property values of this object from the database.">
	<cfscript>
		var loc = {};
		loc.query = findByKey(key=key(), reload=true, returnAs="query");

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="primaryKey" returntype="string" access="public" output="false"
	hint="Returns the name of the primary key for this model's table. This is determined through database introspection. If composite primary keys have been used they will both be returned in a list."
	examples=
	'
		<!--- Get the name of the primary key of the table mapped to the `employee` model (the `employees` table by default) --->
		<cfset theKeyName = model("employee").primaryKey()>
	'
	categories="model-object" chapters="object-relational-mapping" functions="">
	<cfreturn variables.wheels.class.keys>
</cffunction>

