diff --git a/core/trashcan.js b/core/trashcan.js
index 50732ec9c..340500ba6 100644
--- a/core/trashcan.js
+++ b/core/trashcan.js
@@ -265,10 +265,10 @@ Blockly.Trashcan.prototype.createDom = function() {
 
 /**
  * Initialize the trash can.
- * @param {number} verticalSpacing Vertical distance workspace edge to the same
- * edge of the trashcan.
+ * @param {number} verticalSpacing Vertical distance from workspace edge to the
+ *    same edge of the trashcan.
  * @return {number} Vertical distance from workspace edge to the opposite
- * edge of the trashcan.
+ *    edge of the trashcan.
  */
 Blockly.Trashcan.prototype.init = function(verticalSpacing) {
   if (this.workspace_.options.maxTrashcanContents > 0) {
@@ -297,7 +297,10 @@ Blockly.Trashcan.prototype.dispose = function() {
 };
 
 /**
- * Move the trash can to the bottom-right corner.
+ * Position the trashcan.
+ * It is positioned in the upper corner when the toolbox is on bottom, and the
+ * bottom corner for all other toolbox positions. It is on the right in LTR,
+ * and left in RTL.
  */
 Blockly.Trashcan.prototype.position = function() {
   // Not yet initialized.
diff --git a/core/zoom_controls.js b/core/zoom_controls.js
index 19995be1d..b204fd586 100644
--- a/core/zoom_controls.js
+++ b/core/zoom_controls.js
@@ -109,9 +109,9 @@ Blockly.ZoomControls.prototype.createDom = function() {
 /**
  * Initialize the zoom controls.
  * @param {number} verticalSpacing Vertical distances from workspace edge to the
- * same edge of the controls.
+ *    same edge of the controls.
  * @return {number} Vertical distance from workspace edge to the opposite
- * edge of the controls.
+ *    edge of the controls.
  */
 Blockly.ZoomControls.prototype.init = function(verticalSpacing) {
   this.verticalSpacing_ = this.MARGIN_BOTTOM_ + verticalSpacing;