API docs corrections.

Tade0 · Tade0 · commit cc9647ea23cb · 2016-11-07T14:00:35.000+01:00
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 ) {

Original file line number	Diff line number	Diff line change
`@@ -1232,7 +1232,7 @@`
`1232`	`1232`	`*`
`1233`	`1233`	`* @method editable`
`1234`	`1234`	`* @member CKEDITOR.editor`
`1235`		`- * @param {CKEDITOR.dom.element/CKEDITOR.editable} elementOrEditable The`
	`1235`	`+ * @param {CKEDITOR.dom.element/CKEDITOR.editable} [elementOrEditable] The`
`1236`	`1236`	`* DOM element to become the editable or a {@link CKEDITOR.editable} object.`
`1237`	`1237`	`*/`
`1238`	`1238`	`CKEDITOR.editor.prototype.editable = function( element ) {`