Files.app: Add missing JSdoc for member methods/variables #1.

chrome/browser/resources/file_manager/js/image_editor/image_buffer.js

Index: chrome/browser/resources/file_manager/js/image_editor/image_buffer.js
diff --git a/chrome/browser/resources/file_manager/js/image_editor/image_buffer.js b/chrome/browser/resources/file_manager/js/image_editor/image_buffer.js
index 4cf78aab72eb321a68198955626e64bd987130c6..163a0a21133866ced2030423056fa86a7ce593cd 100644
--- a/chrome/browser/resources/file_manager/js/image_editor/image_buffer.js
+++ b/chrome/browser/resources/file_manager/js/image_editor/image_buffer.js
@@ -13,7 +13,10 @@ function ImageBuffer() {
   this.overlays_ = [];
 }
 
-//TODO(JSDOC)
+/**
+ * TODO(JSDOC).
+ * @param {ImageBuffer.Overlay} overlay  //TODO(JSDOC).
+ */
 ImageBuffer.prototype.addOverlay = function(overlay) {
   var zIndex = overlay.getZIndex();
   // Store the overlays in the ascending Z-order.
@@ -24,7 +27,10 @@ ImageBuffer.prototype.addOverlay = function(overlay) {
   this.overlays_.splice(i, 0, overlay);
 };
 
-//TODO(JSDOC)
+/**
+ * TODO(JSDOC).
+ * @param {ImageBuffer.Overlay} overlay  //TODO(JSDOC).
+ */
 ImageBuffer.prototype.removeOverlay = function(overlay) {
   for (var i = 0; i != this.overlays_.length; i++) {
     if (this.overlays_[i] == overlay) {
@@ -119,25 +125,58 @@ ImageBuffer.DoubleTapAction = {
  * and the behavior of the ImageBuffer instance.
  * @class
  */
-//TODO(JSDOC)
 ImageBuffer.Overlay = function() {};
 
-//TODO(JSDOC)
+/**
+ * TODO(JSDOC).
+ * @return {number}  //TODO(JSDOC).
+ */
 ImageBuffer.Overlay.prototype.getZIndex = function() { return 0 };
 
-//TODO(JSDOC)
+/**
+ * TODO(JSDOC).
+ */
 ImageBuffer.Overlay.prototype.draw = function() {};
 
-//TODO(JSDOC)
-ImageBuffer.Overlay.prototype.getCursorStyle = function() { return null };
+/**
+ * TODO(JSDOC).
+ * @param {number} x X coordinate for cursor.
+ * @param {number} y Y coordinate for cursor.
+ * @param {boolean} mouseDown If mouse button is down.
+ * @return {?string} A value for style.cursor CSS property or null for
+ *     default.
+ */
+ImageBuffer.Overlay.prototype.getCursorStyle = function(x, y, mouseDown) {
+  return null;
+};
 
-//TODO(JSDOC)
-ImageBuffer.Overlay.prototype.onClick = function() { return false };
+/**
+ * TODO(JSDOC).
+ * @param {number} x  //TODO(JSDOC).
+ * @param {number} y  //TODO(JSDOC).
+ * @return {boolean}  //TODO(JSDOC).
+ */
+ImageBuffer.Overlay.prototype.onClick = function(x, y) {
+  return false;
+};
 
-//TODO(JSDOC)
-ImageBuffer.Overlay.prototype.getDragHandler = function() { return null };
+/**
+ * TODO(JSDOC).
+ * @param {number} x Event X coordinate.
+ * @param {number} y Event Y coordinate.
+ * @param {boolean} touch True if it's a touch event, false if mouse.
+ * @return {function(number,number)} A function to be called on mouse drag.
+ */
+ImageBuffer.Overlay.prototype.getDragHandler = function(x, y, touch) {
+  return null;
+};
 
-//TODO(JSDOC)
+/**
+ * TODO(JSDOC).
+ * @param {number} x  //TODO(JSDOC).
+ * @param {number} y  //TODO(JSDOC).
+ * @return {ImageBuffer.DoubleTapAction}  //TODO(JSDOC).
+ */
 ImageBuffer.Overlay.prototype.getDoubleTapAction = function(x, y) {
   return ImageBuffer.DoubleTapAction.NOTHING;
 };