[FIX] *: fix a bunch of incorrectly documented docstring

Fix a bunch of ill-documented/incomplete/incorrect method docs
Without this, the automatic doc generation does not work.

3 files changed, 10 insertions, 5 deletions

diff --git a/addons/web_editor/static/src/js/editor/snippets.editor.js b/addons/web_editor/static/src/js/editor/snippets.editor.js
index c0299fc2969..c08fd39f0db 100644
--- a/addons/web_editor/static/src/js/editor/snippets.editor.js
+++ b/addons/web_editor/static/src/js/editor/snippets.editor.js
@@ -33,7 +33,8 @@ var SnippetEditor = Widget.extend({
     /**
      * @constructor
      * @param {Widget} parent
-     * @param {DOMElement} target
+     * @param {Element} target
+     * @param templateOptions
      */
     init: function (parent, target, templateOptions) {
         this._super.apply(this, arguments);
@@ -640,7 +641,7 @@ var SnippetsMenu = Widget.extend({
      * @private
      * @param {jQuery} [$selectorSiblings]
      *        elements which must have siblings drop zones
-     * @param {jQuery} [$selectorSiblings]
+     * @param {jQuery} [$selectorChildren]
      *        elements which must have child drop zones between each of existing
      *        child
      */
diff --git a/addons/web_editor/static/src/js/widgets/ace.js b/addons/web_editor/static/src/js/widgets/ace.js
index 3ba6d29b2b8..8053b7b12c8 100644
--- a/addons/web_editor/static/src/js/widgets/ace.js
+++ b/addons/web_editor/static/src/js/widgets/ace.js
@@ -790,7 +790,7 @@ var ViewEditor = Widget.extend({
      * is toggled -> reloads the resources accordingly.
      *
      * @private
-     * @param {Event}
+     * @param {Event} ev
      */
     _onIncludeAllLessChange: function (ev) {
         this.options.includeAllLess = $(ev.target).prop('checked');
@@ -801,7 +801,7 @@ var ViewEditor = Widget.extend({
      * included is toggled -> reloads the resources accordingly.
      *
      * @private
-     * @param {Event}
+     * @param {Event} ev
      */
     _onIncludeBundlesChange: function (ev) {
         this.options.includeBundles = $(ev.target).prop('checked');
diff --git a/addons/web_editor/static/src/js/widgets/widgets.js b/addons/web_editor/static/src/js/widgets/widgets.js
index d25f1c631e2..1c2f542c6cd 100644
--- a/addons/web_editor/static/src/js/widgets/widgets.js
+++ b/addons/web_editor/static/src/js/widgets/widgets.js
@@ -391,11 +391,15 @@ var ImageDialog = Widget.extend({
     },
 });
 
-/* list of font icons to load by editor. The icons are displayed in the media editor and
+/**
+ *  list of font icons to load by editor. The icons are displayed in the media editor and
  * identified like font and image (can be colored, spinned, resized with fa classes).
  * To add font, push a new object {base, parser}
+ *
  * - base: class who appear on all fonts (eg: fa fa-refresh)
  * - parser: regular expression used to select all font in css style sheets
+ *
+ * @type Array
  */
 var fontIcons = [{'base': 'fa', 'parser': /(?=^|\s)(\.fa-[0-9a-z_-]+::?before)/i}];