--- /dev/null
+/*\r
+Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.\r
+For licensing, see LICENSE.html or http://ckeditor.com/license\r
+*/\r
+\r
+/**\r
+ * @fileOverview Defines the "virtual" {@link CKEDITOR.dataProcessor} class, which\r
+ * defines the basic structure of data processor objects to be\r
+ * set to {@link CKEDITOR.editor.dataProcessor}.\r
+ */\r
+\r
+/**\r
+ * If defined, points to the data processor which is responsible to translate\r
+ * and transform the editor data on input and output.\r
+ * Generaly it will point to an instance of {@link CKEDITOR.htmlDataProcessor},\r
+ * which handles HTML data. The editor may also handle other data formats by\r
+ * using different data processors provided by specific plugins.\r
+ * @name CKEDITOR.editor.prototype.dataProcessor\r
+ * @type CKEDITOR.dataProcessor\r
+ */\r
+\r
+/**\r
+ * This class is here for documentation purposes only and is not really part of\r
+ * the API. It serves as the base ("interface") for data processors\r
+ * implementation.\r
+ * @name CKEDITOR.dataProcessor\r
+ * @class Represents a data processor, which is responsible to translate and\r
+ * transform the editor data on input and output.\r
+ * @example\r
+ */\r
+\r
+/**\r
+ * Transforms input data into HTML to be loaded in the editor.\r
+ * While the editor is able to handle non HTML data (like BBCode), at runtime\r
+ * it can handle HTML data only. The role of the data processor is transforming\r
+ * the input data into HTML through this function.\r
+ * @name CKEDITOR.dataProcessor.prototype.toHtml\r
+ * @function\r
+ * @param {String} data The input data to be transformed.\r
+ * @param {String} [fixForBody] The tag name to be used if the data must be\r
+ * fixed because it is supposed to be loaded direcly into the <body>\r
+ * tag. This is generally not used by non-HTML data processors.\r
+ * @example\r
+ * // Tranforming BBCode data, having a custom BBCode data processor.\r
+ * var data = 'This is [b]an example[/b].';\r
+ * var html = editor.dataProcessor.toHtml( data ); // '<p>This is <b>an example</b>.</p>'\r
+ */\r
+\r
+/**\r
+ * Transforms HTML into data to be outputted by the editor, in the format\r
+ * expected by the data processor.\r
+ * While the editor is able to handle non HTML data (like BBCode), at runtime\r
+ * it can handle HTML data only. The role of the data processor is transforming\r
+ * the HTML data containined by the editor into a specific data format through\r
+ * this function.\r
+ * @name CKEDITOR.dataProcessor.prototype.toDataFormat\r
+ * @function\r
+ * @param {String} html The HTML to be transformed.\r
+ * @param {String} fixForBody The tag name to be used if the output data is\r
+ * coming from <body> and may be eventually fixed for it. This is\r
+ * generally not used by non-HTML data processors.\r
+ * // Tranforming into BBCode data, having a custom BBCode data processor.\r
+ * var html = '<p>This is <b>an example</b>.</p>';\r
+ * var data = editor.dataProcessor.toDataFormat( html ); // 'This is [b]an example[/b].'\r
+ */\r