diff --git a/src/Spec.js b/src/Spec.js
index f6d65968..cdedb0be 100644
--- a/src/Spec.js
+++ b/src/Spec.js
@@ -37,6 +37,11 @@ jasmine.Spec.prototype.results = function() {
   return this.results_;
 };
 
+/**
+ * All parameters are pretty-printed and concatenated together, then written to the spec's output.
+ *
+ * Be careful not to leave calls to <code>jasmine.log</code> in production code.
+ */
 jasmine.Spec.prototype.log = function() {
   return this.results_.log(arguments);
 };
diff --git a/src/base.js b/src/base.js
index 6ac3067e..f3892215 100755
--- a/src/base.js
+++ b/src/base.js
@@ -409,6 +409,11 @@ jasmine.createSpyObj = function(baseName, methodNames) {
   return obj;
 };
 
+/**
+ * All parameters are pretty-printed and concatenated together, then written to the current spec's output.
+ *
+ * Be careful not to leave calls to <code>jasmine.log</code> in production code.
+ */
 jasmine.log = function() {
   var spec = jasmine.getEnv().currentSpec;
   spec.log.apply(spec, arguments);