From 68c0f1e15a5c6a0df96c7687722f37277489684b Mon Sep 17 00:00:00 2001
From: Rand McKinney <rand@strongloop.com>
Date: Fri, 23 Jan 2015 09:54:14 -0800
Subject: [PATCH] Document options for persistedmodel.save()

---
 lib/persisted-model.js | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/lib/persisted-model.js b/lib/persisted-model.js
index c7a288b2..98ce9775 100644
--- a/lib/persisted-model.js
+++ b/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).
  */