API docs corrections.

ckeditor · Nov 7, 2016 · cc9647e · cc9647e
1 parent 0697f65
commit cc9647e
Show file tree

Hide file tree

Showing 3 changed files with 10 additions and 5 deletions.
diff --git a/core/editable.js b/core/editable.js
@@ -1232,7 +1232,7 @@
 	 *
 	 * @method editable
 	 * @member CKEDITOR.editor
-	 * @param {CKEDITOR.dom.element/CKEDITOR.editable} elementOrEditable The
+	 * @param {CKEDITOR.dom.element/CKEDITOR.editable} [elementOrEditable] The
 	 * DOM element to become the editable or a {@link CKEDITOR.editable} object.
 	 */
 	CKEDITOR.editor.prototype.editable = function( element ) {

diff --git a/core/editor.js b/core/editor.js
@@ -1836,6 +1836,14 @@ CKEDITOR.ELEMENT_MODE_INLINE = 3;
  * @param {CKEDITOR.editor} editor This editor instance.
  */
 
+/**
+ * Event fired when the {@link #method-destroy} is called,
+ * but before destroying the editor.
+ *
+ * @event beforeDestroy
+ * @param {CKEDITOR.editor} editor This editor instance.
+ */
+
 /**
  * Internal event to get the current data.
  *

diff --git a/plugins/pastefromword/filter/default.js b/plugins/pastefromword/filter/default.js
@@ -1331,12 +1331,9 @@
 		 * Note that list items within a single list but with different levels that did not get chopped
 		 * will still be rendered as a list tree later.
 		 *
-		 * @todo: Describe what `lists` parameter is for. By the looks of it it's supposed to be array which is used
-		 * to return the value.
-		 *
 		 * @private
 		 * @param {CKEDITOR.htmlParser.element[]} list An array containing list items.
-		 * @param {CKEDITOR.htmlParser.element[]} lists
+		 * @param {CKEDITOR.htmlParser.element[]} lists All the lists in the pasted content represented by an array of arrays of list items. Modified by this method.
 		 * @member CKEDITOR.plugins.pastefromword.lists
 		 */
 		chopDiscontinousLists: function( list, lists ) {