Document options for persistedmodel.save()

lib/persisted-model.js

@@ -287,8 +287,9 @@ PersistedModel.count = function(where, cb) {
  * Save model instance. If the instance doesn't have an ID, then the [create](#persistedmodelcreatedata-cb) method is called instead.
  * Triggers: validate, save, update, or create.
  * @options {Object} [options] See below.
- * @property {Boolean} validate
- * @property {Boolean} throws
+ * @property {Boolean} validate Perform validation before saving.  Default is true.
+ * @property {Boolean} throws Controls If true, throw a validation error; WARNING: This can crash Node.
+ * If false, report the error via callback.  Default is false.
  * @param {Function} [callback] Callback function called with (err, obj).
  */