From 74cf5ac5528760d23f40d8bc3dd1aee60788895f Mon Sep 17 00:00:00 2001
From: James Kyle <me@thejameskyle.com>
Date: Sat, 11 Jul 2015 12:07:17 -0700
Subject: [PATCH] Add descriptions to
 transformation/transformers/es5/properties.mutators

---
 .../transformers/es5/properties.mutators.js   | 31 +++++++++++++++++--
 1 file changed, 29 insertions(+), 2 deletions(-)

diff --git a/src/babel/transformation/transformers/es5/properties.mutators.js b/src/babel/transformation/transformers/es5/properties.mutators.js
index cb8a35e74f..fe69b65c00 100644
--- a/src/babel/transformation/transformers/es5/properties.mutators.js
+++ b/src/babel/transformation/transformers/es5/properties.mutators.js
@@ -2,13 +2,40 @@ import * as defineMap from "../../helpers/define-map";
 import * as t from "../../../types";
 
 /**
- * [Please add a description.]
+ * Turn [object initializer mutators](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Object_initializer#Method_definitions)
+ * into `Object.defineProperties`.
+ *
+ * **In**
+ *
+ * ```javascript
+ * var foo = {
+ *   get bar() {
+ *     return "bar";
+ *   }
+ * };
+ * ```
+ *
+ * **Out**
+ *
+ * ```javascript
+ * var foo = Object.defineProperties({}, {
+ *   bar: {
+ *     get: function () {
+ *       return "bar";
+ *     },
+ *     enumerable: true,
+ *     configurable: true
+ *   }
+ * });
+ * ```
  */
 
 export var visitor = {
 
   /**
-   * [Please add a description.]
+   * Look for getters and setters on an object.
+   * Filter them out and wrap the object with an `Object.defineProperties` that
+   * defines the getters and setters.
    */
 
   ObjectExpression(node, parent, scope, file) {