radiant-ck_editor_filter-extension 0.2.5 → 0.2.6

data/public/javascripts/extensions/ck_editor_filter/ckeditor/_source/core/dom/rangelist.js

@@ -1,5 +1,5 @@
 /*
-Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
 For licensing, see LICENSE.html or http://ckeditor.com/license
 */
 

data/public/javascripts/extensions/ck_editor_filter/ckeditor/_source/core/dom/text.js

@@ -1,5 +1,5 @@
 /*
-Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
 For licensing, see LICENSE.html or http://ckeditor.com/license
 */
 

data/public/javascripts/extensions/ck_editor_filter/ckeditor/_source/core/dom/walker.js

@@ -1,5 +1,5 @@
 /*
-Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
 For licensing, see LICENSE.html or http://ckeditor.com/license
 */
 
@@ -8,40 +8,50 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 	// This function is to be called under a "walker" instance scope.
 	function iterate( rtl, breakOnFalse )
 	{
+		var range = this.range;
+
 		// Return null if we have reached the end.
 		if ( this._.end )
 			return null;
 
-		var node,
-			range = this.range,
-			guard,
-			userGuard = this.guard,
-			type = this.type,
-			getSourceNodeFn = ( rtl ? 'getPreviousSourceNode' : 'getNextSourceNode' );
-
 		// This is the first call. Initialize it.
 		if ( !this._.start )
 		{
 			this._.start = 1;
 
-			// Trim text nodes and optmize the range boundaries. DOM changes
-			// may happen at this point.
-			range.trim();
-
 			// A collapsed range must return null at first call.
 			if ( range.collapsed )
 			{
 				this.end();
 				return null;
 			}
+
+			// Move outside of text node edges.
+			range.optimize();
 		}
 
+		var node,
+			startCt = range.startContainer,
+			endCt = range.endContainer,
+			startOffset = range.startOffset,
+			endOffset = range.endOffset,
+			guard,
+			userGuard = this.guard,
+			type = this.type,
+			getSourceNodeFn = ( rtl ? 'getPreviousSourceNode' : 'getNextSourceNode' );
+
 		// Create the LTR guard function, if necessary.
 		if ( !rtl && !this._.guardLTR )
 		{
-			// Gets the node that stops the walker when going LTR.
-			var limitLTR = range.endContainer,
-				blockerLTR = limitLTR.getChild( range.endOffset );
+			// The node that stops walker from moving up.
+			var limitLTR = endCt.type == CKEDITOR.NODE_ELEMENT ?
+						   endCt :
+						   endCt.getParent();
+
+			// The node that stops the walker from going to next.
+			var blockerLTR = endCt.type == CKEDITOR.NODE_ELEMENT ?
+							 endCt.getChild( endOffset ) :
+							 endCt.getNext();
 
 			this._.guardLTR = function( node, movingOut )
 			{
@@ -54,9 +64,16 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 		// Create the RTL guard function, if necessary.
 		if ( rtl && !this._.guardRTL )
 		{
-			// Gets the node that stops the walker when going LTR.
-			var limitRTL = range.startContainer,
-				blockerRTL = ( range.startOffset > 0 ) && limitRTL.getChild( range.startOffset - 1 );
+			// The node that stops walker from moving up.
+			var limitRTL = startCt.type == CKEDITOR.NODE_ELEMENT ?
+						   startCt :
+						   startCt.getParent();
+
+			// The node that stops the walker from going to next.
+			var blockerRTL = startCt.type == CKEDITOR.NODE_ELEMENT ?
+						 startOffset ?
+						 startCt.getChild( startOffset - 1 ) : null :
+						 startCt.getPrevious();
 
 			this._.guardRTL = function( node, movingOut )
 			{
@@ -89,35 +106,33 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 		else
 		{
 			// Get the first node to be returned.
-
 			if ( rtl )
 			{
-				node = range.endContainer;
+				node = endCt;
 
-				if ( range.endOffset > 0 )
+				if ( node.type == CKEDITOR.NODE_ELEMENT )
 				{
-					node = node.getChild( range.endOffset - 1 );
-					if ( guard( node ) === false )
-						node = null;
+					if ( endOffset > 0 )
+						node = node.getChild( endOffset - 1 );
+					else
+						node = ( guard ( node, true ) === false ) ?
+							null : node.getPreviousSourceNode( true, type, guard );
 				}
-				else
-					node = ( guard ( node, true ) === false ) ?
-						null : node.getPreviousSourceNode( true, type, guard );
 			}
 			else
 			{
-				node = range.startContainer;
-				node = node.getChild( range.startOffset );
+				node = startCt;
 
-				if ( node )
+				if ( node.type == CKEDITOR.NODE_ELEMENT )
 				{
-					if ( guard( node ) === false )
-						node = null;
+					if ( ! ( node = node.getChild( startOffset ) ) )
+						node = ( guard ( startCt, true ) === false ) ?
+							null : startCt.getNextSourceNode( true, type, guard ) ;
 				}
-				else
-					node = ( guard ( range.startContainer, true ) === false ) ?
-						null : range.startContainer.getNextSourceNode( true, type, guard ) ;
 			}
+
+			if ( node && guard( node ) === false )
+				node = null;
 		}
 
 		while ( node && !this._.end )
@@ -431,6 +446,25 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 		};
 	};
 
+	CKEDITOR.dom.walker.bogus = function( type, isReject )
+	{
+		function nonEmpty( node )
+		{
+			return !isWhitespaces( node ) && !isBookmark( node );
+		}
+
+		return function( node )
+		{
+			var parent = node.getParent(),
+				isBogus = !CKEDITOR.env.ie ? node.is && node.is( 'br' ) :
+					  node.getText && tailNbspRegex.test( node.getText() );
+
+			isBogus = isBogus && parent.isBlockBoundary() && !!parent.getLast( nonEmpty );
+
+			return !! ( isReject ^ isBogus );
+		};
+	};
+
 	var tailNbspRegex = /^[\t\r\n ]*(?: |\xa0)$/,
 		isWhitespaces = CKEDITOR.dom.walker.whitespaces(),
 		isBookmark = CKEDITOR.dom.walker.bookmark(),

data/public/javascripts/extensions/ck_editor_filter/ckeditor/_source/core/dom/window.js

@@ -1,5 +1,5 @@
 /*
-Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
 For licensing, see LICENSE.html or http://ckeditor.com/license
 */
 

data/public/javascripts/extensions/ck_editor_filter/ckeditor/_source/core/dtd.js

@@ -1,5 +1,5 @@
 /*
-Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
 For licensing, see LICENSE.html or http://ckeditor.com/license
 */
 
@@ -37,13 +37,13 @@ CKEDITOR.dtd = (function()
 		B = {input:1,button:1,select:1,textarea:1,label:1},
 		C = X({a:1},B),
 		D = X({iframe:1},C),
-		E = {hr:1,ul:1,menu:1,div:1,blockquote:1,noscript:1,table:1,center:1,address:1,dir:1,pre:1,h5:1,dl:1,h4:1,noframes:1,h6:1,ol:1,h1:1,h3:1,h2:1},
+		E = {hr:1,ul:1,menu:1,div:1,section:1,header:1,footer:1,nav:1,article:1,aside:1,figure:1,dialog:1,hgroup:1,mark:1,time:1,meter:1,command:1,keygen:1,output:1,progress:1,audio:1,video:1,details:1,datagrid:1,datalist:1,blockquote:1,noscript:1,table:1,center:1,address:1,dir:1,pre:1,h5:1,dl:1,h4:1,noframes:1,h6:1,ol:1,h1:1,h3:1,h2:1},
 		F = {ins:1,del:1,script:1,style:1},
-		G = X({b:1,acronym:1,bdo:1,'var':1,'#':1,abbr:1,code:1,br:1,i:1,cite:1,kbd:1,u:1,strike:1,s:1,tt:1,strong:1,q:1,samp:1,em:1,dfn:1,span:1},F),
-		H = X({sub:1,img:1,object:1,sup:1,basefont:1,map:1,applet:1,font:1,big:1,small:1},G),
+		G = X({b:1,acronym:1,bdo:1,'var':1,'#':1,abbr:1,code:1,br:1,i:1,cite:1,kbd:1,u:1,strike:1,s:1,tt:1,strong:1,q:1,samp:1,em:1,dfn:1,span:1,wbr:1},F),
+		H = X({sub:1,img:1,object:1,sup:1,basefont:1,map:1,applet:1,font:1,big:1,small:1,mark:1},G),
 		I = X({p:1},H),
 		J = X({iframe:1},H,B),
-		K = {img:1,noscript:1,br:1,kbd:1,center:1,button:1,basefont:1,h5:1,h4:1,samp:1,h6:1,ol:1,h1:1,h3:1,h2:1,form:1,font:1,'#':1,select:1,menu:1,ins:1,abbr:1,label:1,code:1,table:1,script:1,cite:1,input:1,iframe:1,strong:1,textarea:1,noframes:1,big:1,small:1,span:1,hr:1,sub:1,bdo:1,'var':1,div:1,object:1,sup:1,strike:1,dir:1,map:1,dl:1,applet:1,del:1,isindex:1,fieldset:1,ul:1,b:1,acronym:1,a:1,blockquote:1,i:1,u:1,s:1,tt:1,address:1,q:1,pre:1,p:1,em:1,dfn:1},
+		K = {img:1,noscript:1,br:1,kbd:1,center:1,button:1,basefont:1,h5:1,h4:1,samp:1,h6:1,ol:1,h1:1,h3:1,h2:1,form:1,font:1,'#':1,select:1,menu:1,ins:1,abbr:1,label:1,code:1,table:1,script:1,cite:1,input:1,iframe:1,strong:1,textarea:1,noframes:1,big:1,small:1,span:1,hr:1,sub:1,bdo:1,'var':1,div:1,section:1,header:1,footer:1,nav:1,article:1,aside:1,figure:1,dialog:1,hgroup:1,mark:1,time:1,meter:1,menu:1,command:1,keygen:1,output:1,progress:1,audio:1,video:1,details:1,datagrid:1,datalist:1,object:1,sup:1,strike:1,dir:1,map:1,dl:1,applet:1,del:1,isindex:1,fieldset:1,ul:1,b:1,acronym:1,a:1,blockquote:1,i:1,u:1,s:1,tt:1,address:1,q:1,pre:1,p:1,em:1,dfn:1},
 
 		L = X({a:1},J),
 		M = {tr:1},
@@ -57,7 +57,7 @@ CKEDITOR.dtd = (function()
 		U = {head:1,body:1},
 		V = {html:1};
 
-	var block = {address:1,blockquote:1,center:1,dir:1,div:1,dl:1,fieldset:1,form:1,h1:1,h2:1,h3:1,h4:1,h5:1,h6:1,hr:1,isindex:1,menu:1,noframes:1,ol:1,p:1,pre:1,table:1,ul:1};
+	var block = {address:1,blockquote:1,center:1,dir:1,div:1,section:1,header:1,footer:1,nav:1,article:1,aside:1,figure:1,dialog:1,hgroup:1,time:1,meter:1,menu:1,command:1,keygen:1,output:1,progress:1,audio:1,video:1,details:1,datagrid:1,datalist:1,dl:1,fieldset:1,form:1,h1:1,h2:1,h3:1,h4:1,h5:1,h6:1,hr:1,isindex:1,noframes:1,ol:1,p:1,pre:1,table:1,ul:1};
 
 	return /** @lends CKEDITOR.dtd */ {
 
@@ -78,7 +78,7 @@ CKEDITOR.dtd = (function()
 		 * @type Object
 		 * @example
 		 */
-		$blockLimit : { body:1,div:1,td:1,th:1,caption:1,form:1 },
+		$blockLimit : { body:1,div:1,section:1,header:1,footer:1,nav:1,article:1,aside:1,figure:1,dialog:1,hgroup:1,time:1,meter:1,menu:1,command:1,keygen:1,output:1,progress:1,audio:1,video:1,details:1,datagrid:1,datalist:1,td:1,th:1,caption:1,form:1 },
 
 		/**
 		 * List of inline (<span> like) elements.
@@ -97,7 +97,7 @@ CKEDITOR.dtd = (function()
 		 * @type Object
 		 * @example
 		 */
-		$empty : {area:1,base:1,br:1,col:1,hr:1,img:1,input:1,link:1,meta:1,param:1},
+		$empty : {area:1,base:1,br:1,col:1,hr:1,img:1,input:1,link:1,meta:1,param:1,wbr:1},
 
 		/**
 		 * List of list item elements, like "li" or "dd".
@@ -107,11 +107,11 @@ CKEDITOR.dtd = (function()
 		$listItem : {dd:1,dt:1,li:1},
 
 		/**
-	     * List of list root elements.
-	     * @type Object
-	     * @example
-	     */
-	    $list: { ul:1,ol:1,dl:1},
+		 * List of list root elements.
+		 * @type Object
+		 * @example
+		 */
+		$list: {ul:1,ol:1,dl:1},
 
 		/**
 		 * Elements that accept text nodes, but are not possible to edit into
@@ -119,14 +119,19 @@ CKEDITOR.dtd = (function()
 		 * @type Object
 		 * @example
 		 */
-		$nonEditable : {applet:1,button:1,embed:1,iframe:1,map:1,object:1,option:1,script:1,textarea:1,param:1},
+		$nonEditable : {applet:1,button:1,embed:1,iframe:1,map:1,object:1,option:1,script:1,textarea:1,param:1,audio:1,video:1},
+
+		/**
+		 *  List of block tags with each one a singleton element lives in the corresponding structure for description.
+		 */
+		$captionBlock : { caption:1, legend:1 },
 
 		/**
 		 * List of elements that can be ignored if empty, like "b" or "span".
 		 * @type Object
 		 * @example
 		 */
-		$removeEmpty : {abbr:1,acronym:1,address:1,b:1,bdo:1,big:1,cite:1,code:1,del:1,dfn:1,em:1,font:1,i:1,ins:1,label:1,kbd:1,q:1,s:1,samp:1,small:1,span:1,strike:1,strong:1,sub:1,sup:1,tt:1,u:1,'var':1},
+		$removeEmpty : {abbr:1,acronym:1,address:1,b:1,bdo:1,big:1,cite:1,code:1,del:1,dfn:1,em:1,font:1,i:1,ins:1,label:1,kbd:1,q:1,s:1,samp:1,small:1,span:1,strike:1,strong:1,sub:1,sup:1,tt:1,u:1,'var':1,mark:1},
 
 		/**
 		 * List of elements that have tabindex set to zero by default.
@@ -158,6 +163,7 @@ CKEDITOR.dtd = (function()
         noscript : P,
         td : P,
         br : {},
+        wbr : {},
         th : P,
         center : P,
         kbd : L,
@@ -230,7 +236,30 @@ CKEDITOR.dtd = (function()
         pre : X(G,C),
         p : L,
         em : L,
-        dfn : L
+        dfn : L,
+		//HTML5
+		section : P,
+		header : P,
+		footer : P,
+		nav : P,
+		article : P,
+		aside : P,
+		figure: P,
+		dialog : P,
+		hgroup : P,
+		mark : L,
+		time : L,
+		meter : L,
+		menu : L,
+		command : L,
+		keygen : L,
+		output : L,
+		progress : O,
+		audio : O,
+		video : O,
+		details : O,
+		datagrid : O,
+		datalist : O
     };
 })();
 

data/public/javascripts/extensions/ck_editor_filter/ckeditor/_source/core/editor.js

@@ -1,5 +1,5 @@
 /*
-Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.
+Copyright (c) 2003-2012, CKSource - Frederico Knabben. All rights reserved.
 For licensing, see LICENSE.html or http://ckeditor.com/license
 */
 
@@ -120,11 +120,11 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 
 		/**
 		 * The name of the skin used by this editor instance. The skin name can
-		 * be set though the {@link CKEDITOR.config.skin} setting.
+		 * be set through the <code>{@link CKEDITOR.config.skin}</code> setting.
 		 * @name CKEDITOR.editor.prototype.skinName
 		 * @type String
 		 * @example
-		 * alert( editor.skinName );  // "kama" (e.g.)
+		 * alert( editor.skinName );  // E.g. "kama"
 		 */
 		editor.skinName = skinName;
 
@@ -133,7 +133,7 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 		 * @name CKEDITOR.editor.prototype.skinPath
 		 * @type String
 		 * @example
-		 * alert( editor.skinPath );  // "http://example.com/ckeditor/skins/kama/" (e.g.)
+		 * alert( editor.skinPath );  // E.g. "http://example.com/ckeditor/skins/kama/"
 		 */
 		editor.skinPath = skinPath;
 
@@ -142,21 +142,21 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 		 * @name CKEDITOR.editor.prototype.skinClass
 		 * @type String
 		 * @example
-		 * alert( editor.skinClass );  // "cke_skin_kama" (e.g.)
+		 * alert( editor.skinClass );  // E.g. "cke_skin_kama"
 		 */
 		editor.skinClass = 'cke_skin_' + skinName;
 
 		/**
 		 * The <a href="http://en.wikipedia.org/wiki/Tabbing_navigation">tabbing
 		 * navigation</a> order that has been calculated for this editor
-		 * instance. This can be set by the {@link CKEDITOR.config.tabIndex}
-		 * setting or taken from the "tabindex" attribute of the
-		 * {@link #element} associated to the editor.
+		 * instance. This can be set by the <code>{@link CKEDITOR.config.tabIndex}</code>
+		 * setting or taken from the <code>tabindex</code> attribute of the
+		 * <code>{@link #element}</code> associated with the editor.
 		 * @name CKEDITOR.editor.prototype.tabIndex
 		 * @type Number
 		 * @default 0 (zero)
 		 * @example
-		 * alert( editor.tabIndex );  // "0" (e.g.)
+		 * alert( editor.tabIndex );  // E.g. "0"
 		 */
 		editor.tabIndex = editor.config.tabIndex || editor.element.getAttribute( 'tabindex' ) || 0;
 
@@ -182,21 +182,21 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 			{
 				/**
 				 * The code for the language resources that have been loaded
-				 * for the user internface elements of this editor instance.
+				 * for the user interface elements of this editor instance.
 				 * @name CKEDITOR.editor.prototype.langCode
 				 * @type String
 				 * @example
-				 * alert( editor.langCode );  // "en" (e.g.)
+				 * alert( editor.langCode );  // E.g. "en"
 				 */
 				editor.langCode = languageCode;
 
 				/**
-				 * An object holding all language strings used by the editor
+				 * An object that contains all language strings used by the editor
 				 * interface.
 				 * @name CKEDITOR.editor.prototype.lang
 				 * @type CKEDITOR.lang
 				 * @example
-				 * alert( editor.lang.bold );  // "Negrito" (e.g. if language is Portuguese)
+				 * alert( editor.lang.bold );  // E.g. "Negrito" (if the language is set to Portuguese)
 				 */
 				// As we'll be adding plugin specific entries that could come
 				// from different language code files, we need a copy of lang,
@@ -207,6 +207,8 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 				if ( CKEDITOR.env.gecko && CKEDITOR.env.version < 10900 && editor.lang.dir == 'rtl' )
 					editor.lang.dir = 'ltr';
 
+				editor.fire( 'langLoaded' );
+
 				var config = editor.config;
 				config.contentsLangDirection == 'ui' && ( config.contentsLangDirection = editor.lang.dir );
 
@@ -253,12 +255,12 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 				var languageFiles = [];
 
 				/**
-				 * And object holding references to all plugins used by this
-				 * editor istance.
+				 * An object that contains references to all plugins used by this
+				 * editor instance.
 				 * @name CKEDITOR.editor.prototype.plugins
 				 * @type Object
 				 * @example
-				 * alert( editor.plugins.dialog.path );  // "http://example.com/ckeditor/plugins/dialog/" (e.g.)
+				 * alert( editor.plugins.dialog.path );  // E.g. "http://example.com/ckeditor/plugins/dialog/"
 				 */
 				editor.plugins = plugins;
 
@@ -347,7 +349,7 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 				 * @name CKEDITOR.editor.prototype.theme
 				 * @type CKEDITOR.theme
 				 * @example
-				 * alert( editor.theme );  "http://example.com/ckeditor/themes/default/" (e.g.)
+				 * alert( editor.theme );  // E.g. "http://example.com/ckeditor/themes/default/"
 				 */
 				var editorTheme = editor.theme = CKEDITOR.themes.get( theme );
 				editorTheme.path = CKEDITOR.themes.getPath( theme );
@@ -422,7 +424,7 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 
 	/**
 	 * Initializes the editor instance. This function is called by the editor
-	 * contructor (editor_basic.js).
+	 * contructor (<code>editor_basic.js</code>).
 	 * @private
 	 */
 	CKEDITOR.editor.prototype._init = function()
@@ -438,24 +440,25 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 			this._.styles = [];
 
 			/**
-			 * The DOM element that has been replaced by this editor instance. This
-			 * element holds the editor data on load and post.
+			 * The DOM element that was replaced by this editor instance. This
+			 * element stores the editor data on load and post.
 			 * @name CKEDITOR.editor.prototype.element
 			 * @type CKEDITOR.dom.element
 			 * @example
 			 * var editor = CKEDITOR.instances.editor1;
-			 * alert( <b>editor.element</b>.getName() );  "textarea"
+			 * alert( <strong>editor.element</strong>.getName() );  // E.g. "textarea"
 			 */
 			this.element = element;
 
 			/**
-			 * The editor instance name. It hay be the replaced element id, name or
-			 * a default name using a progressive counter (editor1, editor2, ...).
+			 * The editor instance name. It may be the replaced element ID, name, or
+			 * a default name using the progressive counter (<code>editor1</code>,
+			 * <code>editor2</code>, ...).
 			 * @name CKEDITOR.editor.prototype.name
 			 * @type String
 			 * @example
 			 * var editor = CKEDITOR.instances.editor1;
-			 * alert( <b>editor.name</b> );  "editor1"
+			 * alert( <strong>editor.name</strong> );  // "editor1"
 			 */
 			this.name = ( element && ( this.elementMode == CKEDITOR.ELEMENT_MODE_REPLACE )
 							&& ( element.getId() || element.getNameAtt() ) )
@@ -465,7 +468,7 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 				throw '[CKEDITOR.editor] The instance "' + this.name + '" already exists.';
 
 			/**
-			 * A unique random string assigned to each editor instance in the page.
+			 * A unique random string assigned to each editor instance on the page.
 			 * @name CKEDITOR.editor.prototype.id
 			 * @type String
 			 */
@@ -473,19 +476,19 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 
 			/**
 			 * The configurations for this editor instance. It inherits all
-			 * settings defined in (@link CKEDITOR.config}, combined with settings
+			 * settings defined in <code>(@link CKEDITOR.config}</code>, combined with settings
 			 * loaded from custom configuration files and those defined inline in
 			 * the page when creating the editor.
 			 * @name CKEDITOR.editor.prototype.config
 			 * @type Object
 			 * @example
 			 * var editor = CKEDITOR.instances.editor1;
-			 * alert( <b>editor.config.theme</b> );  "default" e.g.
+			 * alert( <strong>editor.config.theme</strong> );  // E.g. "default"
 			 */
 			this.config = CKEDITOR.tools.prototypedCopy( CKEDITOR.config );
 
 			/**
-			 * Namespace containing UI features related to this editor instance.
+			 * The namespace containing UI features related to this editor instance.
 			 * @name CKEDITOR.editor.prototype.ui
 			 * @type CKEDITOR.ui
 			 * @example
@@ -495,7 +498,7 @@ For licensing, see LICENSE.html or http://ckeditor.com/license
 			/**
 			 * Controls the focus state of this editor instance. This property
 			 * is rarely used for normal API operations. It is mainly
-			 * destinated to developer adding UI elements to the editor interface.
+			 * intended for developers adding UI elements to the editor interface.
 			 * @name CKEDITOR.editor.prototype.focusManager
 			 * @type CKEDITOR.focusManager
 			 * @example
@@ -516,7 +519,7 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 	{
 		/**
 		 * Adds a command definition to the editor instance. Commands added with
-		 * this function can be later executed with {@link #execCommand}.
+		 * this function can be executed later with the <code>{@link #execCommand}</code> method.
 		 * @param {String} commandName The indentifier name of the command.
 		 * @param {CKEDITOR.commandDefinition} commandDefinition The command definition.
 		 * @example
@@ -534,8 +537,9 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Add a trunk of css text to the editor which will be applied to the wysiwyg editing document.
-		 * Note: This function should be called before editor is loaded to take effect.
+		 * Adds a piece of CSS code to the editor which will be applied to the WYSIWYG editing document.
+		 * This CSS would not be added to the output, and is there mainly for editor-specific editing requirements.
+		 * Note: This function should be called before the editor is loaded to take effect.
 		 * @param css {String} CSS text.
 		 * @example
 		 * editorInstance.addCss( 'body { background-color: grey; }' );
@@ -552,9 +556,9 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		 *		element, this parameter indicates whether or not to update the
 		 *		element with the instance contents.
 		 * @example
-		 * alert( CKEDITOR.instances.editor1 );  e.g "object"
-		 * <b>CKEDITOR.instances.editor1.destroy()</b>;
-		 * alert( CKEDITOR.instances.editor1 );  "undefined"
+		 * alert( CKEDITOR.instances.editor1 );  //  E.g "object"
+		 * <strong>CKEDITOR.instances.editor1.destroy()</strong>;
+		 * alert( CKEDITOR.instances.editor1 );  // "undefined"
 		 */
 		destroy : function( noUpdate )
 		{
@@ -569,11 +573,12 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Executes a command.
+		 * Executes a command associated with the editor.
 		 * @param {String} commandName The indentifier name of the command.
-		 * @param {Object} [data] Data to be passed to the command
-		 * @returns {Boolean} "true" if the command has been successfuly
-		 *		executed, otherwise "false".
+		 * @param {Object} [data] Data to be passed to the command.
+		 * @returns {Boolean} <code>true</code> if the command was executed
+		 *		successfully, otherwise <code>false</code>.
+		 * @see CKEDITOR.editor.addCommand
 		 * @example
 		 * editorInstance.execCommand( 'bold' );
 		 */
@@ -605,12 +610,14 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Gets one of the registered commands. Note that, after registering a
-		 * command definition with addCommand, it is transformed internally
-		 * into an instance of {@link CKEDITOR.command}, which will be then
-		 * returned by this function.
+		 * Gets one of the registered commands. Note that after registering a
+		 * command definition with <code>{@link #addCommand}</code>, it is
+		 * transformed internally into an instance of
+		 * <code>{@link CKEDITOR.command}</code>, which will then be returned
+		 * by this function.
 		 * @param {String} commandName The name of the command to be returned.
-		 * This is the same used to register the command with addCommand.
+		 * This is the same name that is used to register the command with
+		 * 		<code>addCommand</code>.
 		 * @returns {CKEDITOR.command} The command object identified by the
 		 * provided name.
 		 */
@@ -625,7 +632,7 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		 * @type String
 		 * @returns (String) The editor data.
 		 * @example
-		 * if ( CKEDITOR.instances.editor1.<b>getData()</b> == '' )
+		 * if ( CKEDITOR.instances.editor1.<strong>getData()</strong> == '' )
 		 *     alert( 'There is no data available' );
 		 */
 		getData : function()
@@ -653,11 +660,13 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 
 		/**
 		 * Gets the "raw data" currently available in the editor. This is a
-		 * fast method which return the data as is, without processing, so it's
-		 * not recommended to use it on resulting pages. It can be used instead
-		 * combined with the {@link #loadSnapshot} so one can automatic save
-		 * the editor data from time to time while the user is using the
-		 * editor, to avoid data loss, without risking performance issues.
+		 * fast method which returns the data as is, without processing, so it is
+		 * not recommended to use it on resulting pages. Instead it can be used
+		 * combined with the <code>{@link #loadSnapshot}</code> method in order
+		 * to be able to automatically save the editor data from time to time
+		 * while the user is using the editor, to avoid data loss, without risking
+		 * performance issues.
+		 * @see CKEDITOR.editor.getData
 		 * @example
 		 * alert( editor.getSnapshot() );
 		 */
@@ -676,13 +685,14 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Loads "raw data" in the editor. This data is loaded with processing
+		 * Loads "raw data" into the editor. The data is loaded with processing
 		 * straight to the editing area. It should not be used as a way to load
 		 * any kind of data, but instead in combination with
-		 * {@link #getSnapshot} produced data.
+		 * <code>{@link #getSnapshot}</code> produced data.
+		 * @see CKEDITOR.editor.setData
 		 * @example
 		 * var data = editor.getSnapshot();
-		 * editor.<b>loadSnapshot( data )</b>;
+		 * editor.<strong>loadSnapshot( data )</strong>;
 		 */
 		loadSnapshot : function( snapshot )
 		{
@@ -690,21 +700,22 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Sets the editor data. The data must be provided in raw format (HTML).<br />
+		 * Sets the editor data. The data must be provided in the raw format (HTML).<br />
 		 * <br />
-		 * Note that this menthod is asynchronous. The "callback" parameter must
+		 * Note that this method is asynchronous. The <code>callback</code> 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
+		 * @param {Function} callback Function to be called after the <code>setData</code>
 		 *		is completed.
-		 *@param {Boolean} internal Whether suppress  any event firing when copying data internally inside editor.
+		 *@param {Boolean} internal Whether to suppress any event firing when copying data
+		 *		internally inside the editor.
 		 * @example
-		 * CKEDITOR.instances.editor1.<b>setData</b>( '&lt;p&gt;This is the editor data.&lt;/p&gt;' );
+		 * CKEDITOR.instances.editor1.<strong>setData</strong>( '&lt;p&gt;This is the editor data.&lt;/p&gt;' );
 		 * @example
-		 * CKEDITOR.instances.editor1.<b>setData</b>( '&lt;p&gt;Some other editor data.&lt;/p&gt;', function()
+		 * CKEDITOR.instances.editor1.<strong>setData</strong>( '&lt;p&gt;Some other editor data.&lt;/p&gt;', function()
 		 *     {
-		 *         this.checkDirty();    // true
+		 *         this.checkDirty();  // true
 		 *     });
 		 */
 		setData : function( data , callback, internal )
@@ -729,19 +740,22 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 
 		/**
 		 * Puts or restores the editor into read-only state. When in read-only,
-		 * the user is not able to change the editor contents, but still use
-		 * some editor features. This function sets the readOnly property of
-		 * the editor, firing the "readOnly" event.<br><br>
+		 * the user is not able to change the editor contents, but can still use
+		 * some editor features. This function sets the <code>{@link CKEDITOR.config.readOnly}</code>
+		 * property of the editor, firing the <code>{@link CKEDITOR.editor#readOnly}</code> event.<br><br>
 		 * <strong>Note:</strong> the current editing area will be reloaded.
-		 * @param {Boolean} [makeEditable] Indicates that the editor must be
-		 *		restored from read-only mode, making it editable.
+		 * @param {Boolean} [isReadOnly] Indicates that the editor must go
+		 *		read-only (<code>true</code>, default) or be restored and made editable
+		 * 		(<code>false</code>).
 		 * @since 3.6
 		 */
-		setReadOnly : function( makeEditable )
+		setReadOnly : function( isReadOnly )
 		{
-			if ( this.readOnly != !makeEditable )
+			isReadOnly = ( isReadOnly == undefined ) || isReadOnly;
+
+			if ( this.readOnly != isReadOnly )
 			{
-				this.readOnly = !makeEditable;
+				this.readOnly = isReadOnly;
 
 				// Fire the readOnly event so the editor features can update
 				// their state accordingly.
@@ -750,10 +764,10 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Inserts HTML into the currently selected position in the editor.
+		 * Inserts HTML code into the currently selected position in the editor in WYSIWYG mode.
 		 * @param {String} data HTML code to be inserted into the editor.
 		 * @example
-		 * CKEDITOR.instances.editor1.<b>insertHtml( '&lt;p&gt;This is a new paragraph.&lt;/p&gt;' )</b>;
+		 * CKEDITOR.instances.editor1.<strong>insertHtml( '&lt;p&gt;This is a new paragraph.&lt;/p&gt;' )</strong>;
 		 */
 		insertHtml : function( data )
 		{
@@ -762,14 +776,14 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 
 		/**
 		 * Insert text content into the currently selected position in the
-		 * editor, in WYSIWYG mode, styles of the selected element will be applied to the inserted text,
-		 * spaces around the text will be leaving untouched.
-		 * <strong>Note:</strong> two subsequent line-breaks will introduce one paragraph, which element depends on {@link CKEDITOR.config.enterMode};
+		 * editor in WYSIWYG mode. The styles of the selected element will be applied to the inserted text.
+		 * Spaces around the text will be leaving untouched.
+		 * <strong>Note:</strong> two subsequent line-breaks will introduce one paragraph. This depends on <code>{@link CKEDITOR.config.enterMode}</code>;
 		 * A single line-break will be instead translated into one &lt;br /&gt;.
 		 * @since 3.5
 		 * @param {String} text Text to be inserted into the editor.
 		 * @example
-		 * CKEDITOR.instances.editor1.<b>insertText( ' line1 \n\n line2' )</b>;
+		 * CKEDITOR.instances.editor1.<strong>insertText( ' line1 \n\n line2' )</strong>;
 		 */
 		insertText : function( text )
 		{
@@ -778,12 +792,12 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 
 		/**
 		 * Inserts an element into the currently selected position in the
-		 * editor.
+		 * editor in WYSIWYG mode.
 		 * @param {CKEDITOR.dom.element} element The element to be inserted
 		 *		into the editor.
 		 * @example
 		 * var element = CKEDITOR.dom.element.createFromHtml( '&lt;img src="hello.png" border="0" title="Hello" /&gt;' );
-		 * CKEDITOR.instances.editor1.<b>insertElement( element )</b>;
+		 * CKEDITOR.instances.editor1.<strong>insertElement( element )</strong>;
 		 */
 		insertElement : function( element )
 		{
@@ -791,16 +805,16 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Checks whether the current editor contents present changes when
+		 * Checks whether the current editor contents contain changes when
 		 * compared to the contents loaded into the editor at startup, or to
-		 * the contents available in the editor when {@link #resetDirty} has
-		 * been called.
-		 * @returns {Boolean} "true" is the contents present changes.
+		 * the contents available in the editor when <code>{@link #resetDirty}</code>
+		 * was called.
+		 * @returns {Boolean} "true" is the contents contain changes.
 		 * @example
 		 * function beforeUnload( e )
 		 * {
-		 *     if ( CKEDITOR.instances.editor1.<b>checkDirty()</b> )
-		 * 	        return e.returnValue = "You'll loose the changes made in the editor.";
+		 *     if ( CKEDITOR.instances.editor1.<strong>checkDirty()</strong> )
+		 * 	        return e.returnValue = "You will lose the changes made in the editor.";
 		 * }
 		 *
 		 * if ( window.addEventListener )
@@ -815,11 +829,11 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 
 		/**
 		 * Resets the "dirty state" of the editor so subsequent calls to
-		 * {@link #checkDirty} will return "false" if the user will not make
-		 * further changes to the contents.
+		 * <code>{@link #checkDirty}</code> will return <code>false</code> if the user will not
+		 * have made further changes to the contents.
 		 * @example
-		 * alert( editor.checkDirty() );  // "true" (e.g.)
-		 * editor.<b>resetDirty()</b>;
+		 * alert( editor.checkDirty() );  // E.g. "true"
+		 * editor.<strong>resetDirty()</strong>;
 		 * alert( editor.checkDirty() );  // "false"
 		 */
 		resetDirty : function()
@@ -829,8 +843,9 @@ CKEDITOR.tools.extend( CKEDITOR.editor.prototype,
 		},
 
 		/**
-		 * Updates the &lt;textarea&gt; element that has been replaced by the editor with
+		 * Updates the <code>&lt;textarea&gt;</code> element that was replaced by the editor with
 		 * the current data available in the editor.
+		 * @see CKEDITOR.editor.element
 		 * @example
 		 * CKEDITOR.instances.editor1.updateElement();
 		 * alert( document.getElementById( 'editor1' ).value );  // The current editor data.
@@ -867,7 +882,7 @@ CKEDITOR.on( 'loaded', function()
 	});
 
 /**
- * Whether escape HTML when editor update original input element.
+ * Whether to escape HTML when the editor updates the original input element.
  * @name CKEDITOR.config.htmlEncodeOutput
  * @since 3.1
  * @type Boolean
@@ -877,8 +892,8 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * If "true", makes the editor start in read-only state. Otherwise, it'll check
- * if the linked &lt;textarea&gt; has the "disabled" attribute.
+ * If <code>true</code>, makes the editor start in read-only state. Otherwise, it will check
+ * if the linked <code>&lt;textarea&gt;</code> element has the <code>disabled</code> attribute.
  * @name CKEDITOR.config.readOnly
  * @see CKEDITOR.editor#setReadOnly
  * @type Boolean
@@ -891,7 +906,7 @@ CKEDITOR.on( 'loaded', function()
 /**
  * Fired when a CKEDITOR instance is created, but still before initializing it.
  * To interact with a fully initialized instance, use the
- * {@link CKEDITOR#instanceReady} event instead.
+ * <code>{@link CKEDITOR#instanceReady}</code> event instead.
  * @name CKEDITOR#instanceCreated
  * @event
  * @param {CKEDITOR.editor} editor The editor instance that has been created.
@@ -904,6 +919,14 @@ CKEDITOR.on( 'loaded', function()
  * @param {CKEDITOR.editor} editor The editor instance that has been destroyed.
  */
 
+/**
+ * Fired when the language is loaded into the editor instance.
+ * @name CKEDITOR.editor#langLoaded
+ * @event
+ * @since 3.6.1
+ * @param {CKEDITOR.editor} editor This editor instance.
+ */
+
 /**
  * Fired when all plugins are loaded and initialized into the editor instance.
  * @name CKEDITOR.editor#pluginsLoaded
@@ -912,7 +935,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Fired before the command execution when {@link #execCommand} is called.
+ * Fired before the command execution when <code>{@link #execCommand}</code> is called.
  * @name CKEDITOR.editor#beforeCommandExec
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -923,7 +946,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Fired after the command execution when {@link #execCommand} is called.
+ * Fired after the command execution when <code>{@link #execCommand}</code> is called.
  * @name CKEDITOR.editor#afterCommandExec
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -934,16 +957,15 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Fired every custom configuration file is loaded, before the final
+ * Fired when the custom configuration file is loaded, before the final
  * configurations initialization.<br />
  * <br />
  * Custom configuration files can be loaded thorugh the
- * {@link CKEDITOR.config.customConfig} setting. Several files can be loading
- * by chaning this setting.
+ * <code>{@link CKEDITOR.config.customConfig}</code> setting. Several files can be loaded
+ * by changing this setting.
  * @name CKEDITOR.editor#customConfigLoaded
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
- * @example
  */
 
 /**
@@ -951,14 +973,11 @@ CKEDITOR.on( 'loaded', function()
  * @name CKEDITOR.editor#configLoaded
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
- * @example
- * if( editor.config.fullPage )
- *     alert( 'This is a full page editor' );
  */
 
 /**
  * Fired when this editor instance is destroyed. The editor at this
- * point isn't usable and this event should be used to perform clean up
+ * point is not usable and this event should be used to perform the clean-up
  * in any plugin.
  * @name CKEDITOR.editor#destroy
  * @event
@@ -971,20 +990,19 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Internal event to perform the #getSnapshot call.
+ * Internal event to perform the <code>#getSnapshot</code> call.
  * @name CKEDITOR.editor#getSnapshot
  * @event
  */
 
 /**
- * Internal event to perform the #loadSnapshot call.
+ * Internal event to perform the <code>#loadSnapshot</code> call.
  * @name CKEDITOR.editor#loadSnapshot
  * @event
  */
 
-
 /**
- * Event fired before the #getData call returns allowing additional manipulation.
+ * Event fired before the <code>#getData</code> call returns allowing additional manipulation.
  * @name CKEDITOR.editor#getData
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -992,7 +1010,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Event fired before the #setData call is executed allowing additional manipulation.
+ * Event fired before the <code>#setData</code> call is executed allowing additional manipulation.
  * @name CKEDITOR.editor#setData
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -1000,8 +1018,8 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Event fired at the end of the #setData call is executed. Usually it's better to use the
- * {@link CKEDITOR.editor.prototype.dataReady} event.
+ * Event fired at the end of the <code>#setData</code> call execution. Usually it is better to use the
+ * <code>{@link CKEDITOR.editor.prototype.dataReady}</code> event.
  * @name CKEDITOR.editor#afterSetData
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -1009,7 +1027,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Internal event to perform the #insertHtml call
+ * Internal event to perform the <code>#insertHtml</code> call
  * @name CKEDITOR.editor#insertHtml
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -1017,7 +1035,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Internal event to perform the #insertText call
+ * Internal event to perform the <code>#insertText</code> call
  * @name CKEDITOR.editor#insertText
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -1025,7 +1043,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Internal event to perform the #insertElement call
+ * Internal event to perform the <code>#insertElement</code> call
  * @name CKEDITOR.editor#insertElement
  * @event
  * @param {CKEDITOR.editor} editor This editor instance.
@@ -1033,7 +1051,7 @@ CKEDITOR.on( 'loaded', function()
  */
 
 /**
- * Event fired after {@link CKEDITOR.editor#readOnly} property changes.
+ * Event fired after the <code>{@link CKEDITOR.editor#readOnly}</code> property changes.
  * @name CKEDITOR.editor#readOnly
  * @event
  * @since 3.6