  * Property names and values can be passed in either using named arguments or as a struct to the `properties` argument.
  *
  * ```
- * Create a new author in memory (not saved to the database).
+ * // Create a new author in memory (not saved to the database).
  * newAuthor = model("author").new();
  *
- * Create a new author based on properties in a struct.
+ * // Create a new author based on properties in a struct.
  * newAuthor = model("author").new(params.authorStruct);
  *
- * Create a new author by passing in named arguments.
+ * // Create a new author by passing in named arguments.
  * newAuthor = model("author").new(firstName="John", lastName="Doe");
  *
- * If you have a `hasOne` or `hasMany` association setup from `customer` to `order` you can do a scoped call (the `newOrder` method below will call `model("order").new(customerId=aCustomer.id)` internally).
+ * // If you have a `hasOne` or `hasMany` association setup from `customer` to `order` you can do a scoped call (the `newOrder` method below will call `model("order").new(customerId=aCustomer.id)` internally).
  * aCustomer = model("customer").findByKey(params.customerId);
  * anOrder = aCustomer.newOrder(shipping=params.shipping);
  * ```

 * Returns `true` if the object was saved successfully to the database, `false` if not.
 *
 * ```
 * Save the user object to the database (will automatically do an `INSERT` or `UPDATE` statement depending on if the record is new or already exists.
 * user.save();
 *
 * Save the user object directly in an if statement without using `cfqueryparam` and take appropriate action based on the result.
 * if (user.save(parameterize=false)) {
 *   flashInsert(notice="The user was saved!");
 *   redirectTo(action="edit");
 * } else {

) {
	$args(name="save", args=arguments);
	clearErrors();
	return invokeWithTransaction(argumentCollection=arguments, method="$save");
}

/**
 * Internal function.
 * Create a new object instance.
 * Called from the new function above.
 * Also called from findByKey, findOne and findAll when returnAs is object(s).
 */
public any function $createInstance(
	required struct properties,
