Index: /CKEditor/trunk/_source/core/editor.js
===================================================================
--- /CKEditor/trunk/_source/core/editor.js (revision 5141)
+++ /CKEditor/trunk/_source/core/editor.js (revision 5142)
@@ -576,18 +576,21 @@
/**
- * Sets the editor data. The data must be provided in raw format (HTML).
- * Note: This's an asynchronous method, the {@param callback}
- * function should be relied on if you want to interact with the editor
- * after data is fully loaded.
- *
- * @param {String} data HTML code to replace the curent content in the editor.
- * @param {Function} callback Function to be called after the setData is completed.
- * @param {Boolean} noUndo Specify false to avoid editor from creating undo snapshot for this load.
- * @example
- * CKEDITOR.instances.editor1.setData( '<p>This is the editor data.</p>' );
- * CKEDITOR.instances.editor1.setData( '<p>Some other editor data.</p>', function()
- * {
- * CKEDITOR.instances.editor1.checkDirty(); // true
- * } );
+ * Sets the editor data. The data must be provided in raw format (HTML).
+ *
+ * Note that this menthod is asynchronous. The "callback" parameter must
+ * be used if interaction with the editor is needed after setting the data.
+ * @param {String} data HTML code to replace the curent content in the
+ * editor.
+ * @param {Function} callback Function to be called after the setData
+ * is completed.
+ * @param {Boolean} noUndo Indicates that the function call must not
+ * create and undo snapshot.
+ * @example
+ * CKEDITOR.instances.editor1.setData( '<p>This is the editor data.</p>' );
+ * @example
+ * CKEDITOR.instances.editor1.setData( '<p>Some other editor data.</p>', function()
+ * {
+ * this.checkDirty(); // true
+ * });
*/
setData : function( data , callback, noUndo )
@@ -601,4 +604,5 @@
noUndo !== false && this.fire( 'saveSnapshot' );
});
+
// Fire "setData" so data manipulation may happen.
var eventData = { dataValue : data };